- JWST Cycle 1 Proposal Opportunities
- JWST Cycle 1 Guaranteed Time Observations Call for Proposals
- • JWST Director's Discretionary Early Release Science Call for Proposals
- • JWST Call for Proposals for Cycle 1
- James Webb Space Telescope Call for Proposals for Cycle 1
- •JWST Cycle 1 Proposal Checklist and Resources
- •JWST Cycle 1 Proposal Policies and Funding Support
- JWST Cycle 1 Proposal Categories
- •JWST Cycle 1 Observation Types and Restrictions
- •JWST Cycle 1 Proposal Preparation
- •JWST Cycle 1 Single-Stream Proposal Process
- •JWST Cycle 1 Special Submission Requirements
- •JWST Cycle 1 Observation Mode Restrictions
- •JWST Cycle 1 Proposal Selection Process
- •JWST Cycle 1 Awarded Program Implementation
- •JWST Cycle 1 Proposal Science Categories and Keywords
- JWST General Science Policies
- • JWST Observing Overheads and Time Accounting Policy
- • JWST Duplicate Observations Policy
- • JWST Science Parallel Observation Policies and Guidelines
- • JWST Observing Program Modification Policy
- • Policies for the Telescope Time Review Board
- • JWST Target of Opportunity Program Activation
- NASA-SMD Policies and Guidelines for the Operations of JWST at STScI
- •Policy 1 - Limitations on the Use of Funds for the Research of General Observers and Archival Research
- •Policy 2 - Data Rights and Data Dissemination
- •Policy 3 - Data Requests and Facilities
- •Policy 4 - Post-Launch Commissioning of JWST
- •Policy 5 - Clarification of Extensions of Exclusive Access Data to Public Affairs Activities
- •Policy 6 - Distribution of JWST Science Data Obtained from Investigations Other Than Those Selected Through the Peer-review Process
- •Policy 7 - NASA Needs for Support for Other Missions
- •Policy 8 - Definition of Observing Time
- •Policy 9 - Allocation of Guaranteed Observing Time to Scientists Selected Under AO 01-OSS-05 and Through NASA-ESA-CSA Agreements
- •Policy 10 - Redistribution of Guaranteed Observing Time Among Observers
- •Policy 11 - Protection of Science Programs Associated With Guaranteed Time
- •Policy 12 - Education and Public Outreach
- Methods and Roadmaps
- JWST Imaging
- • JWST Slit Spectroscopy
- • JWST Slitless Spectroscopy
- JWST High-Contrast Imaging
- •Contrast Considerations for JWST High-Contrast Imaging
- •JWST Coronagraphic Observation Planning
- •JWST Coronagraphic Sequences
- •JWST Coronagraphy in ETC
- •JWST High-Contrast Imaging in APT
- •JWST High-Contrast Imaging Inner Working Angle
- •JWST High-Contrast Imaging Optics
- •JWST Small Grid Dither Technique
- •MIRI-Specific Treatment of Limiting Contrast
- •NIRCam-Specific Treatment of Limiting Contrast
- •NIRISS AMI-Specific Treatment of Limiting Contrast
- •Selecting Suitable PSF Reference Stars for JWST High-Contrast Imaging
- JWST Integral Field Spectroscopy
- JWST MOS Spectroscopy
- JWST Time-Series Observations
- •Overview of Time-Series Observation (TSO) Modes
- •Noise Sources for Time-Series Observations
- •Sensitivity of Time-Series Observation Modes
- •Bright limits of Time-Series Observation Modes
- •Preparing Time-Series Observations with JWST
- •Target Acquisition for Time-Series Observations
- •NIRCam-Specific Time-Series Observations
- •NIRISS-Specific Time-Series Observations
- •MIRI-Specific Time-Series Observations
- JWST Moving Target Observations
- •Field of Regard Considerations for Moving Targets
- •Instrument-Specific Considerations for Moving Targets
- •JWST Moving Target Calibration and Processing
- •JWST Moving Target Ephemerides
- •JWST Moving Target Observing Procedures
- •JWST Moving Target Policies
- JWST Moving Targets in APT
- •JWST Moving Targets in ETC
- •JWST Moving Target Useful References and Links
- •Overheads for Moving Targets
- •Moving Target Recommended Strategies
- JWST Parallel Observations
- • JWST Target of Opportunity Observations
- • General Proposal Planning Workflow
- Observatory Functionality
- • JWST Position Angles, Ranges, and Offsets
- • JWST Instrument Ideal Coordinate Systems
- JWST Background Model
- • JWST Guide Stars
- • JWST Mosaic Overview
- • JWST Dithering Overview
- JWST Duplication Checking
- JWST Observing Overheads and Time Accounting Overview
- •JWST Observing Overheads Summary
- •JWST Slew Times and Overheads
- JWST Instrument Overheads
- Observing Overheads for NIRCam Imaging
- • JWST Data Rate and Data Volume Limits
- Observatory Hardware
- • JWST Observatory Overview
- • JWST Observatory Coordinate System and Field of Regard
- • JWST Field of View
- • JWST Orbit
- JWST Spacecraft Bus
- • JWST Pointing Performance
- • JWST Telescope
- • JWST Wavefront Sensing and Control
- • JWST Momentum Management
- • JWST Integrated Science Instrument Module
- • JWST Solid State Recorder
- • JWST Target Viewing Constraints
- • Fine Guidance Sensor, FGS
- Astronomers Proposal Tool
- • JWST Astronomers Proposal Tool Overview
- • APT Proposal Information
- APT Targets
- • APT Observations
- • APT Visit Splitting
- JWST APT Coordinated Parallel Observations
- • JWST APT Pure Parallel Observations
- • APT Target Acquisition
- JWST APT Mosaic Planning
- • APT Special Requirements
- • APT Visit Planner
- • JWST APT Aladin Viewer
- • APT Smart Accounting
- • JWST APT Target Confirmation Charts
- • APT Submitting Your JWST Proposal
- JWST APT Functionality Examples
- • JWST APT Help Features
- • JWST APT Training Examples and Video Tutorials
- Other Tools
- Mid Infrared Instrument
- • MIRI Overview
- MIRI Observing Modes
- MIRI Instrumentation
- MIRI Operations
- MIRI Target Acquisitions
- MIRI Dithering
- MIRI Mosaics
- •MIRI MRS Simultaneous Imaging
- MIRI Time Series Observations
- MIRI Predicted Performance
- MIRI APT Templates
- MIRI Observing Strategies
- MIRI Example Programs
- •MIRI Coronagraphy of GJ 758 b
- MIRI and NIRSpec Observations of SN1987A
- •MIRI and NIRCam Coronagraphy of the Debris Disk Archetype around Beta Pictoris
- •MIRI IFU and NIRSpec Observations of Cas A
- Near Infrared Camera
- • NIRCam Overview
- NIRCam Observing Modes
- NIRCam Instrumentation
- •NIRCam Field of View
- •NIRCam Modules
- •NIRCam Optics
- •NIRCam Dichroics
- •NIRCam Pupil and Filter Wheels
- •NIRCam Filters
- •NIRCam Coronagraphic Occulting Masks and Lyot Stops
- •NIRCam Filters for Coronagraphy
- •NIRCam Grisms
- •NIRCam Weak Lenses
- NIRCam Detectors
- NIRCam Operations
- NIRCam Dithers and Mosaics
- •NIRCam Coronagraphic PSF Estimation
- •NIRCam Coronagraph Astrometric Confirmation Images
- •NIRCam Apertures
- NIRCam Target Acquisition Overview
- NIRCam Predicted Performance
- NIRCam APT Templates
- NIRCam Observing Strategies
- NIRCam Example Programs
- NIRCam Imaging and NIRISS WFSS of Galaxies Within Lensing Clusters
- •NIRCam Coronagraphy of HR8799 b
- •NIRCam Deep Field Imaging
- NIRCam Grism Time-Series Observations of GJ 436b
- NIRCam Time-Series Imaging of HAT-P-18 b
- •NIRCam WFSS Deep Galaxy Observations
- •NIRCam and MIRI Coronagraphy of the Debris Disk Archetype around Beta Pictoris
- Near Infrared Imager and Slitless Spectrograph
- • NIRISS Overview
- NIRISS Observing Modes
- NIRISS Instrumentation
- NIRISS Operations
- NIRISS Predicted Performance
- NIRISS APT Templates
- NIRISS Observing Strategies
- NIRISS Example Programs
- NIRISS WFSS and NIRCam Imaging of Galaxies Within Lensing Clusters
- NIRISS AMI Observations of Extrasolar Planets Around a Host Star
- NIRISS SOSS Time-Series Observations of HAT-P-1
- Near Infrared Spectrograph
- NIRSpec Overview
- NIRSpec Observing Modes
- NIRSpec Instrumentation
- •NIRSpec Optics
- •NIRSpec Dispersers and Filters
- NIRSpec Detectors
- •NIRSpec Micro-Shutter Assembly
- •NIRSpec Integral Field Unit
- •NIRSpec Fixed Slits
- NIRSpec Operations
- NIRSpec Dithers and Nods
- NIRSpec MOS Operations
- NIRSpec IFU Operations
- •NIRSpec FS Operations
- •NIRSpec BOTS Operations
- NIRSpec Target Acquisition
- NIRSpec Predicted Performance
- NIRSpec APT Templates
- NIRSpec Multi-Object Spectroscopy APT Template
- •NIRSpec MOS Proposal Checklist
- •NIRSpec MSA Planning Tool, MPT
- NIRSpec MPT - Catalogs
- •NIRSpec MPT - Planner
- NIRSpec MPT - Manual Planner
- •NIRSpec MPT - Plans
- •NIRSpec MPT - Parameter Space
- •NIRSpec MSA Spectral Visualization Tool Help
- •NIRSpec Observation Visualization Tool Help
- •NIRSpec IFU Spectroscopy APT Template
- •NIRSpec Fixed Slit Spectroscopy APT Template
- •NIRSpec Bright Object Time-Series APT Template
- •NIRSpec FS and IFU Mosaic APT Guide
- NIRSpec Multi-Object Spectroscopy APT Template
- NIRSpec Observing Strategies
- •NIRSpec Background Recommended Strategies
- •NIRSpec Bright Spoilers and the IFU Recommended Strategies
- •NIRSpec Detector Recommended Strategies
- •NIRSpec Dithering Recommended Strategies
- •NIRSpec MOS Recommended Strategies
- •NIRSpec MSA Leakage Subtraction Recommended Strategies
- •NIRSpec Target Acquisition Recommended Strategies
- NIRSpec Example Programs
- NIRSpec and MIRI Observations of SN1987A
- •NIRSpec and MIRI IFU Observations of Cas A
- NIRSpec Bright Object Time Series Observations of GJ 1214b
- NIRSpec MOS Deep Extragalactic Survey
- •NIRSpec MOS Observations of NGC 346
- Understanding Data Files
- Obtaining Data
- Data Processing and Calibration Files
- JWST Data Reduction Pipeline
- • Primer and Tutorials
- • Pipeline User's Guide
- • Software Reference Documentation
- Algorithm Documentation
- • Obtaining and Installing Software
Introduction to JWST Pandeia python interface tutorial.
This tutorial is intended for users who need to use Pandeia's python interface. If you are interested in doing JWST exposure time calculations for just a few observing scenarios, the JWST ETC Web UI is the recommended tool. The tutorial will assume that you have a basic working knowledge of python, and at least a passing familiarity with Conda and, preferably, AstroConda as well. This page provides a quick guide to installing Pandeia. Note that this tutorial is currently written for Pandeia 1.3.
Set up AstroConda
This tutorial does not provide a complete guide to installing and using AstroConda, but should be able to act as a quick reference if you are already familiar with Conda and AstroConda. Pandeia may be installed with either Python 2 or Python 3, but it has been more thoroughly tested with Python 2.
Installing Anaconda (if necessary)
- Go to the Anaconda download page, and download the appropriate version of Anaconda
- Install Anaconda according to its documentation
- Once you have Anaconda installed, from a terminal with access to the conda environment, type "conda config --add channels http://ssb.stsci.edu/astroconda".
- Create an AstroConda environment with the STScI package installed. For example, to create an environment named "pandeia" working under python 2.7, type "conda create -n pandeia stsci python=2.7" from a terminal with access to the conda environment.
Setting up the Pandeia Environment
Pandeia requires additional data files to run.
The first is a set of files for pandeia itself, which can be downloaded here: http://ssb.stsci.edu/pandeia/engine/1.3/pandeia_data-1.3.tar.gz. Download and unpack these files to an appropriate location; we recommend "$HOME/data/pandeia".
Pandeia requires that the "pandeia_refdata" environment variable be set to the location of its data files.
The second set of data files are for pysynphot. Pandeia uses pysynphot internally for creating reference spectra. The pysynphot reference files may be downloaded via anonymous FTP, or via the command line as described below.
- ftp archive.stsci.edu
- password is your e-mail address
- cd pub/hst/pysynphot
- download desired files.
Note that the tar.gz files downloaded from the STScI anonymous FTP site will untar into the directory structure "
grp/hst/cdbs", with the actual data files in an assortment of directories under "
cdbs". pysynphot (and pandeia) expect that the "
PYSYN_CDBS" environment variable will point to the "
cdbs" directory. As such, you can either move the files out of "
grp/hst/" to wherever you would like to store them, or point "
PYSYN_CDBS" to "
/path/to/data/files/grp/hst/cdbs" in order to allow pysynphot and pandeia to properly detect the reference files.
Note that pandeia does not require that pysynphot be installed in order to operate, although it will generate warnings if pysynphot is not installed, or if the PYSYN_CDBS environment variable does not exist (or does not point to a valid pysynphot reference directory). Pandeia uses pysynphot for the following:
- Retrieving phoenix stellar spectra
- Creating Power law spectra and flat spectra
- Reading HST calibration spectra
- Resampling spectra to a new set of wavelengths whilst conserving flux
- Normalizing spectra in non-pandeia units (e.g., Johnson bandpasses)
If you do not require the above functionality, running pandeia without these pysynphot data files is entirely possible - warnings will be issued, but pandeia will otherwise function. The AstroConda environment does include pysynphot by default.
Setting conda to automatically set these environment variables when the environment is activated can be done as follows:
- Find your anaconda installation (for the rest of this example, it will be assumed to be at "
$HOME/anaconda/"). Likewise, as in the previous example, your Pandeia environment will be assumed to have the name "
pandeia". Finally, your pysynphot reference data will be assumed to be located at "
$HOME/data/pysynphot", and your pandeia reference data at "
- Go the "
$HOME/anaconda/envs/pandeia/". If there is not a directory named "
etc", create one there. In the "
etc" directory, if there is not a directory named "conda", create one.
- In "
$HOME/anaconda/envs/pandeia/etc/conda/", create the directories "activate.d" and "deactivate.d". In each of these directories, create a text file named "
The text file "$HOME/anaconda/envs/pandeia/etc/conda/activate.d/env_vars.sh" should contain the following lines:
The text file "
$HOME/anaconda/envs/pandeia/etc/conda/deactivate.d/env_vars.sh" should contain the following lines:
If you have not done so already, activate your pandeia conda environment by typing "source activate pandeia". Then, in the same window, type "
pip install pandeia.engine==1.3" to install pandeia itself.
Installing Pandeia without AstroConda
It is strongly recommended that you install pandeia via AstroConda. Whilst some information is provided below for installing pandeia without AstroConda, it is entirely unsupported, and any issues you encounter will likely be much more difficult to resolve. This section assumes that you have python installed, that you are familiar with installing modules via pip, and that you are familiar with installing command-line software in general. If any of these do not apply, you should use the above instructions on installing Pandeia through AstroConda.
Pandeia requires the following python packages to operate:
Setting up conda environment, activating conda, and installing Pandeia
This assumes that you have conda installed at "
$HOME/anaconda", that you have the pysynphot data files installed at "$HOME/data/pysynphot", and that you have the pandeia data files installed at "
This sample setup does the following:
- Adds the STScI astroconda channel to an existing conda installation
- Creates a conda environment named "pandeia" which uses python 2.7 and includes all of the python packages from astroconda
- Creates a configuration file in the anaconda directory belonging to the "pandeia" environment to hold instructions on setting up appropriate environment variables whenever the pandeia environment is activated
- Sets up the PYSYN_CDBS and pandeia_refdata environment variables in the created file so that they will automatically be set to the correct value when the environment is activated.
- Creates a configuration file in the anaconda directory belonging to the "pandeia" environment to hold instructions on removing environment variables whenever the pandeia environment is deactivated
- Sets up the PYSYN_CDBS and pandeia_data environment variables in the created file so that they will be automatically removed when the environment is deactivated.
- Activates the pandeia environment
- Installs pandeia version 1.3 into the pandeia environment.
The above sample code will only need to be run once. After it has been run, typing "
source activate pandeia" in a terminal window will activate the pandeia environment (which will now already have the pandeia module installed), and automatically set the environment variables PYSYN_CDBS and pandeia_refdata.
This page has no comments.