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:

  • model (JwstDataModel) – The model to update.

  • default_roll_ref (float) – If pointing information cannot be retrieved, use this as the roll ref angle.

  • siaf_path (str or Path-like object) – The path to the SIAF database. See SiafDb for more information.

  • prd (str) – The PRD version from the pysiaf to use. siaf_path overrides this value.

  • engdb_url (str or None) – URL of the engineering telemetry database REST interface.

  • fgsid (int or None) – When in COARSE mode, the FGS to use as the guider reference. If None, use what is provided in telemetry.

  • tolerance (int) – If no telemetry can be found during the observation, the time, in seconds, beyond the observation time to search for telemetry.

  • allow_default (bool) – If telemetry cannot be determine, use existing information in the observation’s header.

  • reduce_func (func or None) – Reduction function to use on values.

  • transform_kwargs (dict) – Keyword arguments used by matrix calculation routines.

Returns:

t_pars, 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.

Return type:

TransformParameters, Transforms