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()