Installing Documenteer for pipelines.lsst.io

The “pipelines” version of Documenteer provides additional dependencies needed to build the pipelines.lsst.io documentation site for the LSST Science Pipelines.

Documenteer is already included in the Conda environment created by a typical LSST Science Pipelines installation, and no additional installation is needed. This page provides additional installation instructions for atypical cases.

For both pip and conda, the installation needs to be done within the same Python/Conda environment that the Science Pipelines already installed in. You can do that by running the Science Pipelines stack’s setup command _before_ installing Documenteer.

Pip installation of Documenteer

Install Documenteer with the pipelines extra:

pip install documenteer[pipelines]

Besides documenteer, you will also need to install graphviz to render API inheritance diagrams.

Conda installation

First, enable the conda-forge channel:

conda config --add channels conda-forge
conda config --set channel_priority strict

Then install the lsst-documenteer-pipelines metapackage.

conda install lsst-documenteer-pipelines