For Pandeia Engine

...

v3.

...

0/v3.1/v3.2

Python Requirements

...

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

Code

:

Installing the Pandeia Engine requires a python environment with the dependencies listed above, a set of telescope-specific datafiles, and an optional (but highly recommended) second set of data files for additional spectral manipulation capabilities.

Code

The engine can be installed with

pip install pandeia.engine==3.2

or for Roman:

pip install pandeia.engine==3.1

Then set up the data files.

Data

Required Data

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

• James Webb Space Telescope: https://stsci.app.box.com/v/pandeia-refdata-v3p2-

...

• jwst
• Nancy Grace Roman Space Telescope:

...

• https://stsci.box.com/v/pandeia-refdata-v3p1-roman

Download and untar the files to a suitable location.

Environment variable: $pandeia_refdata must point to the location of the top of the data file tree (the

...

directory containing the VERSION_PSF

...

*Both telescope datasets may be untarred to the same location; any files the two packages have in common may be overwritten.

Optional Data

...

file)

Recommended Data

• An additional dataset:  https://archive.stsci.edu/hlsp/reference-atlases can be used to provide more spectroscopic functionality (phoenix spectral models, normalization by HST bandpasses,

...

• among others).

The Once untarred, the files will produce a directory tree of grp/hst/cdbs; the Pandeia Engine expects the environment variable redcat/trds. The pandeia.engine uses the contents of the trds directory.

Environment variable: $PYSYN_CDBS to must point to the cdbs directory.

Installation

We recommend using the Anaconda python distribution.

trds directory (NOT grp)

Verify Installation

Open up Once installed, from a terminal with access to the conda environmentinstallation, and 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 -n pandeia stsci numpy scipy=1.1 astropy=2 photutils pysynphot setuptools python=3.6" from a terminal with access to the conda environment.

Then, install the engine itself: `pip install pandeia.engine==1.5.1`

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

If properly installed and configured, it should show the refdata version and synphot data directory, like this:

Pandeia Engine version:  3.2
Pandeia RefData version:  3.2
Pysynphot Data:  /your/data/directory/synphot

or for Roman:

Pandeia Engine version:  3.1
Pandeia RefData version:  3.1
Pysynphot Data:  /your/data/directory/synphot

Helper Script

The following script (which can also be added to your .bashrc or .bash_profile file) assumes you are operating in a BASH shell where a python installation has been installed and 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/synphot

#!/bin/sh
export PYSYN_CDBS=${HOME}/data/synphot
export pandeia_refdata=${HOME}/data/pandeia

Once in place, "source"ing this file will set up the pandeia environmentIt should also be possible to install the Pandeia Engine 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 installed this way.