CADC The Canadian Astronomy Data Centre
Herzberg Institute of Astrophysics
Acknowledgments
HST

The Hubble Space Telescope Archive at CADC   (Subscribe to new public observations)

CSA

The COS filenames


COS data utilizes a modified naming convention from other HST instruments. In, particular COS FUV files can have TWO suffixes. The first suffix identifies the filetype and the second suffix if present identifies the FUV detector segment. For the remainder of this document the use of "suffix" will refer to the first suffix which identifies the filetype and will always include filetypes with the additional FUV segment suffix if they exist.

Please look at the original COS data handbook for more info.

Any files could be retrieved using the direct proxy method

http://www.cadc.hia.nrc.gc.ca/getData?archive=HSTCA&file_id=

Long Suffix Data Format
Spectroscopic
Imaging
Contents
FUV
NUV
NUV
TIME-TAG
ACCUM
TIME_TAG
ACCUM
TIME_TAG
ACCUM

Uncalibrated Science Data
rawtag
table


·

·

Raw NUV TIME-TAG events list
rawtag_a,
rawtag_b
table
·





Raw FUV TIME-TAG events list
rawaccum
image



·

·
Raw NUV ACCUM image
rawaccum_a,
rawaccum_b
image

·




Raw FUV ACCUM image
rawacq
table or image
·

·

·
·
Raw acquisition file
pha_a,
pha_b
image

··




Pulse height distribution

Uncalibrated Support Data
asn
table
·
·
·
·
·
·
Association file
jit
table
·
·
·
·
·
·
Spacecraft pointing data averaged over 3 s intervals
jif
image
·
·
·
·
·
·
2-D histogram of the _jit file
spt
image
·
·
·
·
·
·
Support, planning and telemetry information
trl
table
·
·
·
·
·
·
Trailer file with a historical record of generic conversion processing

Intermediate Data Products
trl
table
·
·
·
·
·
·
The raw trailer file is updated with a historical record and errors log of calibration pipeline processing
corrtag
table


·



NUV TIME-TAG events list with calibrated values
corrtag_a,
corrtag_b
table
·





FUV TIME-TAG events list with calibrated values
flt
image


·
·
·
·
NUV flat-fielded science image
flt_a,
flt_b
image
·
·




FUV flat-fielded science image
counts
image


·
·
·
·
NUV not flat-fielded science image
counts_a,
counts_b
image
·
·




FUV not flat-fielded science image
lampflash
table
·

·



1-D extracted TAGFLASH (FLASH=yes) spectra
x1d
table
·
·
·
·


1-D extracted spectra for a single exposure
x1dsum<n>
table
·
·
·
·


Averaged 1-D extracted spectra for multiple exposures with the same grating, central wavelength, aperture and FP-POS=<n>

Final Data Products
fltsum
image




·
·
Summed flat-fielded image (imaging only). Final calibrated association product for all COS imaging datasets
x1dsum
table
·
·
·
·


Final combined 1-D extracted spectra for multiple exposures with the same grating, central wavelength and aperture combining all FP-POS. Final calibrated association product for all COS spectroscopic datasets.

Raw Accum images ( rawaccum)

For ACCUM data, the raw files contain a set of images which have filenames with the suffix rawaccum for NUV data, or rawaccum_a and rawaccum_b for the two segments of the FUV detector. The SCI extension contains an image of the total accumulated counts during an exposure. For NUV data the ERR and DQ extensions have only a header with no data. For FUV data the ERR extension has only a header with no data, and the DQ extension is populated with data quality information only for pixels that are outside the subarray boundary. These extensions will be populated with data in the flt files after calibration pipeline processing. Even though FUV rawaccum_a[b] data are 16384 x 1024 images, only a portion of them contain actual data. These portions are called sub-arrays. Typically, three subarrays are used for each segment of an FUV ACCUM image. Two of these are centered on the STIM positions and the third is a stripe 128 pixels wide which is centered on the spectrum of the object.

Raw TIME-TAG Events Lists (rawtag)

Raw events tables contain the locations and arrival times of individual photon events collected in TIME-TAG mode. These files have the suffix rawtag for NUV or rawtag_a[b] for the two FUV segments. The first extension contains the events list, in which each row of the table corresponds to a single event in the data stream and the columns of the table contain scalar quantities that describe the event. The second extension contains the good time intervals (GTI) table, where an uninterrupted period of time is considered as one good time interval. Interruptions in the data taking due to memory overflow could result in more than one GTI.

Pulse Height Amplitude Files (pha):

For FUV ACCUM data only, a 7 bit pulse height amplitude histogram is accumulated in the detector electronics on-board. This information is placed in a file with the suffix pha. The pulse-height histogram files contain a primary header with no data and a single FITS image SCI extension containing a histogram of the pulse-height distribution during the exposure. The pulse height amplitude files do not contain an ERR or DQ extension. The pulse height distribution is an image array of length 128, corresponding to the number of photons with values from 0 to 127, corresponding to the pulse heights of 0-31 available in TIME-TAG data.

Corrected Events Lists (corrtag):

The COS pipeline produces corrected TIME-TAG events lists and stores them in binary tables with suffix corrtag. These files have the same file format as the rawtag files, with a corrected events list and a good time interval extensions. The corrected events table includes X and Y event locations that have been corrected for distortion, doppler shift, and offsets due to OSM motions in both the dispersion and cross-dispersion directions.

Lampflash Files (lampflash):

For TAGFLASH data, calcos produces an events list with suffix lampflash, that contains the extracted wavecal lamp flashes with one row for each unique segment or stripe and flash number. Columns TIME, LAMP_ON, and LAMP_OFF are in seconds since the exposure start time; they are therefore in the same units and have the same zero point as the values in the TIME column of the rawtag or corrtag tables.

Flat-Fielded Image Files (flt):

For spectroscopic data a flat-fielded image is an intermediate calibrated data file. The files has suffix flt, and contains three extensions (SCI, ERR, and DQ). The data are in units of the count rate. For FUV data the images are 16384 x 1024, and, like the counts images, the NUV images are 1274 x 1024 for spectroscopic data and 1024 x 1024 for data obtained in imaging mode. The flt images are corrected for flat field and deadtime effects, and this is what distinguishes them from the counts images.

The association name (asn)

The initial input files to calcos are the association tables with suffix asn. These files provide the calibration pipeline with information about how the data files are associated. In general, only exposures taken in sequence with the same spectral element, central wavelength (if applicable), and aperture at any FP-POS will be associated.

Processing of each individual exposure in the association produces a final calibrated result named with exposure rootname and suffix x1d (spectroscopy) or flt (imaging).

Next, for each FP-POS position (where =1,2,3, or 4), if there are multiple spectroscopic exposures in the association that use the same FP-POS position, calcos will combine them into a file named with the association rootname and suffix x1dsum, where is the integer FP-POS value.

Lastly, a final association product file is produced with association rootname and suffix x1dsum (spectroscopy) or fltsum (imaging) by combining all science exposures in the association. [Note: in the special case of associations with only one science exposure, the resultant exposure rootname x1d file and the association rootname product x1dsum file contain identical information.

One-Dimensional Extracted Spectra (x1d, x1dsum(1-4))

The COS pipeline produces extracted one-dimensional spectra and stores them in binary tables with suffix x1d, x1dsum or x1dsum. These COS extracted spectra tables are 3-Dimensional, with one row for each unique segment or stripe. For FUV data there are two rows labeled 1 and 2 which correspond to segments A and B respectively. For NUV data there are three rows labeled 1,2, and 3 which corresponding to stripes A,B, and C respectively. Each table column can contain either a scalar value or an array of values, such as WAVELENGTH or FLUX. For example, NELEM will contain a scalar number, while the WAVELENGTH column will contain an array of wavelengths.

Flat-Fielded Image Files (flt, fltsum)

For NUV imaging observations, the flt and fltsum images are the final data products, with the latter being a simple sum of the individuals when several exposures are processed together. They are fully linearized and flat field corrected images. Unlike the flt files produced for the spectroscopic data (which are intermediate data products with a format of 1274 x 1024), the formats of the flt and fltsum files for imaging data is 1024 x 1024, since Doppler and OSM motions are not applied.

Trailer File (trl)

When COS data are processed through OTFR in the HDA, the output messages from generic conversion and the different calibration steps are stored in a FITS ASCII table known as the trailer file, with suffix trl. Each time the archive processes data before retrieval, the old trailer file is erased and a new one created using the results of the most recent processing performed. The archive will produce a trailer file for each individual exposure and association product. Association product trailer files contain the appended information from all the exposures in the association, in order of processing. The order of processing is the same as the order of exposures in the association table, with the exception of auto or GO wavecals which are always processed first.

In the trailer files from the HDA, the output messages from generic conversion appear first in the file. This section contains information relevant to the selection of the best reference files and the population of some of the header keywords. The second part of this file contains information from calcos processing. Each task in the calcos pipeline creates messages during processing which describe the progress of the calibration, and appear in the order in which each step was performed. These messages are quite relevant to understanding how the data were calibrated, and in some of the cases, to determining the accuracy of the products.

Preview files

The preview files generated by the cache software. One fits file and its correxponding jpg file for each COS end product.

Acquisition Files (RAWACQ)

All COS acquisition exposures will produce a single raw data file with suffix rawacq. Almost all COS spectroscopic science exposures are preceded by an acquisition sequence or exposure to center the target in the aperture. Keywords in the header of COS science data identify the exposure names of relevant acquisition exposures in each visit. In addition, there are several other useful keywords in the COS acquisition exposures that describe the acquisition parameters used, as well as the calculated centroid positions and slew offsets.

Support Files (SPT)

The support files contain information about the observation and engineering data from the instrument and spacecraft that was recorded at the time of the observation. A COS support file contains a primary header and at least three FITS image extensions. The first extension contains a header with the proposal information and an (16-bit) image array containing the data which populate the spt header keyword values. The image array element values are used by conversion software to populate the header keywords. Following the support extension, the COS spt files contain two engineering snapshot extensions. These extensions contain a readout of several instrument and telescope parameters from telemetry data at different times during the course of an exposure. The very first snapshot extension will always contain telemetry information from the beginning of an exposure. Depending on the length of the exposure, the support file may also contain one or several "imsets" which include a support extension and two snap extensions. These intermediate imsets will have only their second snapshot extension populated with telemetry data taken during the course of an exposure, while the first snapshot will be populated with default values. The very last imset of an spt file will have all three extensions (1 support and 2 snaps) populated with telemetry values at the completion of the exposure.

NRC HST