The keywords listed below are required, recommended or optional for all FITS files headers: either the primary (P) or extension (E) HDUs, for all files that contain spectra. Recommended keywords, if absent, will be computed and inserted prior to ingest; suggested keywords would be beneficial to archival users if present. Headers must also include the basic structural FITS keywords and the list of common keywords.
The following table(s) of HLSP metadata, to be included in science products, are color-coded:
One-dimensional spectra are commonly organized as an image or as a table (or a table row); two-dimensional spectral images may contain multiple spectra. Spectra may be represented in a FITS IMAGE or a BINTABLE extension. These cases are discussed below.
Metadata Common to All Spectra
|P or E||Name of aperture used for exposure|
|P or E||Brightness unit for array values, e.g., |
|P or E||ID of detector used for exposure|
|P or E||Name of dispersive element used, or '|
|P or E||Name(s) of dispersive element(s) used for exposure if more than one was used, with nn (zero-padded) incrementing from 1. Note that this information can alternatively be represented in a PROVENANCE extension. See Provenance Metadata for details.|
|P or E||Effective exposure duration in seconds, exclusive of dead time|
Metadata for Spectra Stored as Images
In this case, spectral pixel values are stored in an image array (primary or extension), and header keywords contain the parameters of the dispersion relation (i.e., mapping of pixel to wavelength). Multiple arrays would be used to contain concomitant quantities, such as variance and data quality.
|P or E||Transformation matrix between pixel axis |
|P or E||Increment of the world coordinate at the reference point for axis |
|P or E||Location of the reference point in the image for axis |
|P or E||World coordinate value at the reference location for axis |
|P or E||World coordinate type for axis |
|CUNIT||P or E||Physical units of |
|P or E||Alternative to CD notation for transforming pixel axis |
|P or E||Mnemonic for celestial coordinate reference system (typically '|
|P or E||Number of axes in WCS description, which may exceed the number of pixel array axes|
Metadata for Spectra Stored as a BINTABLE
Only the keywords common to all spectra are required. However, certain content is required or suggested for fields in the table; the field names are suggested. Note that spectra may be organized such that the values for each field run sequentially with row number; alternatively each table row may contain a spectrum, where table cells contain 1-D arrays.
Data quality (binary) flags, with zero indicating no pathologies
|Flux(es) for the associated wavelength(s), in units of |
|Variance in the flux(es) at the associated wavelength(s)|
|Wavelength(s) for the associated flux(es)|