Description

The jwst.assign_mtwcs step modifies the WCS output frame in each exposure of a Moving Target (MT) observation association, such that the WCS is centered at the average location of the target within the whole association. This results in proper alignment of multiple exposures, which takes place downstream in the calibration pipeline, in the target frame, rather than the background sky frame.

A moving target will naturally be located at different sky coordinates (RA, Dec) across multiple exposures within an MT observation. When multiple images or spectra get combined during Stage 3 processing, the relative alignment of the images/spectra is based on the sky coordinates of each exposure. In the case of moving targets, where the RA/Dec of the target is changing between exposures, the normal alignment process would result in the target being at different image coordinates and hence coming out either smeared (for slowly moving targets) or at multiple locations within the combined data. This step modifies the WCS of each exposure to recenter it at a common RA/Dec for the target, so that subsequent image alignment and combination has the target properly aligned.

The step is executed at the beginning of the calwebb_image3 and calwebb_spec3 pipelines, so that all subsequent steps that rely on WCS information use the frame centered on the target.

This step depends on keywords that are unique to MT exposures, as shown in the following table.

FITS
Keyword

Data model attribute

Type
(Value)

Description

TARGTYPE
meta.target.type
string
(moving)

Type of target

MT_RA
MT_DEC
meta.wcsinfo.mt_ra
meta.wcsinfo.mt_dec
number
number
Target RA and Dec at
mid-point of exposure [deg]
MT_AVRA
MT_AVDEC
meta.wcsinfo.mt_avra
meta.wcsinfo.mt_avdec
number
number
Target RA and Dec averaged
between exposures [deg]

A “TARGTYPE” value of “moving” is used to identify exposures as containing a moving target. The keywords “MT_RA” and “MT_DEC” are populated in the uncalibrated (uncal) product for each exposure and give the position of the target at the mid-point of each exposure. The assign_mtwcs step computes the average of the “MT_RA” and “MT_DEC” values across all expsoures in an association and stores the result in the “MT_AVRA” and “MT_AVDEC” keywords of each exposure.

In addition to populating the “MT_AVRA” and “MT_AVDEC” keywords, this step adds another transform to the original WCS in each exposure that results in the WCS frame being centered at “MT_AVRA” and “MT_AVDEC”. The transform of the original WCS associated with the science aperture pointing (i.e. without the additional MT correction) can be accessed by executing:

sci_transform = model.meta.wcs.get_transform('detector', 'world')