NIRSpec Example Science Programs

NIRSpec example programs are available to walk users through all elements of a JWST observing program, from posing a question to identifying an instrument-specific mode optimized to answer that question. These examples use Exposure Time Calculator (ETC) simulations to estimate reasonable exposure times, and illustrate how to specify the observations in the Astronomers Proposal Tool (APT).

Dated material

These example science programs (ESPs) were conceived pre-launch to assist observers in the development of their programs. While there are now many examples of programs that have executed successfully on-orbit, these ESPs still provide helpful guidance. Most have been updated to reflect on-orbit performance. Some ESPs may also link to APT files associated with as-flown observations of similar scientific objectives

Please refer to JWST Example Science Programs for more information.

See also: NIRSpec Observing Strategies, Methods and Roadmaps

Here is a list of all NIRSpec-related example programs:

Expand all Expand all Collapse all Collapse all

As part of the single-stream process, JWST proposals will require a detailed technical justification and, in most cases, a complete Astronomers Proposal Tool (APT) program.

While APT provides templates for some of the most common observing modes, some observing scenarios are more complicated. The science use cases listed above provide a guide to crafting the technical aspects to your proposal, including how to use the Exposure Time Calculator (ETC)  and APT.


Accessing ETC workbooks and APT files for the example science programs

Words in bold are GUI menus/
panels or data software packages; 
bold italics are buttons in GUI
tools or package parameters.

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 drop-down menu that shows the example science program workbooks with the same titles and reference numbers shown in Table 1. Select the example workbook of interest and add it to your personal list of ETC workbooks to access the contents as shown in Figure 1.

Figure 1. Accessing ETC workbooks for example science programs

Click on the figure for a larger view.

In the ETC GUI, select the 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 within APT and can be loaded as follows: from the top File menu, select the tab for JWST 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.) 

Figure 2. Accessing APT example science program files in APT

Click on the figure for a larger view. 

From APT, 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.



Notable updates
Originally published