update_wcs

jwst.lib.set_telescope_pointing.update_wcs(model, default_pa_v3=0.0, default_roll_ref=0.0, siaf_path=None, prd=None, engdb_url=None, fgsid=None, tolerance=60, allow_default=False, reduce_func=None, **transform_kwargs)[source]

Update WCS pointing information.

Given a jwst.datamodels.JwstDataModel, determine the simple WCS parameters from the SIAF keywords in the model and the engineering parameters that contain information about the telescope pointing.

It presumes all the accessed keywords are present (see first block).

Parameters:
modelJwstDataModel

The model to update.

default_roll_reffloat

If pointing information cannot be retrieved, use this as the roll ref angle.

siaf_pathstr or Path-like object

The path to the SIAF database. See SiafDb for more information.

prdstr

The PRD version from the pysiaf to use. siaf_path overrides this value.

engdb_urlstr or None

URL of the engineering telemetry database REST interface.

fgsidint or None

When in COARSE mode, the FGS to use as the guider reference. If None, use what is provided in telemetry.

toleranceint

If no telemetry can be found during the observation, the time, in seconds, beyond the observation time to search for telemetry.

allow_defaultbool

If telemetry cannot be determine, use existing information in the observation’s header.

reduce_funcfunc or None

Reduction function to use on values.

**transform_kwargsdict

Keyword arguments used by matrix calculation routines.

Returns:
t_pars, transformsTransformParameters, Transforms

The parameters and transforms calculated. May be None for either if telemetry calculations were not performed. In particular, FGS GUIDER data does not need transforms.