PDS_VERSION_ID = PDS3
LABEL_REVISION_NOTE = "2012-02-12, PPI Node;"
RECORD_TYPE = STREAM
INSTRUMENT_HOST_NAME = "MARS SCIENCE LABORATORY"
INSTRUMENT_NAME = "RADIATION ASSESSMENT DETECTOR"
OBJECT = TEXT
PUBLICATION_DATE = 2013-08-08
NOTE = "Description of volume MSLRAD_1001"
END_OBJECT = TEXT
END
Volume MSLRAD_1001: MSL RAD Experiment Data
1. Introduction
This volume contains EDR data (Experiment Data Record) from the Radiation
Assessment Detector (RAD) instrument aboard the Mars Science Laboratory
(MSL) rover, better known as Curiosity. The data files contain radiation
measurements taken during interplanetary cruise and the surface mission.
The EDR data are NASA Level 0 data that mirror the raw instrument
data obtained from telemetry.
The volume also contains calibration data and documentation useful for
the interpretation of the data.
For more information about the data and about this volume, refer to the
documentation in the DOCUMENT and CATALOG directories of the volume.
2. Volume Format
These EDR data products are being delivered electronically to PDS. They
are archived in a single volume which will continue to grow as the
mission progresses.
3. File Formats
Data File Format
The EDR files will be of two types: ESD (science data) and EHP (High Priority
science data). The file naming convention is explained in the Software
Interface Specification (SIS) document in the DOCUMENT directory of the volume.
This file naming convention is consistent with file naming for other MSL
instruments.
The EDR files are in binary format. Each file begins with housekeeping and
message data. These may be followed by science data and pulse height analysis
(PHA) data.
Each data file is described by a detached PDS label as described below. The
fields in the data files are described by PDS format files (*.FMT), which are
referenced in the labels. The format files are in the LABEL directory of
this volume.
Document File Format
Most of the documentation for this volume resides in the DOCUMENT and
CATALOG directories. The CATALOG directory contains PDS catalog files
(*.CAT) providing information about the spacecraft, instrument, data set,
personnel associated with the experiment, and relevant literature
references. The catalog files are in ASCII format. The DOCUMENT
directory contains the Software Interface Specification (SIS) document
describing the EDR data, and the Volume SIS describing the volume structure.
Documentation files also exist in most of the top-level directories
ASCII information files (*INFO.TXT) exist in many of the directories on
this disk; these files describe the directory contents.
ASCII text files ion this volume have records delimited by a carriage
return character followed by a line feed character. This line ending
makes the file easier to read on a variety of operating systems.
PDS Label Format
All data and tabular files in this volume have associated PDS labels.
A PDS label 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 36-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 makes the files easy to read on a variety of
different 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 root-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.
Root directory
|
|
|- AAREADME.TXT Describes volume contents, organization and disk
| use (ASCII text). The file you are now reading.
|
|- ERRATA.TXT A cumulative listing of errata and other comments
| pertaining to the files in the volume.
|
|- 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 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.
| |
| |
| |- RAD_EDR_SIS.HTM The SIS for the RAD EDR data set, in human-readable
| | HTML format.
| |
| |- RAD_EDR_SIS.PDF The SIS for the RAD EDR data set, in PDF format.
| |
| |- RAD_EDR_SIS.LBL PDS detached label for the data set SIS.
| |
| |- VOLSIS.HTM The volume SIS for this volume, in human-readable
| | HTML format.
| |
| |- VOLSIS.PDF The volume SIS for this volume, in PDF format.
| |
| |- VOLSIS.LBL PDS detached label for the volume SIS.
| |
| |
|- [CATALOG] This directory contains the catalog files.
| |
| |- CATINFO.TXT Description of the contents of this directory.
| |
| |- RAD_INST.CAT Information about the RAD instrument.
| |
| |- MSL_INSTHOST.CAT Information about the MSL spacecraft.
| |
| |- MSL_MISSION.CAT Information about the MSL mission.
| |
| |- RAD_PERSON.CAT Contact information for RAD team members and
| | other relevant personnel.
| |
| |- MSL_REF.CAT Literature references relevant to MSL, including
| | references mentioned in other catalog files.
| |
| |- RAD_REF.CAT Literature references relevant to RAD, including
| | references mentioned in other catalog files.
| |
| |- RAD_EDR_DS.CAT Description of the RAD EDR data files.
| |
|
|- [CRUISE_DATA] Contains the EDR data files from the cruise phase of
| | the mission.
| |
| |- [yyyy] Contains data and label files for year yyyy.
| |
|
|- [DATA] Contains the EDR data files from the surface mission.
| |
| |
| |- [ddddd_eeeee_RELEASEn] Contains data and label files from sols ddd
| | through eee, which make up data release n
| (n = 1, 2, ...)
|
|
|- [CALIB] This directory contains calibration information that
| | is relevant to the understanding and use of the data.
| |
| |- CALINFO.TXT Description of the contents of this directory.
| |
|
|
|- [LABEL] This directory contains format files (*.FMT)
| | describing the contents of the EDR data files.
| |
| |- LABLINFO.TXT Description of the contents of this directory.
| |
| | (Note: Each of the following format files begins
| | with a comment that points to the data that the
| | format file describes.)
| |
| |- CCSDS2_HEADER.FMT
| |
| |- CCSDS_HEADER.FMT
| |
| |- DO_BIST.FMT
| |
| |- FRAME_HEADER.FMT
| |
| |- OBS_INFO.FMT
| |
| |- PHA_DATA.FMT
| |
| |- RAD_DIAG_HK.FMT
| |
| |- RAD_DIAG_RAE.FMT
| |
| |- RAD_DIAG_SYS.FMT
| |
| |- RAD_EDR_COMMAND_REPLY.FMT
| |
| |- RAD_EDR_DIAG_EEPROM.FMT
| |
| |- RAD_EDR_DIAG_HK.FMT
| |
| |- RAD_EDR_DIAG_MESSAGES.FMT
| |
| |- RAD_EDR_DIAG_RAE.FMT
| |
| |- RAD_EDR_DIAG_SYS.FMT
| |
| |- RAD_EDR_DIAG_TABLE_XSUM.FMT
| |
| |- RAD_EDR_DO_BIST_FRAME.FMT
| |
| |- RAD_EDR_SCI_FRAME.FMT
| |
| |- RAE_HK.FMT
| |
| |- SCIENCE_DATA.FMT
| |
| |- SCIENCE_OBSERVATION.FMT
|
5. 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 data set
catalog file 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.
Use of these data is at the user's own risk. The PDS, the PPI Node, and
their employees and contractors assume no legal responsibility for the
contents of this volume.
7. Contact Information
For questions concerning this volume set, data products, and documentation,
contact
Dr. Scot Rafkin
Asst. Director, Dept. of Space Studies
Southwest Research Institute
Boulder, CO 80302 USA
Phone: +1 720-240-0116
E-mail: rafkin@boulder.swri.edu
For questions concerning PDS standards and usage, contact
Dr. 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
|