add_wcs

romancal.orientation.set_telescope_pointing.add_wcs(filename, dry_run=False, save_transforms=None, **transform_kwargs)[source]

Add WCS information to a Roman DataModel.

Telescope orientation is attempted to be obtained from the engineering database. Failing that, a default pointing is used based on input default information.

The file is updated in-place.

Parameters:

  • filename (Path-like) – The path to a data file.

  • dry_run (bool) – Run through the calculations but do not modify the file.

  • save_transforms (Path-like or None) – File to save the calculated transforms to.

  • transform_kwargs (dict) – dict to use to initialize the TransformParameters object. See TransformParameters for more information.`

Notes

This function adds absolute pointing information to the Roman datamodels provided. By default, only Level 1 exposures are allowed to be updated. These have the suffixes of “uncal” representing datamodel ScienceRawModel. Any higher level product, from Level 2 and beyond, that has had the assign_wcs step applied, have improved WCS information. Running this task on such files will potentially corrupt the WCS.