Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Block
overflowauto
meta-propertiestrue
nameSummary
id277319516
classpdf-full

The JWST APT MIRI coronagraphic imaging template is used to specify parameter settings for the 4 coronagraphic modes in JWST's Mid-Infrared Instrument (MIRI).

Content Block
overflowauto
nameContent
id277805920
classpdf-full

Coronagraphic imaging is one of 4 observing modes available with the Mid-Infrared Instrument (MIRI); the 4 coronagraphs in the imaging channel provide high-contrast imaging capabilities covering photometric bands from 10 to 23 μm. In addition to a classical Lyot coronagraph (which provides an inner working angle (IWA) of ~3λ/D), MIRI incorporates three 4-quadrant phase masks (4QPM) to provide the smallest possible IWA of ~1λ/D at 10–16 μm. The design offers a very small IWA in a stable environment. 

An observer will have control over 3 primary parameters for MIRI imaging:  

  1. coronagraphic mask/filter combination
  2. dithering type
  3. detector read out mode and exposure time (via the number of frames and integrations).  

Allowed values are documented and maintained in the MIRI Coronagraphic Imaging Template Parameters page, but also described below.

 


Step-by-step APT instructions

Multiexcerpt include
MultiExcerptNamegeneric
PageWithExcerptJWST MIRI Imaging APT Template Guide

Target acquisition parameters 

Target acquisition is required for coronagraphic imaging. This field specifies the ACQ TARGETACQ FILTERACQ EXPOSURE TIME, and ACQ QUADRANT.

Anchor
TargetACQ
TargetACQ

Target ACQ 

For coronagraphic imaging the ACQ TARGET is the same as the target the user is observing. Filters available include: F560WF1000WF1500W, and FND.

Anchor
AcqExposureTime
AcqExposureTime

ACQ exposure time

A Target ACQ must be completed by selecting a MULTIACCUM exposure configuration. Each exposure is configured by setting the readout pattern and characteristics parameters: READOUT PATTERN and NUMBER OF GROUPS

Info
iconfalse

Users should use the Exposure Time Calculator (ETC) to determine the best exposure configuration to optimize the signal-to-noise.


ACQ READOUT PATTERN

  1. FAST (default)
  2. FASTGRPAVG (required for TA exposures longer than 70 second)

NUMBER OF GROUPS AND INTEGRATIONS

The MIRI readout timing pattern in the ACQ exposure is defined by only one of the MULTIACCUM parameters: 

  1. ACQ NUMBER OF GROUPS: the number of groups during an integration, where a group is the product of cycling through all the pixels

ACQ NUMBER OF INTEGRATIONS and ACQ PHOTON COLLECTION DURATION are not user changeable.

Anchor
AcqQuad
AcqQuad

ACQ quadrant

Quadrants available are: 1, 2, 3, and 4. On the detector, the first quadrant starts at the top right and then increases going counterclockwise (note that these are displayed and labeled in the Coronagraphic Target Visibility Tool GUI). The TA can be achieved in any of four locations concentrically distributed about the center of each coronagraphic subarray. As target acquisition on bright targets can produce temporary latent images on the array, the user has the option to repeat the observation with the target acquisition performed in the diagonally-opposite quadrant (see Second Exposure).

Coron parameters 

The CORON PARAMETERS dialog box is used to create the entire imaging sequence for a single observation. Each MIRI coronagraphic imaging observation can consist of only a single set of images that all use the same filter, dither pattern, and exposure configuration.

Anchor
CoronFilter
CoronFilter

CORON FILTER

Choose CORON MASK/FILTER combination.

Anchor
ExposureTime
ExposureTime

EXPOSURE TIME

Info
iconfalse

Users should use the Exposure Time Calculator (ETC) to determine the best exposure configuration to optimize the signal-to-noise.

A coronagraphic imaging sequence must be completed by selecting a MULTIACCUM exposure configuration (in the CORON PARAMETERS dialog box). Each exposure is configured by setting the readout pattern and characteristics parameters: READOUT PATTERNNUMBER OF GROUPS, and NUMBER OF INTEGRATIONS. The number of exposures is set by NO. OF EXPOSURES.

READOUT PATTERN

The MIRI coronagraphic imaging template offers only one readout mode:

  1. Fast (only option)

NUMBER OF GROUPS AND INTEGRATIONS

The MIRI timing pattern per exposure is defined by only two MULTIACCUM parameters: 

  1. NUMBER OF GROUPS: the number of groups during an integration, where a group is the product of cycling through all the pixels
  2. NUMBER OF INTEGRATIONSthe number of integrations during an exposure, where integration is defined as the time between resets. 

Anchor
DitherType
DitherType

DITHER TYPE

MIRI coronagraphic imaging supports the following types of small-grid dither patterns:

Dither typeNumber of dithers
NONE0
5-POINT-SMALL-GRID5
9-POINT-SMALL-GRID9

Small-grid dithers are very small, fast, and precise pointing offsets of a target image. Note that small-grid dithers do not provide the same functionality as the dither patterns for MIRI Imaging, MIRI LRS, or MIRI MRS. Small-grid dithers are used to obtain multiple images of a reference star to optimize the PSF subtraction with the science target, whereas the other dither patterns can provide optimal sampling, bad pixel mitigation, and background subtraction. Depending on the desired contrast, the user may wish to use small-grid dithers. With appropriate PSF subtraction post-processing techniques, highest contrast is achieved with the 9-POINT-SMALL-GRID, while 5-POINT-SMALL-GRID will yield a higher contrast than NONE

Anchor
SecondExp
SecondExp

SECOND EXPOSURE 

If YES is selected, the target acquisition (followed by a science exposure) will be repeated starting in the quadrant diagonally across the central spot from the initial TARGET ACQUISITION QUADRANT, as follows:

First Quadrant
Second Quadrant
13
24
31
42

PSF Reference Observations

Here the user specifies visits to be used for PSF Reference observations. PSF Reference Observations allow the user to build a PSF reference library to be used for PSF subtraction. Ideally, PSF reference stars are similar to the user's science target and are known to be "good references"  i.e. stars without additional astrophysical signal from a debris disk or companion. The observation for a PSF reference star should mirror the observation for the user's science target. Note reference stars have a 0 month proprietary period. 

Anchor
RefCheck
RefCheck

This is a PSF reference observation

Checking this box designates the observation as a PSF reference star used for PSF subtraction (a detailed discussion on the choice of a good PSF reference star can be found in the High Contrast Imaging pages). The observation for a PSF reference star should mirror the observation for the user's science target. Note reference star observations have no proprietary period.

Anchor
PSFRefObs
PSFRefObs

PSF reference observations

If this observation is of a science target, then use this field to associate it with an appropriate PSF reference observation (based on those that have been defined elsewhere in the observing proposal).

Anchor
AddJust
AddJust

Additional justification

For a survey of many targets, they may serve as PSF references for one another. In that case, the user may check this box and explain with additional text in the science justification section of a submitted proposal. The user must still select the science targets as PSF Reference Observations in the list above.

 


Other Tabs

Mosaic properties

Mosaics are not available for MIRI coronagraphic imaging.

Special requirements

A variety of observatory level special requirements may be chosen. As is often the case with coronagraphic observations, the user may specify in the the EXPLICIT REQUIREMENTS section that the observations be in sequence and non-interruptible. To achieve this, one would select "Add.." in the EXPLICIT REQUIREMENTS section, then Timing, and then select "Group/Sequence Observations Link". Here the user can select observations from the "Observation List" and check the boxes that they be in "Sequence" and "Non-interruptible".

Additionally, the Special Requirements section is where the user would specify a roll dither for their science target. To achieve this, one would select "Add.." in the EXPLICIT REQUIREMENTS section, then Position Angle, and then select "PA Offset Link". From there, the user selects the two observations to offset in position angle, and they select the Min and Max PA offset (in degrees).

Comments

The comments field should be used only to record observing notes.

 



Content Block
overflowauto
nameRelated links
id280628021
classpdf-hide

Related links

JWST User Documentation
Home
JWST Mosaic Observation Capability
JWST Exposure Time Calculator Overview
MIRI Overview
MIRI Coronagraphic Imaging Template Parameters
MIRI Coronagraphic Imaging 
MIRI Coronagraph Imaging Dithering
MIRI Coronagraphic Imaging Target Acquisition
MIRI Coronagraph Masks
MIRI Detector Readout Overview
MIRI Filters and Dispersers

Content Block
overflowauto
nameReferences
id281944791
classpdf-full

References

Lajoie, C-P et al., 2016, SPIE, 99045K
Small-grid dithers for the JWST coronagraphs

JWST technical documents

Content Block
nameIcon
id1121644691
classpdf-hide

Multiexcerpt include
MultiExcerptNameAPT icon and name
PageWithExcerptMR:APT icon and name

Content Block
overflowauto
nameUpdates
id1066359141
classpdf-hide
HTML Wrap
padding0
margin0
idupdatesbox
HTML Wrap
tagspan
classupdatesbox-heading

Last updated

Published May 1, 2017


 

Comment

The format for 'Last updated' is shown below. Enter updates above this internal"Comment" box. Only enter major updates (not typos or formatting changes).


Updated April 5, 2017

  • Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam fermentum vestibulum est. Cras rhoncus. 
  • Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed quis tortor. 

Published March 2, 2017