Step-by-Step APT Guide for NIRCam Grism Time-Series of GJ 436b
Instructions are provided for filling out the APT observing template for the JWST NIRCam Grism Time-Series Observations of GJ 436b Example Science Program.
Example Science Program #30 APT Guide
Dated material
This example program was constructed pre-launch, and details may be out of date with actual observatory performance. However, it still provides a useful example for training purposes.
Please refer to JWST Example Science Programs for more information.
On this page
See also: NIRCam Grism Time-Series, NIRCam Grism Time-Series APT Template, JWST APT Video Tutorials
The Astronomer's Proposal Tool (APT) is used for submitting JWST proposals. There are multiple components to an APT submission: generic proposal information, target information, and exposure specifications for the proposed program.This guide discusses how to fill out the APT observing template for the "NIRCam Grism Time-Series Observations of GJ 436b" Example Science Program.
A filled out APT file can be accessed via the menu options File → JWST Example Science Proposals → NIRCam → 30 NIRCam Grism Time-Series Observations of GJ 436b in APT. The APT file was created with version 27.3. There may be inconsistencies or additional warnings or errors with other versions of APT.
Fill Out Proposal Information
See also: JWST Astronomers Proposal Tool Overview
Words in bold are GUI menus/
panels or data software packages;
bold italics are buttons in GUI
tools or package parameters.
Enter proposed Targets
See also: APT Targets
Target information is entered by selecting Targets in the tree editor, which provides options in the active GUI window. In this case, choose the Fixed Target Resolver button and entered GJ436 which is the host star for the planet GJ436b in the Object Name search box of the pop-up window. An entry for the selected object appears in the pop-up window (note that the different name, ROSS 905, identifies the same object). By clicking Select Object as Target, the target name and coordinates were imported to the APT observation template. Before importing the selected target, a pop-up informs us that proper motions were detected for this object and imported in the APT observation template.
Select this target in the left-hand tree editor to provide additional information in the Target GUI. In the Name in the Proposal and Name in the Archive menu, change the name of the object from ROSS 905 to GJ-436. In the Category drop-down menu, select Star. In the Description menu, select Exoplanets, M dwarfs, M stars. The J200 Coordinates are filled automatically with the values RA: 11 42 12.1287 and Dec: +26 42 11.04. In the Uncertainty field, add 0.01 arcsec both for RA and Dec. The Proper Motion menu is filled automatically with the following information: proper motion in RA = 0.06679 sec of time/year, proper motion in Dec = -0.81403 arcsec/year, and the Epoch box, with 2015.5. In the Annual Parallax field, add 0.1025015 (arcsec).
Observations
See also: APT Observations
Selecting Observations in the tree editor, click on the New Observation Folder, and in the Label field, enter GJ-436b.
Next, click Observation 1 in the tree editor to open the observation template in the active GUI window. Since you will create more than one observation in this proposal (i.e., one for the filter F332W2 and one for the filter F444W), add in the Label field F332W2 Sec Eclipse, to avoid confusion.
In the Instrument pull-down menu, select NIRCam, and then select the NIRCam Grism Time Series template in the Template pull-down menu. Note that only parameters of interest to NIRCam grism time series are shown in the GUI. In the Target pull-down menu, select GJ-436 which was defined above.
Complete APT Observation Template for NIRCam Grism Time-Series
See also: NIRCam Grism Time-Series APT Template, NIRCam Grism Time-Series Target Acquisition
Target acquisition
A target acquisition (TA) is required for all the NIRCam time-series observations to ensure the target is placed on the "sweet spot" on the detector. As described in the Step-by-Step ETC guide, a SNR ≥ 30 is required to ensure the TA will succeed, otherwise the observation fails.
For this science program, perform the TA on the target, so keep the acquisition target in the Target ACQ pull-down menu at its default value of SAME TARGET AS OBSERVATION. Using the results from the ETC calculations, select RAPID for Acq Readout Pattern, and 3 Acq Groups/Int. For your own tracking purposes, it is recommended you include the ETC workbook and calculation ID number in the Acq ETC Wkbk Calc ID field so the TA SNR calculations can be verified by instrument scientists during technical reviews after the proposal is accepted. In this example, do not include an ETC workbook ID number in the provided APT file since a unique ID number is generated when an example workbook is added to a user's list of workbooks.
Grism time-series parameters
Select SUBGRISM64 from the Subarray pull-down menu and 4 from the No. of Output Channels pull-down menu. Exposure/dith is left to the default value of 1. From the Short Pupil+Filter pull-down menu, select CLEAR+WLP4, whereas for the long wavelength filter, select GRISMR+F322W2 from the Long Pupil+Filter pull-down menu. This observation is labeled F322W2 Sec Eclipse (Obs 1) in the accompanying APT file. From the Step-by-Step ETC guide, you found that you need 5 Groups/Int and 8381 Integrations/Exp (F332W2 Sec Eclipse (Obs 1)).
Propagate these parameters to the F444W Sec Eclipse (Obs 2) observation by right-clicking in the Tree editor on F322W2 Sec Eclipse (Obs 1) and selecting Duplicate. This creates a second observation identical to the previous one.
In this observation folder, change the following parameters:
- Label field: F444W Sec Eclipse
- Long Pupil+Filterpull-down menu: GRISMR+F444W
- Groups/Int field: 10 (derived in the Step-by-Step ETC Guide)
- Integrations/Exp field: 4577 (also derived in the Step-by-Step ETC Guide)
The yellow exclamation point indicates a warning for this exposure, which alerts the user that, due to the long exposure (> 10,000 seconds), a high gain antenna move may be performed during the exposure which can induce jitter that affects the science observation. This is an informational warning, and no action is required.
When clicking on the arrow, expanding the "F322W2 Sec Eclipse (Obs 1)" observation in the tree editor, note that there is a second warning at the "visit" level. This warning alerts the user that the data volume for this visit exceeds half the maximum allowed of 58,000.0 MB. This is an informational warning that notifies, during planning and schedulability, that observations must be executed after a downlink in order to not fill the Solid State Recorder (see also JWST Data Volume and Data Excess). No action is required.
Short Wavelength Time Series
Starting in Cycle 4, observers can select either imaging or grism spectroscopy in the short wavelength channel.
Define Special Requirements
See also: APT Special Requirements
To observe the transit of exoplanet, phase constraints need to be applied to the proposal, which are specified in the Special Requirements tab of the observation template. Two special requirements were already added by APT:Time Series Observation, which signals the pipeline how to process the data and causes APT to give a warning rather than an error about the exposure duration exceeding 10,000s, and No Parallel, which prohibits a parallel observation from being scheduled simultaneously with this program.
Also specify here the phase constraints for the transit observation, to ensure the observation is scheduled at the correct time. For this, use the Phase requirement, listed under Timing. In the phase constraints box that appears, enter:
- Phase = 0.53496 to 0.55073,
- Period = 2.64388312 days
- Zero-Phase = 2454510.80162 HJD.
GJ 436 has only one nearby bright star (ΔK < 7 mag), but will not contaminate the F322W2 grism spectrum if you specify an Aperture PA Range constrain. To do so, use the PA Range requirements, listed under Position Angle. In the pop-up window, enter the following values 177 and 151 Degrees (F322W2 Sec Eclipse (Obs 1)).
For the F444W grism observation (F444W Sec Eclipse (Obs 2)), Aperture PA Range constrain in the Special Requirements tab to prevent spectral contamination from nearby stars:
- Aperture PA Range 177 to 331 Degrees
- Aperture PA Range 357 to 151 Degrees
Each of the above observations should be duplicated twice to create a total of 3 secondary eclipse observations in each filter to achieve the desired SNR on the final spectrum.
Run Visit Planner
See also: APT Visit Planner
The APT Visit Planner tool checks the schedulability of an observation and whether guide stars can be found to support the observation. To check the schedulability of this observation as specified, select the observation in the tree editor and click on the Visit Planner icon in the top tool bar. Then select Update Display in the resulting active GUI window. After a few moments, the Visit Planner returns with a confirmation that the observation is schedulable (green check on the selected observation).
Because JWST has time-variable observational constraints—related to the position of the sun relative to the observatory's orbit—each target's RA and Dec has a specific set of ranges of days that targets can be observed. You can zoom in on one of those ranges: using the zoom slider bar above the figure and manually adjusting the grey box to the right of that slider bar, you can isolate a the leftmost range of observing windows. By zooming in on specific windows, you can see the specific calendar dates when this target can be observed by JWST, given the phase constraint. It is good practice to confirm future dates of an estimated transit opportunity.
Run Smart Accounting
See also: APT Smart Accounting
To minimize excessive overheads, run Smart Accounting from the Visit Planner page by selecting the Run Smart Accounting option. The charged time for the observing program, including exposure time and overheads, is now accurately calculated.