|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Guidelines For Echelle High Level Science ProductsSpring 2013In addition to the general spectroscopic HLSP guidelines, Echelle data have a few additional guidelines to account for the mulitple orders associated with such data products. These guidelines are specified to make it easier to interact with your data products, to ingest into database structures at MAST, to interact with other data products at MAST (increasing discoverability), and to ensure that associated products are kept bundled together. File NamesThe naming convention of HLSP's is described on the main HLSP Guidelines page. In brief, the file name consists of multiple text fields, separated by underscore characters ("_"). As a quick example, suppose you had a "MAMA" Echelle spectrum using the E230M grating from the STIS instrument on Hubble for the arbitrary star HD 12345, and that you have done some additional processing using the standard HST pipeline product. The filename would be: hlsp_myproj_hst_stis_hd12345_ge230m_v1_sci.fits Here, "myproj" would be the name of your project. Also note that the entire file name is in lowercase, e.g., the grating identifier in the "filter" text field is "ge230m", NOT "gE230M". FITS Data FormatPrimary Header Unit (HDU1)The format of the provided files should be multi-extension FITS (MEF) files. The primary header should contain the majority of metadata associated with the observation, e.g., coordinates, timestamps, etc. The required and recommended header keywords for spectroscopic HLSP's can be found here. There are a few additional keywords that should be present in the primary header related to the Echelle origin of the data. These additional primary header keywords are summarized below:
Extension Headers (HDU2 - HDUn)Each extracted spectral order should be provided in extensions. The wavelengths, fluxes, and flux uncertainties within a given order should be provided as binary FITS tables within this extension. Note the wavelength and flux arrays are required, while the flux uncertainties are strongly recommended to be provided as well. There are also order-specific keywords to be added in each order's extension header. We summarize the header keywords that should be included in each order's FITS extension below:
FITS Data Format Values For Use In "TFORMn" KeywordsTFORMn is the FITS header keyword that defines the data format for columns in a FITS binary table. For quick reference, we provide Table 18 from Pence et al. 2010, A&A, 524, 42 below. Note that the letters specifying the data format type (A, I, F, E, D) must be in uppercase. |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|