Chandra Standard Data Distribution Contents

Note on Orbit Ephemeris Files

Users may pick up definitive ephemeris files from a depository at our ftp site.

Procedures and Policies

The Standard Data Distribution consists of a tar file containing the products listed in the tables below, organized in a simple directory tree. In addition to these products, the following files are included:

• The L2 Summary Products
• The logs of the L1, L1.5, and L2 ACIS, HRC, and aspect pipelines
• A file oif.fits which contains an index to the files and that is used by the QuickLook facility
• The V&V report
• A file listing the contents of the tar file

Multi-part Observations

SeqNum

The Sequence Number is the largest unit, defined by the proposal approval process. It is conceptually a single observation with a certain amount of approved time. At this level we do the bookkeeping on the amount of observing time used and the date when the data go public. The data distribution uses the SeqNum as the name of the top-level directory for the data. The actual observation may be done under one or more ObsIds.

ObsId

The Observation Id indicates an observation of a specified target, for a specific proposal, with a specific observational configuration (i.e., when different parts of a SeqNum are observed with different configurations - e.g., different ACIS chips - they will receive separate ObsIds). All data for a given ObsId are always combined in a single set of Level 2 products. Each ObsId contains one or more Observation Intervals.

OBI

An ObsId may be broken into more than one Observation Interval (OBI) for a variety of reasons (one of them being that the original observation did not get enough good time). The OBI numbering within an ObsId may not be contiguous and may not start at 0. An OBI is an uninterrupted observing interval exclusively dedicated to a single ObsId. Level 1 and Level 1.5 data products are processed by OBI. Data from different OBIs are combined by ObsId in Level 2 products.

For example, assume an observation with SeqNum 100, ObsIds 1 (OBI 2) and 2 (OBIs 0 and 4). The user will first receive ObsId 1, in directory 100. Next, ObsId 2 OBI 0 will appear, also in directory 100. There are no conflicts here, since the ObsId is encoded in the filenames and hence they are all different. Finally, ObsId 2 will appear again, this time with both OBIs 0 and 4. The Level 1 OBI 0 files will overwrite those from the previous distribution, but since they are identical, no harm is done. The Level 1 OBI 4 files (since the OBI is also encoded in these file names) are distinct again. The Level 2 files now contain the data from both OBIs and supersede those distributed with OBI 0, but since the version is different and encoded in the filename as well, the previous set is preserved.

Each distribution comes with an Observation Index File, oif.fits, in the toplevel directory. This file has a standard name and is used by the Quick-Look facility. It would be overwritten and information would be lost when files are untarred on top of each other. We recommend that, before untarring the next file, the oif.fits file be renamed (say, to oif1.fits) to save it and to merge all available OIF files using dmmerge:

    > ls oif*.fits > stack.lis
    > dmmerge
      Input dataset/block specification (): @stack.lis
      Column list (): 
      Output dataset name (): oif.fits
      Output block name(1st blkname to be duplicated) (): 
      lookup table (dmmerge_header_lookup.txt): 

Detailed Contents

Level

The level of processing that generated the product.

Propr.

A "P" in this columns indicates that this product is considered proprietary for observations that are not yet public.

Instrument

Instrument of subsystem to which the product relates; included in the file name.

Description

A brief description of the product.

CONTENT

Value of the CONTENT keyword in the product's header. This keyword identifies each data product uniquely.

Type

The part of the file name that immediately precedes the ".fits" extension; this allows one to identify the data products by file name.