Installation

From the PyPI repository

If you don’t need the development version of the python-opentree package you can install the version available from the Python Package Index (PyPI) using pip:

pip install opentree

From the GitHub repository

If you want/need the latest version of python-opentree or if you are a developer who wants to install multiple times, you probably want to clone the code from its GitHub repository, and install it locally in a virtual environment.

To do this, first git clone the code from GitHub to your machine:

git clone https://github.com/OpenTreeOfLife/python-opentree.git

Change to its directory with cd:

cd python-opentree

Create a Python 3 virtual environment named env (you only need to ever run this once):

python3 -m venv env

Activate the virtual environment named env (you will want to do this each time you are using the package):

source env/bin/activate

Install the package requirements:

pip install -r requirements.txt

Install the python-opentree package locally:

pip install -e .

You can deactivate the virtual environment by running:

deactivate

To Run the example Jupyter notebooks

If you plan to run the python-opentree example Jupyter notebooks, you will also need to install Jupyter within a Python virtual environment.

First, create a Python virtual environment and activate it, as shown above.

Now, install a Jupyter kernel:

pip install ipykernel
python -m ipykernel install --user --name=opentree

Install Jupyter from PyPI using pip:

pip install jupyter

Finally, open the python-opentree example Jupyter notebooks with:

jupyter notebook docs/notebooks/

You can then install python-opentree within the virtual environment from PyPI or GitHub, following the instructions above.