Plate.UpdateFITS() Method

Writes current/updated descriptive keywords and WCS values (if available) back to the attached FITS image.

Syntax

Plate.UpdateFITS()

The method syntax has these parts:

Part Description
Return (Boolean) Success or failure (generates trappable error on failure)

Remarks

The image file is reopened for write if needed and the mapped properties that correspond to FITS header fields are updated.

The Plate.ExposureStartTime property may have fractional seconds in its value as required for fast moving objects. If fractional seconds are present, the DATE-OBS and (if originally present) TIME-OBS records will be written with three decimal places in the seconds part. Otherwise, the fractional seconds are omitted from the FITS data. The Plate.ExposureInterval property, written to the EXPOSURE and EXPTIME keywords, is always written in "general" format, with 8 significant places.

If the plate was solved (via a call to Plate.Solve()) since being attached, the following is done:

  1. A block of WCS fields is written or updated in the FITS file.
  2. The magnitude zero-point (Plate.MagZeroPoint property) is written or updated with FITS keyword ZEROPT. This is valid for the color band indicated by CLRBAND.
  3. The following HISTORY records are appended to the FITS image:
    HISTORY   WCS added by PinPoint 5.0 at 2007-07-01T05:22:46
    HISTORY     Matched 18 stars from the Gray GSC-ACT Catalog
    HISTORY     Average residual was 0.21 arc-seconds
If WCS data existed in the image when it was attached, the WCS and ZEROPT data is updated with the results of the just-completed Plate.Solve() and the word "added" in the first HISTORY record is replaced by the word "updated".