For Pandeia Engine v1.5.1

Requirements

The Pandeia Engine is a Python module, and requires both code and data files to operate.

Code

Data

Required Data

In order to function, the Pandeia Engine requires one* set of reference data (containing instrument definitions):

...

Nancy Grace Roman Space Telescope: https://stsci.box.com/v/pandeia-refdata-v1p5p1-wfirst

The location of the top of the data file tree (the folder containing PSF_VERSION) must be set as the $pandeia_refdata environment variable.

*Both telescope datasets may be untarred to the same location to produce an engine that can work with either telescope; any files the two packages have in common may be overwritten.

...

We recommend using the Anaconda python distribution. Follow its installation instructions to set up a new environment if you do not already have one.

Once installed, from a terminal with access to the conda environment, type "conda config --add channels http://ssb.stsci.edu/astroconda" to install the Astroconda channel.

Create an AstroConda environment with the STScI package installed. For example, to create an environment named "pandeia" working under python 3.6, type "conda create

conda create -n pandeia stsci numpy scipy=1.1 astropy=2 photutils pysynphot setuptools python=3.6

" from a terminal with access to the conda environment.

...

It should also be possible to install the Pandeia Engine and all its dependencies by simply running `pip install pandeia.engine==1.5.1` but this is not recommended and users are likely to run into more issues we cannot solve if it is installed this way.

Verify Installation

Open up a terminal with access to the conda installation, and type

python -c "import pandeia.engine; pandeia.engine.pandeia_version()"

If properly installed and configured, it should show the refdata version and synphot data directory.

Helper Script

The following script assumes you are operating in a terminal where a conda installation has been activated, that you've installed the pandeia refdata in ${HOME}/data/pandeia, and the cdbs folder from the additional dataset moved and renamed to ${HOME}/data/pysynphot

conda config --add channels http://ssb.stsci.edu/astroconda
conda create -n pandeia stsci numpy scipy=1.1 astropy=2 python=3.6
mkdir -p ~/anaconda/envs/pandeia/etc/conda/activate.d
cat >>~/anaconda/envs/pandeia/etc/conda/activate.d/env_vars.sh <<EOF
#!/bin/sh
export PYSYN_CDBS=${HOME}/data/pysynphot
export pandeia_refdata=${HOME}/data/pandeia
EOF
mkdir -p ~/anaconda/envs/pandeia/etc/conda/deactivate.d
cat >>~/anaconda/envs/pandeia/etc/conda/deactivate.d/env_vars.sh <<EOF
#!/bin/sh
unset PYSYN_CDBS
unset pandeia_refdata
EOF
conda activate pandeia
pip install pandeia.engine==1.5.1

This creates a pandeia environment in an already-existing conda installation, and sets up two scripts to automatically set and unset the required environment variables every time you activate and deactivate the pandeia environment.