Download this file

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