For Pandeia Engine v1.5.2
Python Requirements:
Required | Recommended |
---|---|
python 3.6+ | 3.7.7 |
numpy 1.17+ | 1.18.1 |
scipy | 1.4.1 |
astropy 4+ | 4.0 |
photutils | 0.7.2 |
synphot 0.3+ | 0.3.0 |
stsynphot 0.3+ | 0.3.0 |
six | 1.14.0 |
setuptools | 47.3.1 |
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==1.5.2
We recommend installing into a fresh python environment, such as ones provided by the Anaconda Python distribution, to avoid problems.
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-v1p5p2
- Nancy Grace Roman Space Telescope: https://stsci.box.com/v/pandeia-refdata-v1p5p2-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 file)
*Both telescope datasets may be untarred to the same location to produce an engine that can work with either observatory; any files the two packages have in common may be overwritten.
Recommended Data
- An additional dataset: http://archive.stsci.edu/pub/hst/pysynphot/ can be used to provide more spectroscopic functionality (phoenix spectral models, normalization by HST bandpasses, among others).
Once untarred, the files will produce a directory tree of grp/hst/cdbs. The pandeia.engine uses the contents of the cdbs directory.
Environment variable: $PYSYN_CDBS
must point to the cdbs directory (NOT grp)
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, like this:
Pandeia Engine version: 1.5.2 Pandeia RefData version: 1.5.2 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 environment.