Step-by-Step APT Guide for NIRSpec IFU and MIRI MRS Observations of SN1987A
Example Science Program #27 APT Guide
This example was created pre-launch, and the APT has been updated since its creation. You may see differences in the appearance of the APT GUI and/or the warnings and errors in APT from what is shown herein.
Please refer to JWST Example Science Programs for more information.
MIRI Medium Resolution Spectroscopy, MIRI MRS APT Template, NIRSpec IFU Spectroscopy, NIRSpec IFU Spectroscopy APT Template Guide, JWST APT Video Tutorials
The Astronomers 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 MIRI and NIRSpec Observations of SN 1987A example science program.
A filled out APT file can be accessed via the menu options File → JWST Example Science Proposals → Multi-Inst →27 MIRI MRS and NIRSpec IFU Observations of SN1987A 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
Words in bold are GUI menus/
panels or data software packages;
bold italics are buttons in GUI
tools or package parameters.
After opening APT, we selected New JWST Proposal under the New Document pull-down menu just above the tree editor at the bottom-left of the top tool bar. On the active GUI window for the Proposal Information entry in the Tree Editor, we entered Title, Abstract, and Category of the proposal and kept Cycle number at its default value.
Enter proposed Targets
See also: APT Targets
Target information is entered in the active GUI window for the Targets entry in the tree editor. In this active GUI window, we clicked on the New Fixed Target button. We entered SN-1987A in the field for Name in the Proposal, and selected Star for Category. We entered the coordinates for this source: RA = 05 35 27.9680, Dec = -69 16 11.09. Near the Description field, we clicked the +/- button, which opens a list of approved keywords and selected Supernovae. Under the Extended drop-down options, we chose Yes.
We also added a second target, using the New Fixed Target button. We entered TACQ-STAR in the field for Name in the Proposal, and selected Star for Category. We entered the coordinates for this source: RA = 05 35 27.5910, Dec = -69 16 09.13. Near the Description field, we clicked the +/- button, which opens a list of approved keywords and selected B stars. Under the Extended drop-down options, we chose No.
See also: APT Observations
In the active GUI window for the Observations entry in the tree editor, we clicked on the New Observation Folder button to specify the observing parameters for the MIRI MRS part of our program. In the Label field, we entered MIRI. Note that while this label is not required, setting it is useful for visually organizing your observation folders in the tree editor when potentially many targets and/or instrument setups are used. We then clicked MIRI in the tree editor to open the observation template to be filled out. In the Instrument pull-down parameters in the active GUI window, we selected MIRI, and then we selected the MIRI Medium Resolution Spectroscopy template in the Template pull-down options. In the Target pull-down parameters, we selected the SN-1987A target.
We also added a folder for the NIRSpec IFU observation. Like before, in the active GUI window for the Observations entry in the tree editor, we clicked on the New Observation Folder button to specify the observing parameters for the NIRSpec IFU part of our program. In the Label field, we entered NIRspec IFU. We then clicked NIRspec IFU in the tree editor to open the observation template to be filled out. In the Instrument pull-down parameters in the active GUI window, we selected NIRSPEC, and then we selected the NIRSpec IFU Spectroscopy template in the Template pull-down menu. In the Target pull-down menu, we selected the SN-1987A target.
Complete APT observation template for MIRI-MRS
See also: MIRI MRS APT Template, MIRI MRS Target Acquisition, MIRI MRS Dithering, MIRI MRS Simultaneous Imaging, MIRI MRS Recommended Strategies
As discussed in the parent article and Step-by-Step ETC Guide for MIRI MRS and NIRSpec IFU Observations of SN1987A, a set of observations will be taken using all 3 grating settings for MIRI-MRS; SHORT, MEDIUM, and LONG. Both short and long wavelength detectors for the MRS are used. TA is not chosen for the MRS observation.
We want to use a dither pattern for the MRS observations. We click the Add button under the Dithers parameters field, and a row with dither options appears. Above the Dithers field, in the drop-down options for Primary Channel, we select ALL, so that the dither pattern will be optimized for all channels. In the row that appeared in the Dithers field, under the Dither Type heading, we select 4-Point. Under the Optimized For heading, we select EXTENDED SOURCE because we are observing an extended source. Under the Direction heading, NEGATIVE is already selected because it is the only option. APT will refer to this dither configuration in the Exposure Parameters field as Dither 1.
After the Dithers panel in the active GUI window, the Simultaneous Imaging drop-down options was set to YES. To the side of this, the Imager Subarray drop-down options was set to FULL.
Under this in the Exposure Parameters panel, we clicked Add 3 times, each corresponding to the 3 available MRS grating settings. One click of the Add button here brings up 3 rows: one for the MIRI imager, the next for the MRS long wavelength detector, and the other for the MRS short wavelength detector. Under the Wavelength Range column, for the first triplet of rows, the value was set to SHORT (A) for MRSLONG and MRSSHORT rows. For the second and third triplets of rows, the values were set to MEDIUM (B) and LONG(C), respectively.
Under the Filter column, in the Imager rows, F560W was selected for the imaging observation corresponding to the SHORT grating setting, F770W for the imaging observation corresponding to the MEDIUM grating setting, and F1000W for the imaging observation corresponding to the LONG grating setting. Under the Readout Pattern column, FASTR1 was selected. Under the Groups/Int column, the values were set to 282 for the Medium and Long gratings, 255 for the Short grating, and 255 for the simultaneous imaging. Under the Integrations/Exp column, the value was set to 1 for the MRS and 1 for the simultaneous imaging. Under the Exposures/Dith column, the value was set to 1 for all rows. Under the Dither column, the value was set to Dither 1 for all rows. The rest of the entries on each row are determined by APT from the previous entries.
Complete APT observation template for the NIRSpec IFU
See also: NIRSpec IFU Spectroscopy APT Template, NIRSpec Target Acquisition, NIRSpec IFU Dither and Nod Patterns
As discussed in the parent article and Step-by-Step ETC Guide for MIRI MRS and NIRSpec IFU Observations of SN1987A, an observation will be taken using the G140M disperser and F100LP filter, G235M disperser and F170LP filter, and G395M disperser and F290LP filter for SN 1987A. We choose to perform WATA, as the target is an extended source covering most of the extent of the NIRSpec IFU aperture. In the Target Acquisition Parameters panel, for the Target ACQ drop-down menu, we choose TACQ-STAR. Under the Acq Subarray drop-down menu, we choose SUB32, and under the Acq Filter drop-down menu, we choose CLEAR. For the Acq Exposure Time drop-down menu, we choose NRSRAPID.
In the Science Parameters panel, the Dither Parameters drop-down menu is set to CYCLING, and the dither SIZE is set to SMALL, with the Starting Point set to 1 and the Number of Points set to 4. This is the same as the 4-point dither pattern, according to the NIRSpec IFU Dither and Nod Patterns page.
In the Gratings/Filters pane in the active GUI window, we click Add 3 times. On the first row, we select G140M/F100LP under the Grating/Filter column, on the second row we select G235M/F170LP, and on the third row we select G395M/F290LP. We select NRSIRS2RAPID under the Readout Pattern column for all 3 rows. Under the Groups/Int column, we enter 29 for all rows. Under the Integrations/Exp column, we enter 1 for all rows. The checkbox under Dither was checked, and Autocal was set to NONE, per the advice given here.
We do not require NIRSpec leakage calibration observations for SN 1987A (for more on this leakage effect, please see here and here).
Define special requirements
Since SN 1987A is known to be variable (Bouchet et al. 2004), we would like the observations to happen at almost the same time. To specify this constraint, we add a timing requirement to the observation.
Under the Special Requirements tab, we click Add, then Timing, then Group/Sequence Observations Link, and in the box that pops up, we click the checkboxes beside the MRS and NIRSpec IFU observations, and we click the checkbox beside Non-interruptible, then click OK. The Special Requirements pane now has a line that reads Group Observations 2, 3, Non-interruptible.
Run Visit Planner
See also: APT Visit Planner
To determine the visibility window of our observation, we ran the Visit Planner Tool. First, we click an observation in the tree editor. Then we click the Visit Planner button in the top tool bar, which changes the view in the active GUI window. Then we click the Run All Tools button at the right in the top tool bar. This shows us the observing window(s) for this target over the next ~19 months. APT assures us that all visits are schedulable.
Bouchet, P., et al, 2004, ApJ, 611, 394
High-Resolution Mid-Infrared Imaging of SN 1987A