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.;
2014-10-20, D. Kazden (PPI): Edited to apply to a single LRO CRaTER dataset;
2014-12-23, PPI: Updated to accommodate new release;"
OBJECT = TEXT
PUBLICATION_DATE = 2014-12-23
NOTE = "AAREADME.TXT describes this dataset."
END_OBJECT = TEXT
END
LRO-L-CRAT-2-EDR-RAWDATA-V1.0
2009-06-29T00:00:00.000 to 2014-09-30T23:59:56.76
1. Introduction
This volume contains Level 0 data products for CRaTER measurements made
during the LRO mission. The products contain 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 file 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
LROCRA_9000 Top-level directory
|
|- AAREADME.TXT Describes volume contents and organization (ASCII text).
|
|- ERRATA.TXT A current cumulative listing of comments and updates
concerning all standard products in this dataset.
|
|- 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.LBL PDS detached label file describing contents of
| | VOLSIS.HTM and associated graphics files.
| |
| |- 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.
| |
| |- LRO_CRAT_INST.CAT Information about the CRaTER instrument.
| |
| |- LRO_INST_HOST.CAT Information about the LRO spacecraft.
| |
| |- LRO_MISSION.CAT Information about the LRO mission.
| |
| |- LRO_PERSON.CAT Contact information for CRaTER team members.
| |
| |- LRO_PROJ_REF.CAT LRO Project references mentioned in other
| | catalog files.
| |
| |- LRO_CRAT_L0_DS.CAT Description of the CRaTER Level 0 (raw EDR)
| | data files.
| |
| |- LRO_CRAT_REF.CAT CRaTER references mentioned in other catalog
| files.
|
|- [DATA] This directory contains the 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_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
| |
| |- LROHDR.FMT Bit-level description of
| 64-byte Level 0 file headers.
|
|- [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.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).
| |
|- [LABEL] This directory contains format files (*.FMT)
| | describing the contents of the CRaTER 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.
|
|- [SOFTWARE] This directory contains the source code for
| software useful for reading and writing CRaTER
| 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.
|
|- 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
(LRO_CRAT_L0_DS.CAT), Level 1 (LRO_CRAT_L1_DS.CAT), or Level 2
(LRO_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 or 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
|