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 the question, to using the 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 Step-by-step guides to the 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.  

If you have suggestions for additional examples that would be helpful in the future, enter your ideas in a JWST Help Desk ticket.

Example Science Programs by Instrument

Program reference #

Prime Instrument(s) and Template(s)

Parallel Instrument and Template (if any)

Example Science Program Title (Links go to relevant articles.)





MIRI MRS Spectroscopy of a Late M Star

(See other MIRI examples in the Multi-instrument section.)



NIRCam Imaging

MIRI Imaging

NIRCam Deep Field Imaging with MIRI Imaging Parallels

29NIRCam TIme-Series---

NIRCam Time-Series Imaging of HAT-P-18 b

(Coming soon!)

30NIRCam Grism Time-Series---

NIRCam Grism Time-Series Observations of GJ 436b

(Coming soon!)

37NIRCam WFSS---

NIRCam WFSS Deep Galaxy Observations

(Coming soon!)





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


25NIRSpec MOS---

NIRSpec MOS Deep Extragalactic Survey

(Coming soon!)

32NIRSpec BOTS---

NIRSpec BOTS Observations of GJ 1214b

(Coming soon!)




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






MIRI MRS and NIRSpec IFU Observations of Cassiopeia A

27MIRI Imaging, MIRI MRS, NIRSpec IFU---

MIRI Imaging, MIRI MRS, and NIRSpec IFU Observations of SN1987A

(Coming soon!)

35MIRI Coronagraphy, NIRCam Coronagraphy---

MIRI and NIRCam Coronagraphy of the Beta Pictoris Debris Disk

(Coming soon!)

Each of the example science programs linked above also links to two Step-by-step guide articles, one for creating the ETC information and  the other for creating a valid APT file.  The actual example ETC workbooks and APT files for each program are available from within each tool, as described below.

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
  •  Updated with placeholders for additional example programs for cycle 1.

    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.