UPDATEWCS - User Interface

stwcs.updatewcs.updatewcs(input, vacorr=True, tddcorr=True, npolcorr=True, d2imcorr=True, checkfiles=True, verbose=False, use_db=True)

Updates HST science files with the best available calibration information. This allows users to retrieve from the archive self contained science files which do not require additional reference files.

Basic WCS keywords are updated in the process and new keywords (following WCS Paper IV and the SIP convention) as well as new extensions are added to the science files.

Examples

>>> from stwcs import updatewcs
>>> updatewcs.updatewcs(filename)

Dependencies

stsci.tools astropy.io.fits astropy.wcs requests lxml

Parameters:
  • input (a python list of file names or a string (wild card) – characters allowed) input files may be in fits, geis or waiver fits format
  • vacorr (boolean) – If True, vecocity aberration correction will be applied
  • tddcorr (boolean) – If True, time dependent distortion correction will be applied
  • npolcorr (boolean) – If True, a Lookup table distortion will be applied
  • d2imcorr (boolean) – If True, detector to image correction will be applied
  • checkfiles (boolean) – If True, the format of the input files will be checked, geis and waiver fits files will be converted to MEF format. Default value is True for standalone mode.
  • use_db (boolean) – If True, attempt to add astrometric solutions from the MAST astrometry database. Default value is True.