JWST Example Science Programs

Example Science Programs are provided to walk users through all elements of a creating a JWST observing program, from posing a question, to identifying an instrument-specific mode optimized to answer this question posed, and using the various proposal preparation tools to create a valid proposal. 

On this page

The Example Science Programs below show actual worked science examples for a number of JWST instruments, modes, and combinations of instruments.  Each example includes the text description of the program (linked below) and actual example Exposure Time Calculator (ETC) workbooks and filled-out Astronomers Proposal Tool (APT) files that the user can follow for reference.  The text descriptions provide background on the science goals of each program while also walking through some of the technical decision making steps in crafting realistic programs.  The ETC Workbooks and the filled-out APT files for each program are available within each of the tools from a pull-down menu (see below).  These will allow you to follow along with each example as you read the descriptions.  Note the reference numbers column, which provides a numerical ID that spans the listings in both ETC and APT as well as the relevant articles in JDox.  

Additional programs will be added in future updates.

Example Science Programs by Instrument

Program reference #

Prime Instrument(s) and Template(s)

Parallel Instrument and Template (if any)

Example Science Program Title





MIRI MRS Spectroscopy of a Late M Star



NIRCam Imaging

MIRI Imaging

NIRCam Deep Field Imaging with MIRI Imaging Parallels





NIRISS AMI Observations of Extrasolar Planets Around a Host Star




NIRISS SOSS Time-Series Observations of HAT-P-1



NIRCam Imaging

NIRISS WFSS with NIRCam Parallel Imaging of Galaxies in Lensing Clusters





NIRSpec IFU and Fixed Slit Observations of Near Earth Asteroids -- Moving Target Example






MIRI MRS and NIRSpec IFU Observations of Cassiopeia A

Accessing ETC workbooks and APT files for the example science programs

Each example science program has an attendant ETC workbook and APT file that can be used for reference as you work through each example.  The relevant ETC workbooks are available within the ETC itself.  A tab in the ETC GUI allows access to a dropdown menu that shows the Example Science Program workbooks with the same titles and reference numbers as shown in the table above.  Select the example workbook of interest and add it to your personal list of ETC workbooks to access the contents.  See Figure 1.

Figure 1. Accessing ETC workbooks for example science programs

In the ETC GUI, select "Example Science Program Workbooks" tab (arrow 1) and then select an example workbook of interest (in this example, #22).  That workbook then becomes available for your use, but is assigned a unique new ID number (arrow 2).  Once you load this notebook, you can read it to follow along with the example program description, or edit it further as you like.
Likewise, the filled-out APT files for each Example Science Program are available to users directly within APT.  From the top File menu, select the tab for Example Science Programs and choose the APT file with the same title and reference number as the program you are interested in. (See Figure 2.)  The program will load for your reference.
Figure 2. Accessing APT example science program files preloaded in APT.

Once APT is loaded, you can retrieve the APT files for any Example Science Program by accessing the top File pull-down menu and selecting JWST Example Science Programs.  Then slide right to select a category and a particular program of interest.  Note that, unlike the ETC case,  APT treats these example programs as if they are previously accepted programs.  While you can edit them to experiment, you should use the Copy and Paste functions in the Edit menu to transfer any work you want to keep to a new proposal file.



Latest updates
    Page completed revamped and updated to support the revised Example Science Program strategy and support methodology.
    This includes having the ETC workbooks and APT files for each program available directly from pull-down menus within the ETC and APT.