Installation

Requirements

Any of the following Python versions are compatible. If you don’t have any installed, please download and execute a version by clicking the links below.

• Python 3.11 (recommended) [Download Python 3.11.4]

• Python 3.10 [Download Python 3.10.11]

• Python 3.9 (min. 3.9.2) [Download Python 3.9.13]

Installation via Pip

Create a virtual environment

A virtual environment has its own Python binary (which matches the version of the binary that was used to create this environment) and can have its own independent set of installed Python packages in its site directories.

The easiest way to create a virtual environment, is to let the IDE PyCharm (recommended) create one for you. Configure a virtual environment shows how to do that.

The other option is to create it via command line like follows and then configure PyCharm to use this as project interpreter.

See also

venv — Creation of virtual environments

1. Open a shell (e.g. an Inicio shell or PowerShell)

2. Change into your workspace: cd C:\temp

3. Create a virtual environment: C:\Python311\python.exe -m venv pharaoh_venv

4. Activate it:

   • Powershell .\pharaoh_venv\Scripts\Activate.ps1

   • Bash: source ./pharaoh_venv/Scripts/activate

   • Cmd/Bat: .\pharaoh_venv\Scripts\activate.bat

5. You should be getting a prefix to your command line like this: (pharaoh_venv) PS C:\temp>

6. Ensure you use binary packages where possible by installing wheel first pip install wheel

You can find more information about virtual environments here.

Install

After the virtual environment has been created, activate it and install it via pip:

pip install pharaoh-report[<extras>]

Note

Refer to section Extras to install additional dependencies.

Note

For updating Pharaoh to the latest version, append the -U flag to the pip command

Then you would be able to run:

pip install pharaoh-report[<extras>]

Extras

The extras field is a comma-separated list of additional dependency groups.

Following extra dependencies may be installed, depending on your use case:

• bokeh: Installs the Bokeh plotting framework and exporters

• holoview: Installs the Holoviews plotting framework

• plotly: Installs the Plotly plotting framework and exporters

• matplotlib: Installs the Matplotlib plotting framework

• jupyter: Installs Jupyter for asset script implementation

• pandas: Installs Pandas Data Analysis Library

• pdf: Installs an SVG to PDF converter for the LaTeX builder

• all-plotting: Installs all supported plotting frameworks