Installation¶
Warning
Roman requires Python 3.10 or above and a C compiler for dependencies.
Warning
Linux and MacOS platforms are tested and supported. Windows is not currently supported.
Stable releases of the romancal
package are registered at
PyPI. The development version of romancal
is
installable from the
Github repository.
The basic method of installing the roman calibration pipeline is to setup your environment and issue the command,
$ pip install romancal
Detailed Installation¶
The romancal
package can be installed into a virtualenv or conda environment via pip
. We recommend that for each
installation you start by creating a fresh environment that only has Python installed and then install the romancal
package and its dependencies into that bare environment. If using conda environments, first make sure you have a recent
version of Anaconda or Miniconda installed. If desired, you can create multiple environments to allow for switching
between different versions of the romancal
package (e.g. a released version versus the current development version).
In all cases, the recommended installation is generally a 3-step process:
create a virtual environment;
activate that environment;
install the desired version of the
romancal
package into that environment.
Details are given below on how to do this for different types of installations, including tagged releases, DMS builds
used in operations, and development versions. Note that, although you can use any python environment management system that you are familiar with,
below we will be using conda
(remember that all conda operations must be done from within a bash shell).
Installing latest releases¶
You can install the latest released version via pip
. From a bash shell:
$ conda create -n <env_name> python
$ conda activate <env_name>
$ pip install romancal
You can also install a specific version (from romancal 0.1.0
onward):
$ conda create -n <env_name> python
$ conda activate <env_name>
$ pip install romancal==0.5.0
Installing the development version from Github¶
You can install the latest development version (not as well tested) from the Github main branch:
$ conda create -n <env_name> python
$ conda activate <env_name>
$ pip install git+https://github.com/spacetelescope/romancal
Installing for Developers¶
If you want to be able to work on and test the source code with the romancal
package, the high-level procedure to do
this is to first create a conda environment using the same procedures outlined above, but then install your personal
copy of the code overtop of the original code in that environment. Again, this should be done in a separate conda
environment from any existing environments that you may have already installed with released versions of the romancal
package.
As usual, the first two steps are to create and activate an environment:
$ conda create -n <env_name> python
$ conda activate <env_name>
To install your own copy of the code into that environment, you first need to fork and clone the romancal
repo:
$ cd <where you want to put the repo>
$ git clone https://github.com/spacetelescope/romancal
$ cd romancal
Note
python setup.py install
and python setup.py develop
commands do not work.
Install from your local checked-out copy as an “editable” install:
$ pip install -e .
If you want to run the unit or regression tests and/or build the docs, you can make sure those dependencies are installed as well:
$ pip install -e '.[test]'
$ pip install -e '.[docs]'
$ pip install -e '.[test,docs]'
Need other useful packages in your development environment?
$ pip install ipython pytest-xdist
Calibration References Data System (CRDS) Setup¶
CRDS is the system that manages the reference files needed to run the pipeline. Inside the STScI network, the pipeline works with default CRDS setup with no modifications. To run the pipeline outside the STScI network, CRDS must be configured by setting two environment variables:
$ export CRDS_PATH=$HOME/crds_cache
$ export CRDS_SERVER_URL=https://roman-crds.stsci.edu