NIRISS Aperture Masking Interferometry APT Template

This article provides instructions for filling out the JWST NIRISS aperture masking interferometry APT template.

On this page

Main article: NIRISS Aperture Masking Interferometry
See also: NIRISS AMI Recommended Strategies, NIRISS AMI Science Use Case, NIRISS Non-Redundant Mask

Aperture masking interferometry (AMI) is one of the four observing modes for the Near Infrared Imager and Slitless Spectrograph (NIRISS). The AMI mode uses a non-redundant mask (NRM) in the pupil wheel of NIRISS. It has 7 "holes" (apertures) that produce an interferogram in the image plane, and samples 21 unique ("non-redundant") baselines.  AMI provides the highest effective angular resolution of any instrument mode on JWST, enabling the detection of planetary or stellar companions at a distance of 70–400 mas from their host stars. This mode also enables high-resolution mapping of extended sources through near-infrared aperture synthesis.

The NRM is used in conjunction with one of three medium-band filters (F380MF430MF480M) or a wide band filter (F277W) in the Filter Wheel (FW). A typical observation with AMI will include a Target Acquisition (TA) image, which is required if the science exposures use a subarray, followed by several exposures with the NRM in the PW with one of the four allowed filters in the FW, and possibly a direct image to help associate features in the NRM images with morphological features of the target. Direct images may help constrain or stabilize image reconstruction methods applied to extended object NRM data.  Direct images can also be used on fainter multiple point source targets, especially when recently-developed “kernel phase” data analyses are used.

NRM data analysis of a target observation requires one or more PSF reference stars.  The PSF reference is used to calibrate out the instrumental contribution to closure phases and visibility amplitudes. To minimize the impact of detector effects, the PSF reference star should be observed with the same dither pattern, especially for more demanding observations.  It is likely that lower contrast targets may not need dedicated PSF reference stars, but could be calibrated with PSF reference data taken by other programs. Ideally, for higher contrast needs, target and reference observations should be scheduled close in time, so that the telescope is in a similar state, thermal or otherwise, for all the observations.  In this case, the science target(s) and PSF reference star(s) should be observed using the same telescope optical configuration, so no wavefront correction should occur between any of the observations. We recommend specifiying GROUP NON-INTERRUPTIBLE or SEQUENCE NON-INTERRUPTIBLE in the Timing Special Requirements window in APT. The APT requires justification if an observer does not request any reference star observation.



Step-by-step APT instructions

Generic

The following parameters are generic to all templates, and are not discussed in this article: Observation Number, Observation LabelObservations CommentsTarget Name, ETC Workbook Calculation ID, Mosaic Properties, and Special Requirements.

Target acquisition parameters 

Target acquisition

Main article: NIRISS Target Acquisition 
See also: JWST ETC NIRISS Target Acquisition 

Target Acquisition (TA) places the centroid of the brightest object in the TA field-of-view on the location of the AMI aperture used for the science exposure. An observer can specify one of the 3 options for ACG TARGETNONESAME TARGET AS OBSERVATION, or any source within the target list that is within 60" of the science target. If a subarray is chosen for the science observation, a TA must be performed. TA is performed with the F480M filter in the filter wheel.

There are 2 options for ACQ MODE, based on the M-band magnitude of the target which is specified in the AMI Template Parameters articleAMIBRIGHT and AMIFAINT.

 Acquisition exposure time

Main Article: NIRISS Detector Readout Patterns

 The only permitted ACQ READOUT PATTERN for AMIBRIGHT is NISRAPID. Both NIS and NISRAPID are available readout patterns when the ACQ MODE is AMIFAINT. The observer can specify the ACQ NO. OF GROUPS (3, 5, 7, 9, 11, 13, 15, 17, 19), where a group is defined by the number of frames in an integration (for NISRAPID) or by the number of frames in an integration divided by four (for NIS).

The ETC workbook identification number used to determine the exposure parameters for the TA can be entered in the ETC WKBK. CALC ID field. Though this input is optional, it is strongly recommended to provide this information so the TA can be assessed during technical reviews to ensure the observation can be executed correctly.

AMI parameters

Dither

Main Article: NIRISS AMI Dithers
See Also: NIRISS Dithers 

The NIRISS AMI dithers article discusses AMI dithering choices and the drawbacks and potential benefits of dithering.  Typically primary and subpixel dithering are not recommended.

NRM imaging will include both primary and secondary dither patterns.

Specify numer of dithers:

  • PRIMARY DITHERS: NONE, 2, 3, 4

  • SUBPIXEL DITHERSNONE5925

Subarray

Main article: NIRISS Detector Subarrays

Observations of bright and compact targets can make use of an 80 × 80 subarray (SUB80). Target acquisition is required if observing with a subarray. Allowed options for SUBARRAY are FULLSUB80. See the NIRISS AMI article for the limiting Vega magnitudes accessible with the SUB80 and FULL subarrays for the various filters.

Filters

Main article: NIRISS Filters
See also: NIRISS Pupil and Filter WheelsNIRISS Detector Readout Patterns

To set up a science observation or PSF reference star observation, Add an observation to include it in the Filters dialog box. Select the FILTER for the observation, where allowed options are F277W, F380MF430MF480M.

The only supported READOUT PATTERN is NISRAPID. Specify:

  • GROUPS/INT: the number of groups during an integration, equal to the number of frames read per integration. Up to 800 groups are supported for this mode.

  • INTEGRATIONS/EXP: the number of integrations during an exposure, where an integration is the time between detector resets.

  • ETC WKBK. CALC ID: the accompanying ETC workbook ID number for the calculation (optional).

Exposures can be AddedDuplicatedInserted Above existing exposures, and Removed.

Direct imaging parameters

Direct image

Main Article: NIRISS imaging

Specify TRUE or FALSE depending on whether a direct image is to be taken in the observation.

If TRUE  is selected, then specify:

  • IMAGE DITHERS: refers to primary image dithers. Options are NONE234

  • GROUPS/INT

  • INTEGRATIONS/EXP
  • ETC WKBK. CALC ID

The direct image will be performed with the same filter as the corresponding NRM image specified in AMI Parameters. The only supported READOUT PATTERN is NISRAPID.

Note: the Exposure Time Calculator mode for AMI does not include calculations for direct imaging. To run simulations for direct imaging to determine GROUPS/INT and INTEGRATIONS/EXP, use the NIRISS imaging mode in ETC.

PSF reference observations

This is a PSF reference observation

If this observation is the PSF reference star, then THIS IS A PSF REFERENCE OBSERVATION must be selected. Note that PSF reference star observations have a 0 month exclusive access period.

PSF reference observations

If a PSF reference observation has already been specified, then that observation can be selected in the PSF REFERENCE OBSERVATIONS dialog box. The PSF reference star must be observed with the same FILTER and  SUBARRAY as the science object. Note: if APT issues a warning that the PA offset between the reference star and science target must be within 1°–14°, this warning can be safely ignored.

Additional justification

If no PSF reference observation is required, then ADDITIONAL JUSTIFICATION must be selected. In the current implementation of APT (v. 25.4), an error is issued if no PSF reference star is specified and the target is not marked as the PSF reference observation, even if this box is checked. It is still possible to submit the proposal through APT. In a future version of APT, this error will be replaced by a warning.

Verify observation set-up

Main article: JWST APT Target Confirmation Charts
See also: APT Visit PlannerAPT Smart AccountingJWST APT Aladin Viewer 

  • Create Target Confirmation Charts to verify that the input target coordinates will position the telescope in the correct place.

  • Run APT Visit Planner to check schedulability of observations, check constraints, and see whether guide stars are available to support the observation. Then run APT Smart Accounting to update time accounting and to remove excess overhead charges. APT can generate various reports through the "Reports" option in the Visit Planner view. Observers can access additional reports through File → Export option in the top menu bar. For example the .times file provides a break-down of individual exposures and associated exposure times, including overhead. These reports may help observers to tweak their observations to increase efficiency.

  • Observers can also visualize their observations onto the celestial sphere using the APT Aladin Viewer.



Other tabs

Special requirements

Main article: APT Special Requirements

Target and reference star observations can be temporally grouped by using the TIMING→GROUP/SEQUENCE OBSERVATIONS LINK option in the EXPLICIT REQUIREMENTS section in the Special Requirement tab. We recommend specifiying GROUP NON-INTERRUPTIBLE or SEQUENCE NON-INTERRUPTIBLE

Extended object imaging may need observations at more than one position angle in order to fill in gaps in uv-plane coverage, which can be achieved by invoking the POSITION ANGLE option in the EXPLICIT REQUIREMENTS section in the Special Requirement tab.




Published

 

Latest updates
  •   
    Updated parameter headings to be consistent with APT v. 27.0

  •  
    Added note that users need to use ETC imaging calculations to derive exposure parameters for AMI direct imaging.