PDS_VERSION_ID       = PDS3

LABEL_REVISION_NOTE       = "2010-02-12, M.J. Golightly:
                             --initial release;
                             --conforms to CRaTER SDR and Archive Volume
                               SIS 32-01211), Rev E."

RECORD_TYPE          = STREAM
INSTRUMENT_HOST_NAME = "Lunar Reconnaissance Orbiter"
INSTRUMENT_NAME      = "Cosmic Ray Telescope for the Effects of Radiation"
OBJECT               = TEXT
  PUBLICATION_DATE   = 2010-03-15
  NOTE               = "Description of Volumes LROCRA_2XXX"
END_OBJECT           = TEXT
END


Volume LROCRA_2XXX: LRO CRaTER Mission Data, March 15, 2010.

1. Introduction

   This volume contains Level 0, 1, and 2 data products for CRaTER
   measurements made during the LRO mission.  The products contains measured
   deposited energy and estimated LET (silicon) for each charged particle (or
   photon) interaction in the six silicon detectors that comprise CRaTER's
   charged-particle telescope as well as instrument configuration and oper
   operating parameters.  Ancillary data files produced by the LRO Mission
   Operations Center for computing the spacecraft's location and orientation
   are included with the data products.  The volume also contains product
   documentation and copies of the 'pipeline process' software used to create
   the CRaTER data products.
   
   For more information about the volume directory structure, refer to the
   CRaTER Standard Product Data Record and Archive Volume Software Interface
   Specification (32-01211). A copy of thise document is located on this
   volume as file VOLSIS.PDF in the DOCUMENT directory.


2. Disk Format

   Not applicable--these products are being delivered to PDS electronically.


3. File Formats

Science Data File Format
   
   Level 0 (CRAT_L0_*.DAT) data files preserve the binary format in which they
   are recorded onboard the LRO spacecraft, i.e., they begin with a 64-byte
   header that describes (1) the data type (primary science, secondary
   science, or housekeeping), (2) the spacecraft clock times of the first and
   last data records in the file, and (3) the name of the file. The header is
   followed by one or more data packets, in time order, beginning with a
   6-byte binary CCSDS header. All fields are described by the CRAT_L0_*.FMT
   files in the LABEL directory.
   
   Level 1 (CRAT_L1_*.TAB) and Level 2 (CRAT_L2_*.TAB) data files are ASCII
   tables whose comma-delimited format is intended for ease of reading by
   commercial database and spreadsheet software. Non-numeric fields are
   enclosed in double quotes and all fields are described by the CRAT_L1_*.FMT
   and CRAT_L2_*.FMT files in the LABEL directory.
   
Document File Format
   
   Document files with the .TXT suffix exist in the root, CALIB, CATALOG,
   DOCUMENT, INDEX, and SOFTWARE directories and their subdirectories.
   These files are ASCII files with attached PDS labels and with line lengths
   that do not exceed 80 characters. Document files have variable-length lines
   with an end-of-line designator consisting of a carriage-return character
   followed by a linefeed character. This allows the files to be read by the
   MacOS, Microsoft Windows, and Unix operating systems.
   
Tabular File Format
   
   Tabular files (INDEX.TAB, GAPS_*.TAB) exist in the DATA, DOCUMENT, and
   INDEX directories. These are ASCII files formatted for direct reading into
   many database management systems on various computers. Commas separate all
   fields, and character fields are enclosed in double quotation marks (").
   Character fields are left justified and padded on the right with spaces to
   keep quotation marks in the same columns of successive records.  Number
   fields are right justified and padded with spaces on the left to keep
   fixed-width fields.  The records are of fixed length, and the last two
   bytes of each record contain the ASCII carriage-return and line-feed
   character. This allows a table to be treated as a fixed length record file
   on computers that support this file type and as a text file with embedded
   line delimiters on those that don't.
   
   Tabular files are described by PDS label files whose file names are the
   same as the corresponding tabular file but with the extension ".LBL".
   
PDS Label Format
   
   All data and tabular files in the CRaTER Archive Collection have
   associated PDS labels. A PDS label, whether attached to or detached from
   its associated file, provides descriptive information about the content and
   format of the associated file. The PDS label is an object-oriented
   structure consisting of sets of "keyword = value" declarations. The object
   to which the label refer (e.g. IMAGE, TABLE, etc.) denotes the form:
   
       ^object = location
   
   in which the caret character (^, also called a pointer in this context)
   indicates where to find the object. In an attached label, the location is
   an integer representing the starting record number of the object (the first
   record in the file is record 1). In a detached label, the location denotes
   the name of the file containing the object, along with the starting record
   or byte number, if there is more than one object in the file.
   
   For example:
   
       ^HEADER = ("F01.IMG",1)
       ^IMAGE = ("F01.IMG",1025 <BYTES>)
   
   indicates that the IMAGE object begins at byte 1025 of the file F01.IMG, in
   the same directory as the detached label file. Below is a list of the
   possible formats for the ^object definition.
   
       ^object = n
       ^object = n<BYTES>
       ^object = "filename.ext"
       ^object = ("filename.ext",n)
       ^object = ("[dirlist]filename.ext",n)
       ^object = ("filename.ext",n<BYTES>)
       ^object = ("[dirlist]filename.ext",n<BYTES>)
   
       where:
   
       n is the starting record or byte number of the object, counting from
       the beginning of the file (record 1, byte 1);
   
       <BYTES> indicates that the number given is in units of bytes;
   
       filename is a maximum 27-alphanumeric upper-case character file name,
       ext is the 3 upper-case character file extension;
   
       dirlist is an upper-case, period-delimited path-list of parent
       directories, beginning at the directory level below the archive volume
       root directory, that specifies the object file directory (used only
       when the object is not in the same directory as the label file).
   
   Detached label files have variable length lines with an end-of-line
   designator consisting of a carriage-return character followed by a line-
   feed character.  This allows the files to be read by the MacOS, Microsoft
   Windows, and Unix operating Systems.
   
Catalog File Format
   
   Catalog files (suffix.CAT) exist in the root and CATALOG directories.  They
   are formatted in an object-oriented structure consisting of sets of
   "keyword = value" declarations.
   
   
4. Volume Contents
   
   The files in this volume are organized in one top-level directory with
   several subdirectories. The following outline shows the structure and
   content of these directories. In the table, directory names are enclosed
   in square brackets ([]), upper-case letters indicate actual directory or
   file names, and lower-case letters indicate the general form of a set
   of directory or file names.
   
FILE/DIRECTORY                     DESCRIPTION

Top-level directory
   |
   |- AAREADME.HTM     Describes volume contents, organization and disk
   |                   use (HTML format).
   |
   |- AAREADME*.JPG    Graphics files used by AAREADME.HTM.
   |
   |- AAREADME.TXT     Describes volume contents, organization and disk
   |                   use (ASCII text).
   |
   |- AAREADME.LBL     PDS detached label file describing AAREADME.HTM and
   |                   associated graphics files.
   |
   |- ERRATA.TXT       A cumulative listing of comments and updates concerning
   |                   all standard products on all CRaTER volumes in the
   |                   volume set published to date.
   |
   |- VOLDESC.CAT      Description of the contents of this volume.
   |
   |- [INDEX]              Contains index tables for the data products on
   |    |                  this volume.
   |    |
   |    |- INDXINFO.TXT    Description of the contents of this directory.
   |    |
   |    |- INDEX.LBL       Detached PDS label describing contents of
   |    |                  INDEX.TAB.
   |    |
   |    |- INDEX.TAB       Index table file for the CRaTER data products in
   |                       the current volume.
   |
   |- [DOCUMENT]           Contains various documents that facilitate the
   |    |                  understanding of the datasets included on this
   |    |                  volume.
   |    |
   |    |- DOCINFO.TXT     Description of the contents of this directory.
   |    |
   |    |- GAPS_HK.TAB     Cumulative listing of missing housekeeping packets
   |    |                  for all days up to and including the days of the
   |    |                  current volume.
   |    |
   |    |- GAPS_HK.LBL     PDS detached label file describing contents of
   |    |                  GAPS_HK.TAB.
   |    |
   |    |- GAPS_PRI.TAB    Cumulative listing of missing primary science
   |    |                  packets for all days up to and including the days
   |    |                  of thecurrent vlomue.
   |    |
   |    |- GAPS_PRI.LBL    PDS detached label file describing contents of
   |    |                  GAPS_PRI.TAB.
   |    |
   |    |- GAPS_SEC.TAB    Cumulative listing of missing secondary science
   |    |                  packets for all days up to and including the days
   |    |                  of the current vlomue.
   |    |
   |    |- GAPS_SEC.LBL    PDS detached label file describing contents of
   |    |                  GAPS_SEC.TAB.
   |    |
   |    |- MODE_CHANGES.LBL  PDS detached label file describing contents of
   |    |                    MODE_CHANGES.TAB.
   |    |
   |    |- MODE_CHANGES.TAB  Cumulative listing of instrument mode changes
   |    |                    since launch.
   |    |
   |    |- VOLSIS.HTM      The SPDR and Archive Volume SIS (HTML format).
   |    |
   |    |- VOLSIS.LBL      PDS detached label file describing contents of
   |    |                  VOLSIS.HTM and associated graphics files.
   |    |
   |    |- VOLSYS*.JPG     Graphics files used by VOLSYS.HTM
   |    |
   |    |- VOLSIS.PDF      The SPDR and Archive Volume SIS (pdf format)..
   |
   |- [CATALOG]            This directory contains the catalog files.
   |    |
   |    |- CATINFO.TXT     Description of the contents of this directory.
   |    |
   |    |- CRAT_INST.CAT   Information about the CRaTER instrument.
   |    |
   |    |- INSTHOST.CAT    Information about the LRO spacecraft.
   |    |
   |    |- MISSION.CAT     Information about the LRO mission.
   |    |
   |    |- PERSON.CAT      Contact information for CRaTER team members.
   |    |
   |    |- PROJ_REF.CAT    LRO Project references mentioned in other
   |    |                  catalog files.
   |    |
   |    |- CRAT_L0_DS.CAT  Description of the CRaTER Level 0 (raw EDR) data
   |    |                  files.
   |    |
   |    |- CRAT_L1_DS.CAT  Description of the CRaTER Level 1 (CDR) data 
   |    |                  files.
   |    |
   |    |- CRAT_L2_DS.CAT  Description of the CRaTER Level 2 (RDR) data 
   |    |                  files.
   |    |
   |    |- CRAT_REF.CAT    CRaTER references mentioned in other catalog
   |                       files.
   |
   |- [DATA]               This directory contains the Level 0, Level 1, and
   |    |                  Level 2 CRaTER data products, organized into
   |    |                  subdirectories by year.
   |    |
   |    |- DATAINFO.TXT    Description of the contents of this directory.
   |    |
   |    |- [yyyy]              Directory containing CRaTER data product files 
   |         |                 for year "yyyy".
   |         |
   |         |- [yyyyddd]      Directory containing data products for day
   |             |             "ddd" of year "yyyy".
   |             |
   |             |- CRAT_yyyyddd_Vnn_LOG.TXT    Pipeline processing log file
   |             |
   |             |- CRAT_L0_HK_yyyyddd_Vnn.DAT  Level 0 housekeeping
   |             |                              product (raw EDR)
   |             |
   |             |- CRAT_L0_HK_yyyyddd_Vnn.LBL  PDS detached label describing
   |             |                              CRAT_L0_HK_yyyyddd_Vnn.DAT
   |             |
   |             |- CRAT_L0_PRI_yyyyddd_Vnn.DAT Level 0 primary science
   |             |                              product (raw EDR)
   |             |
   |             |- CRAT_L0_PRI_yyyyddd_Vnn.LBL PDS detached label describing
   |             |                              CRAT_L0_PRI_yyyyddd_Vnn.DAT
   |             |
   |             |- CRAT_L0_SEC_yyyyddd_Vnn.DAT Level 0 secondary science
   |             |                              product (raw EDR)
   |             |
   |             |- CRAT_L0_SEC_yyyyddd_Vnn.LBL PDS detached label describing
   |             |                              CRAT_L0_SEC_yyyyddd_Vnn.DAT
   |             |
   |             |- CRAT_L1_HK_yyyyddd_Vnn.TAB  Level 1 housekeeping
   |             |                              product (ASCII table)
   |             |
   |             |- CRAT_L1_HK_yyyyddd_Vnn.LBL  PDS detached label describing
   |             |                              CRAT_L1_HK_yyyyddd_Vnn.DAT
   |             |
   |             |- CRAT_L1_PRI_yyyyddd_Vnn.TAB Level 1 primary science
   |             |                              product (ASCII table)
   |             |
   |             |- CRAT_L1_PRI_yyyyddd_Vnn.LBL PDS detached label describing
   |             |                              CRAT_L1_PRI_yyyyddd_Vnn.DAT
   |             |
   |             |- CRAT_L1_SEC_yyyyddd_Vnn.TAB Level 1 secondary science
   |             |                              product (ASCII table)
   |             |
   |             |- CRAT_L1_SEC_yyyyddd_Vnn.LBL PDS detached label describing
   |             |                              CRAT_L1_SEC_yyyyddd_Vnn.DAT
   |             |
   |             |- CRAT_L2_HK_yyyyddd_Vnn.TAB  Level 2 housekeeping
   |             |                              product (ASCII table)
   |             |
   |             |- CRAT_L2_HK_yyyyddd_Vnn.LBL  PDS detached label describing
   |             |                              CRAT_L2_HK_yyyyddd_Vnn.DAT
   |             |
   |             |- CRAT_L2_PRI_yyyyddd_Vnn.TAB Level 2 primary science
   |             |                              product (ASCII table)
   |             |
   |             |- CRAT_L2_PRI_yyyyddd_Vnn.LBL PDS detached label describing
   |             |                              CRAT_L2_PRI_yyyyddd_Vnn.DAT
   |             |
   |             |- CRAT_L2_SEC_yyyyddd_Vnn.TAB Level 2 secondary science
   |             |                              product (ASCII table)
   |             |
   |             |- CRAT_L2_SEC_yyyyddd_Vnn.LBL PDS detached label describing
   |                                            CRAT_L2_SEC_yyyyddd_Vnn.DAT
   |
   |- [CALIB]              This directory contains a copy of the instrument's
   |    |                  calibration plan and reports describing calibration
   |    |                  and performance results.
   |    |
   |    |- CALINFO.TXT     Description of the contents of this directory.
   |    |
   |    |- CRAT_CAL_PLAN.HTM    CRaTER instrument calibration plan document
   |    |                       (HTML format).
   |    |
   |    |-CALPLAN*.JPG          Graphics used by CRAT_CAL_PLAN.HTM.
   |    |
   |    |- CRAT_CAL_PLAN.LBL    PDS detached label file describing
   |    |                       CRAT_CAL_PLAN.HTM and associated graphics
   |    |                       files.
   |    |
   |    |- CRAT_CAL_PLAN.PDF    CRaTER instrument calibration plan document
   |                            (Acrobat format).
   |
   |
   |- [BROWSE]            This directory contains daily CRaTER data browse
   |    |                 plots (if available), split into 100-day intervals.
   |    |
   |    |- BROWINFO.TXT   Description of the contents of this directory.
   |    |
   |    |- [yyyyd00]           Subdirectories containing browse plots (if
   |         |                 available) for 100-day interval from day "d00"
   |         |                 through "d99" of year "yyyy".
   |         |
   |         |- yyyyddd.LBL    PDS detached label describing yyyyddd.PDF.
   |         |
   |         |- yyyyddd.PDF    Browse plots (if available) summarizing CRaTER
   |                           measurements, configuration, and operating 
   |                           parameters for day "ddd" of year "yyyy", from
   |                           the Level 2 data in "DATA/yyyy/yyyyddd".
   |
   |- [LABEL]                  This directory contains format files (*.FMT)
   |    |                      describing the contents of the CRaTER Level 0,
   |    |                      Level 1, and Level 2 data product files in the
   |    |                      DATA subdirectories.
   |    |
   |    |- LABINFO.TXT         Description of the contents of this directory.
   |    |
   |    |- CRAT_L0_HDR.FMT     Bit-level description of Level 0 packet
   |    |                      headers.
   |    |
   |    |- CRAT_L0_HK.FMT      Bit-level description of Level 0 housekeeping
   |    |                      records.
   |    |
   |    |- CRAT_L0_PRI.FMT     Bit-level description of Level 0 primary
   |    |                      science records.
   |    |
   |    |- CRAT_L0_SEC.FMT     Bit-level description of Level 0 secondary
   |    |                      science records.
   |    |
   |    |- CRAT_L1_HK.FMT      Byte-level description of Level 1 housekeeping
   |    |                      records.
   |    |
   |    |- CRAT_L1_PRI.FMT     Byte-level description of Level 1 primary
   |    |                      science records.
   |    |
   |    |- CRAT_L1_SEC.FMT     Byte-level description of Level 1 secondary
   |    |                      science records.
   |    |
   |    |- CRAT_L2_HK.FMT      Byte-level description of Level 2 housekeeping
   |    |                      records.
   |    |
   |    |- CRAT_L2_PRI.FMT     Byte-level description of Level 2 primary
   |    |                      science records.
   |    |
   |    |- CRAT_L2_SEC.FMT     Byte-level description of Level 2 secondary
   |    |                      science records.
   |    |
   |    |- LROHDR.FMT          Bit-level description of 64-byte Level 0 file
   |                           headers.
   |
   |- [SOFTWARE]               This directory contains the source code for
        |                      software useful for reading and writing CRaTER
        |                      Level 0, Level 1, and Level 2 data product files.
        |
        |- SOFTINFO.TXT        Description of the contents of this directory.
        |
        |- PIPE2.ZIP           CRaTER Pipeline software.
        |
        |- PIPE2.LBL           PDS detached label describing PIPE2.ZIP contents.
        |
        |- ZIPINFO.TXT         PDS information about compressed zip archives.


5. Recommended DVD Drives and Driver Software
   
   Not applicable for electronic delivery.
   
   
6. Errata and Disclaimer
   
   A list of anomalies and errors is maintained in the file ERRATA.TXT at the
   root directory of this volume.
   
   Known data uncertainties and limitations are described in the Level 0
   (CRAT_L0_DS.CAT), Level 1 (CRAT_L1_DS.CAT), and Level 2 (CRAT_L2_DS.CAT)
   catalog files located in the CATALOG subdirectory.
   
   Although considerable care has gone into making this volume, errors are
   both possible and likely. Users of the data are advised to exercise the
   same caution as they would when dealing with any other unknown data set.
   
   Reports of errors or difficulties would be appreciated. Please contact one
   of the individuals listed below.
   
   
7. Contact Information
   
   For questions concerning this volume set, data products, and documentation,
   contact
   
       Michael J. Golightly
       University of New Hampshire
       Institute for the Study of earth, Oceans, and Space
       Morse Hall
       8 College Rd
       Durham, NH  03824-2600
       Phone:  +1 603-862-1256
       E-mail:  m.j.golightly@unh.edu
   
       Harlan E. Spence
       University of New Hampshire
       Institute for the Study of earth, Oceans, and Space
       Morse Hall
       8 College Rd
       Durham, NH  03824-2600
       Phone:  +1 603-862-4449
       E-mail:  Harlan.Spence@unh.edu
   
   For questions concerning PDS standards and usage, contact
   
       Steven P. Joy
       University of California
       6855 Slichter Hall
       Los Angeles, CA 90095-1567 USA
       Phone:  +1 310-825-3506
       E-mail:  sjoy@igpp.ucla.edu