CRaTER
Cosmic Ray Telescope for the Effects of Radiation
Description of Volume LROCRA_2XXX
LRO CRaTER Mission Data
March 15, 2010
|
|
CRaTER
|
|
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 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) Rev E . A copy of the document in Acrobat™ format is located on this volume as file VOLSIS.PDF in the DOCUMENT directory.
Not applicable-- these products are being delivered to PDS electronically.
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_*.TABand 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 files with the "*.TXT" extension 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 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".
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 = "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 files (extension "*.CAT")exist in the root and CATALOG directories. They are formatted in an object-oriented structure consisting of sets of "keyword = value declarations.
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 an actual directory or file name, and lower-case letters indicate the general form of a set of directory or file names.
LROCRA_2XXX
|
|- AAREADME.HTM Describes volume contents, organization and disk use. (HTML
| format)
|
|- AAREADME.TXT Describes volume contents, organization and disk use. (ASCII
| text)
|
|- AAREADME*.JPG Graphics files used by AAREADME.HTM.
|
|- 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 disk.
| |
| |- INDXINFO.TXT Description of the contents of this directory.
| |
| |- INDEX.TAB Index table file for the CRaTER data products in the
| | current volume.
| |
| |- INDEX.LBL Detached PDS label describing contents of INDEX.TAB
|
|- [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 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 the current
| | volume.
| |
| |- GAPS_PRI.LBL PDS detached label 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
| | volume.
| |
| |- GAPS_SEC.LBL PDS detached label describing contents of GAPS_PRI.TAB.
| |
| |- MODE_CHANGES.LBL PDS detached label 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).
| |
| |- VOLSYS*.JPG Graphics files used by VOLSYS.HTM.
| |
| |- VOLSIS.LBL PDS detached label file describing contents of VOLSIS.HTM
| | and associated graphics files.
| |
| |- VOLSIS.PDF Acrobat™ version of the SPDR and Archive Volume SIS.
|
|- [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 PDS data set catalog description of the CRaTER Level 0
| | (raw EDR) data files.
| |
| |- CRAT_L1_DS.CAT PDS data set catalog description of the CRaTER Level 1
| | (CDR) data files.
| |
| |- CRAT_L2_DS.CAT PDS data set catalog 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 CRaTER 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_PRIyyyyddd_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 describing CRAT_CAL_PLAN.HTM and
| | associated graphics files.
| |
| |- CRAT_CAL_PLAN.PDF CRaTER instrument calibration plan document in
| 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.
| |
| |- [yyyyd] 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.
Not applicable for electronic delivery.
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.
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 617-358-4864
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