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 ) 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 ^object = "filename.ext" ^object = ("filename.ext",n) ^object = ("[dirlist]filename.ext",n) ^object = ("filename.ext",n) ^object = ("[dirlist]filename.ext",n) where: n is the starting record or byte number of the object, counting from the beginning of the file (record 1, byte 1); 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