PDS_VERSION_ID          = PDS3
RECORD_TYPE             = STREAM
OBJECT                  = TEXT
  PUBLICATION_DATE      = 2015-12-04
  NOTE                  = "Updated 2017-08-01 R15
                           Updated 2018-03-16 R17"
END_OBJECT              = TEXT

END

                              AAREADME.TXT
                             August 1, 2014 

==============================================================================
INTRODUCTION
==============================================================================

This archive contains Reduced Data Record (RDR) instrument data acquired by 
the Chemistry and Micro-Imaging (ChemCam) instrument on the Mars Science 
Laboratory rover. Data from both the LIBS (Laser Induced Breakdown 
Spectrometer) and RMI (Remote Micro-Imager) components of ChemCam are in
this archive.

==============================================================================
VOLUME SET INFORMATION
==============================================================================

ChemCam RDR data are stored in an archive volume having the directory 
structure illustrated below.  Raw ChemCam data products (EDRs) are stored in 
a separate archive volume not described here.

   root
    |
    |- AAREADME.TXT                Introduction to the archive (this file)
    |- ERRATA.TXT                  Release notes and errata for the archive
    |- VOLDESC.CAT                 Description of the contents of the archive
    |
    |- BROWSE
    |     |
    |     |- BROWINFO.TXT          Description of the BROWSE directory
    |     |
    |     |- SOLnnnnn               Directory of browse data for sol nnnnn
    |           |
    |           |- QCHEMCAM_nnnnn_type_sclk.JPG, .LBL
    |                              Browse version of product acquired on sol
    |                              nnnnn, with inst LIBS1, LIBS2 or RMI, at 
    |                              spacecraft clock time sclk
    |- CALIB
    |     |
    |     |- CALINFO.TXT             Description of the CALIBRATION directory
    |     |- MSL_CCAM_LIBS_CALIB.CSV LIBS Calibration Data
    |     |- MSL_CCAM_LIBS_CALIB.LBL PDS label describing
    |     |                          MSL_CCAM_LIBS_CALIB.CSV
    |     |- EARTH_2_MARS_CORR.CSV   Correction factor for Earth to Mars.
    |     |- EARTH_2_MARS_CORR.LBL   PDS label describing
    |     |                          EARTH_2_MARS_CORR.CSV.
    |     |- ICA_COMPONENTS.CSV      Oxide LOADINGS used to calculate ICA 
    |     |                          compositions.
    |     |- ICA_COMPONENTS.LBL      PDS label describing
    |     |                          ICA_COMPONENTS.CSV.
    |     |- REGRESSION.CSV          Regressions laws used to calclulate ICA 
    |     |                          compostions.
    |     |- REGRESSION.LBL          PDS label describing
    |     |                          REGRESSION.CSV.
    |     |- STD_IDX_2_FILE_LUT.CSV  Lookup table to index file name of data.
    |     |- STD_IDX_2_FILE_LUT.LBL  PDS label describing
    |     |                          STD_IDX_2_FILE_LUT.CSV
    |     |- environment            Environment data collected from
    |              |                ie. CLEANROOM,TVAC, CALIB_2015, etc
    |              |- std           Standard or Sample
    |                  |
    |                  |- *CCS.CSV Clean Calibrated Spectra
    |                  |           coma seperated values
    |                  |- *CCS.LBL PDS labels for CCS.CSV file  
    |
    |- CATALOG
    |     |
    |     |- CATINFO.TXT           Description of the CATALOG directory
    |     |- CCAM_LIBS_INST.CAT    ChemCam LIBS instrument description
    |     |- CCAM_LIBS_RDR_DS.CAT   ChemCam LIBS RDR data set description
    |     |- CCAM_PERSON.CAT       Relevant ChemCam personnel
    |     |- CCAM_REF.CAT          References mentioned in CCAM*.CAT files
    |     |- CCAM_RMI_INST.CAT     ChemCam RMI instrument description
    |     |- CCAM_RMI_RDR_DS.CAT    ChemCam RMI RDR data set description
    |     |- MSL_INSTHOST.CAT      MSL rover description 
    |     |- MSL_MISSION.CAT       MSL mission description
    |     |- MSL_REF.CAT           References mentioned in MSL*.CAT files
    |
    |- DATA
    |     |
    |     |- MOC                   Directory of concatenated LIBS MOC products
    |         |
    |         |- *.CSV             ChemCam LIBS MOC data products 
    |         |- *.LBL             PDS labels describing data products
    |     |- TEA                   Directory of concatenated LIBS TEA products
    |         |
    |         |- *.CSV             ChemCam TEA MOC data products 
    |         |- *.LBL             PDS labels describing data products
    |     |- TEC                   Directory of concatenated LIBS TEC products
    |         |
    |         |- *.CSV             ChemCam LIBS TEC data products 
    |         |- *.LBL             PDS labels describing data products
    |      
    |     |- SOLnnnnn              Directory of data acquired on sol nnnnn
    |              |               
    |              |- *.CSV        ChemCam LIBS data products
    |              |- *.TIF        ChemCam RMI data products
    |              |- *.TAB        ChemCam PSV data products
    |              |- *.LBL        PDS labels describing data products
    |
    |- DOCUMENT
    |     |
    |     |- DOCINFO.TXT           Description of the DOCUMENT directory
    |     |- GEOMETRIC_CM.TXT      Description of MSL geometric camera model.
    |     |- MSL_CAMERA_SIS.PDF    ChemCam Software Interface Specification
    |     |- MSL_CAMERA_SIS.LBL    PDS label for CAMERA_SIS.*
    |     |- CHEMCAM_ARCHSIS_PDF   ChemCam RDR Archive SIS 
    |     |- CHEMCAM_ARCHSIS.LBL   PDS label for CHEMCAM_ARCHSIS.*
    |     |- PDSDD.FUL             PDS Data Dictionary
    |     |- PDSDD.LBL             PDS label for PDSDD.FUL
    |     |- MSL_CCAM_OBS.CSV      Summary information for ChemCam products
    |                              in a comma-delimited ASCII table.
    |     |- MSL_CCAM_OBS.LBL      PDS label for MSL_CCAM_OBS.CSV
    |     |- WAVE_CAL_COEFFS.TAB   ChemCam spectrometer wavelength calibration
    |                              coefficients sol 0-499
    |     |- WAVE_CAL_COEFFS.LBL   PDS label describing use of 
    |                              wave_cal_coeffs.lbl
    |     |- WAVE_CAL_COEFFS_500.TAB  ChemCam spectrometer wavelength
    |                              calibration coefficients all sols
    |     |- WAVE_CAL_COEFFS_500.LBL  PDS label describing use of 
    |                              wave_cal_coeffs_500.lbl
    |     |-CCAM_DEFAULT_WAVE.TAB - Calibrated wavelength for PSV spectra
    |     |-CCAM_DEFAULT_WAVE.LBL - PDS label describing CCAM_DEFAULT_WAVE.TAB
    |     |-GAIN_MARS.TAB - Instrument Response gain values
    |     |-GAIN_MARS.LBL - PDS label describing GAIN_MARS.TAB 
    |
    |- EXTRAS
    |     |
    |     |- EXTRINFO.TXT          Description of the EXTRAS directory
    |     |- DN2ENGUNITS_LUT.PDF   Lookup tables for the conversion
    |                              of ChemCam data numbers to physical values.
    |     |- RMI_MOSAICS           Directory containing RMI MOSAICS
    |         |
    |         |- *.PNG             ChemCam RMI MOSAICS
    |         |- *.LBL             PDS labels describing RMI MOSAICS
    |     |- RMI_CONTOURS_IN_MCAM_IMAGES  Directory with RMI Contour MOSAICS 
    |         |
    |         |- *.JPG             ChemCam RMI CONTOUR MOSAICS
    |         |- *.LBL             PDS labels describing RMI Contour MOSAICS
    |
    |- INDEX
          |
          |- INDXINFO.TXT          Description of the INDEX directory
          |- LIBSINDEX.TAB         Table of LIBS data products in the archive
          |- LIBSINDEX.LBL         PDS label describing LIBSINDEX.TAB
          |- RMIINDEX.TAB          Table of RMI data products in the archive
          |- RMIINDEX.LBL          PDS label describing RMIINDEX.TAB
     
    

==============================================================================
FILE FORMAT
==============================================================================

ChemCam LIBS data files are stored as ASCII tables with file names ending in
CSV. The tables are in comma-separated-value format, meaning that fields in
a row are separated by commas, and the fields are not padded with spaces to
be the same length in each row. Hence the lengths of rows in a table 
may vary. These files may be read in a text editor and are easily loaded
into spreadsheet programs.

Each table is accompanied by a detached PDS label with the same name but the 
extension LBL, which describes the format and content of the table.
PDS labels are ASCII text files that may be read in a text editor.

ChemCam RMI images and mosaics are binary data files with file
names ending in IMG. Each image has a detached PDS label, and may also have
one or more non-PDS labels embedded in the file. See the MSL Camera & LIBS
EDR/RDR Software Interface Specification (CAMERA_SIS.PDF) in the DOCUMENT
directory for details.

All text files in the archive, including PDS labels, are delimited with 
carriage-return (ASCII 13) line-feed (ASCII 10) pairs at the end of the line.

PDS requires documentation to be archived as ASCII text for long-term 
readability. However, some documents contain figures and other elements that 
cannot be rendered as ASCII text, and these are given in PDF format for the
user's convenience.

==============================================================================
COGNIZANT PERSONNEL
==============================================================================

ChemCam RDR data products are generated and assembled into archive volumes by 
the MSL ChemCam Science Team and delivered to Planetary Data System 
Geosciences Node. The Geosciences Node releases the archives to the public 
according to the MSL Project release schedule.

ChemCam Science Team Archive Representatives: Bruce Barraclough, 
barraclough@psi.edu, Planetary Science Institute, and Dorothea DeLapp, 
ddelapp@lanl.gov, Los Alamos National Laboratory.

PDS Geosciences Node Representative: Susan Slavney, Susan.Slavney@wustl.edu, 
Washington University in St. Louis.