Installation#

PynPoint is compatible with Python versions 3.9/3.10/3.11.

Virtual Environment#

PynPoint is available in the PyPI repository and on Github. We recommend using a Python virtual environment to install and run PynPoint such that the correct dependency versions are installed without affecting other Python installations. First install virtualenv, for example with the pip package manager:

$ pip install virtualenv

Then create a virtual environment:

$ virtualenv -p python3 folder_name

And activate the environment with:

$ source folder_name/bin/activate

A virtual environment can be deactivated with:

$ deactivate

Important

Make sure to adjust the path where the virtual environment is installed and activated.

Installation from PyPI#

PynPoint can now be installed with pip:

$ pip install pynpoint

If you do not use a virtual environment then you may have to add the --user argument:

$ pip install --user pynpoint

To update the installation to the most recent version:

$ pip install --upgrade PynPoint

Installation from Github#

Using pip#

The Github repository contains the latest commits. Installation from Github is also possible with pip:

$ pip install git+https://github.com/PynPoint/PynPoint.git

Cloning the repository#

Alternatively, the Github repository can be cloned, which is in particular useful if you want to look into the code:

$ git clone https://github.com/PynPoint/PynPoint.git

The package is installed by running pip in the local repository folder:

$ pip install -e .

Instead of running setup.py, the path of the repository can also be added to the PYTHONPATH environment variable such that PynPoint can be imported from any working folder. When using a virtualenv, the PYTHONPATH can be added to the activation script:

Once a local copy of the repository exists, new commits can be pulled from Github with:

$ git pull origin main

Do you want to makes changes to the code? Please fork the PynPoint repository on the Github page and clone your own fork instead of the main repository. We very much welcome contributions and pull requests (see Contributing section).

Dependencies#

If needed, the dependencies can be manually installed from the PynPoint folder:

$ pip install -r requirements.txt

Or updated to the latest versions with which PynPoint is compatible:

$ pip install --upgrade -r requirements.txt

Testing Pynpoint#

The installation can be tested by starting Python in interactive mode and creating an instance of the Pypeline:

>>> import pynpoint
>>> pipeline = pynpoint.Pypeline()