2001 Mars Odyssey
Martian Radiation Environment Experiment (MARIE)
DVD Series
Volume 1 (ODMA_0001)
Planetary Data System
|
Links to sections of this document: |
Links to data and documentation: |
|
|
|
|
|
|
|
|
|
|
|
This disk contains a subset of the data from the Martian Radiation Environment Experiment (MARIE) aboard the 2001 Mars Odyssey spacecraft, submitted to the Planetary Data System (PDS).
Users are encouraged to provide comments back to the PPI Node of the PDS if errors or omissions are found either in data or in documentation. Please send comments by e-mail or U.S. mail to PDS Operator as defined at the end of this document.
This volume contains MARIE data from the periods of 2001-04-23 to 2001-08-12 and 2002-03-13 to 2002-12-31. All data files are stored in the "DATA" branch of the directory tree. Raw (REDR) data are stored in the RAW_DATA subdirectory of DATA; reduced (RDR) data are stored in the REDUCED subdirectory; and ancillary data are stored in the ANCIL subdirectory.
The document BEGINNERS_GUIDE.TXT in the EXTRAS directory provides a quick-start introduction to the disk for new users unfamiliar with the use of PDS data volumes.
Documentation for this volume is located in the CATALOG and DOCUMENT directories. In CATALOG, each data set is documented as part of the archive (*DATASET.CAT); so are the MARIE instrument (INST.CAT), the Mars Odyssey mission (MISSION.CAT) and spacecraft (INSTHOST.CAT), the MARIE team and other personnel (PERSON.CAT), and useful literature references (REF.CAT). Among the documents in the DOCUMENTdirectory is the Volume Software Interface Specification (VOLSIS.*), which provides detailed information about the disk's nature, contents and structure. Some documents are presented in multiple formats, indicated by filenames having the same name with different extensions.
All data files on this DVD-R are described by detached PDS labels (.LBL) and format files (.FMT). Metadata are stored as text files with the data. Information on the particular form of metadata used in the PDS catalog can be found in the CATALOG directory.
This DVD-R is the first volume of the ODMA_0xxx sequence. These volumes contain MARIE data from the 2001 Mars Odyssey mission.
This DVD-R is organized into a hierarchical directory structure. The disk is formatted according to the UDF Bridge standard, which incorporates both UDF and ISO 9600 file systems and can be read on a wide variety of platforms. This volume does not contain any Extended Attribute Records (XAR). Thus, VAX/VMS users may have some problems accessing files on this volume.
This section describes the volume structure. Below is a tree diagram of the DVD-R, followed by a description of the directory function and key files in each directory.
ODMA_0xxx (root directory) | |- AAREADME.TXT Describes volume contents, organization and DVD-R | use (this file). | |- ERRATA.TXT Describes known deficiencies or caveats in the data | on this DVD-R. | |- VOLDESC.CAT High-level description of DVD-R contents. | | |- [CATALOG] Information on data sets and how they are processed | and produced. Also contains information regarding | Mars Odyssey, the MARIE instrument, personnel | involved, and relevant literature. | |- [DATA] Contains all data in a branching tree structure of | | subdirectories. | | | |- [ANCIL] Ancillary data (part of the raw dataset). | | | Subdirectories contain the following kinds | | | of housekeeping and engineering data, organized | | | into one-month sub-subdirectories: | | | | | |- [BOARD_POWER] Board power consumption | | | | | |- [BOARD_TEMPS] Board temperatures | | | | | |- [BOARD_VOLTAGES] Board voltages | | | | | |- [DETECTOR_TEMPS] Detector temperatures | | | | | | | | |- [RAW_DATA] Raw (REDR) data, organized into one-month | | subdirectories. | | | |- [REDUCED] Reduced (RDR) data, organized into one-month | | subdirectories. | | |- [DOCUMENT] Contains documents describing the data on the | volume. These include VOLSIS.*, which gives | detailed information about the volume. | (Documents are presented in multiple formats, | identical in content except for features | impractical to represent in ASCII versions.) | |- [EXTRAS] Contains files useful, but not required, for the | end user's understanding of the data. On this disk, | may contain software for raw data reduction. | |- [GEOMETRY] Contains a table of spacecraft trajectory data | and SPICE kernel files. | |- [INDEX] Contains a table of contents for all files located | on the DVD-R and the volume series to date. |
The data files on this volume include both binary and ASCII text files. All data files are described by detached PDS labels. A detached label file has the same name as the data file that it describes, but with the extension .LBL. For example, a file named 98097.STS would be accompanied by the detached label file 98097.LBL in the same directory. File names within this archive comply with the "8.3" convention to conform with the ISO-9660 standard.
All ASCII documents, detached PDS labels, and text files are stream format files, with a carriage return (ASCII 13) and a line feed character (ASCII 10) at the end of the record. This allows the files to be read by MacOS, DOS, Windows, UNIX, and VMS operating systems. UNIX system users will see an unnecessary carriage return character (^M) at the end of each line. Mac users will see an unnecessary line feed character (^J) at the start of each line.
ASCII tabular data files (*.TAB) are formatted so that they may be read directly into many database management systems (DBMS) or spreadsheet programs on various computers. All fields are of fixed length and are separated by white space (blank characters or commas). Character fields are left justified, and numeric fields are right justified. The "start byte" and "bytes" values listed in a PDS label do not include the white space between fields. The records are of fixed length, and the last two bytes of each record contain the ASCII carriage return and line feed characters. This allows a table to be treated as a fixed length record file on computers that support this file type and as a normal text file on other computers.
The document, PDS label, and ASCII table files on this volume can be viewed with a Web browser. Note that to view these files, the browser may need to be configured to recognize files with extensions of .LBL and .TAB as text files.
PDS labels are object-oriented. The object to which the label refers (e.g., SERIES, TABLE, etc.) is denoted by a statement of the form:
^object = location
in which the caret character (^, also called a pointer in this context) indicates that the object starts at the given location. For an object in the same file as the label, the location is an integer representing the starting record number or byte of the object (the first record/byte in the file is 1). For an object located outside the label file, the location denotes the name of the file containing the object, along with the starting record or byte number. For example:
^SERIES = ("20903684.DAT", 3)
indicates that the SERIES object begins at record 3 of the file 20903684.DAT, in the same directory as the detached label file. Below is a list of the possible formats that use the ^object keyword.
^object = n
^object = n<BYTES>
^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 beginning of the file (record 1, byte 1); default is record number.
<BYTES> indicates that number given is in units of bytes.
filename upper-case file name.
ext upper-case file extension.
dirlist* period-delimited path-list of parent directories, in upper case, that specifies the object file directory (used only when the object is not in the same directory as the label file).
* All PDS labels on this volume are located in the same directory as the file they describe so this construct is not used here.
In cases where many files of the same format or structure are present, the structure description component is detached from the primary label. This minimizes repeating information which does not vary from file to file. In these cases, a format file (.FMT) contains the file structure information and the base label (.LBL) describes the parameters which generally do vary from file to file (number of records, file name, start/stop time, etc.). When a format file is used within the PDS label, the syntax is:
^STRUCTURE = filename
Example:
^STRUCTURE = "EDRHDR.FMT"
Syntactically, the contents of the format file can be inserted directly into the base label such that the entire file contents replace the single line ^STRUCTURE = filename.
There is a file called ERRATA.TXT found at the root level of this volume which contains a list of known deficiencies or caveats associated with data on this volume at the time this DVD-R was published. Any changes or errors that are found on this or any ODMA_0xxx DVD-R after the production of this volume can be found on the PPI Node errata Web page.
If you find an error on this disk, please report the error to the PDS Operator at the PPI Node of the PDS.
Internet pds_operator@igpp.ucla.edu
Telephone (310) 206-6073
U.S. Mail:
PDS Operator
c/o Dr. Raymond Walker
UCLA - IGPP
Los Angeles, CA 90095-1567
Only through support and feedback of the users of these data can an effective errata list be maintained.
A version of the software used for generating calibrated data from raw data may be included in the EXTRAS directory on this disk. (This software may not be present on all releases of the disk.)
The person most directly responsible for the construction of this DVD-R is Dr. Mark Sharlow. He was the data engineer at the time this disk was created and understands as much about the disk structure and data organization as anyone. Other PPI personnel who may be aware of issues related to this DVD-R include Mr. Steven Joy, the PPI Node Data Administrator, and Dr. Raymond Walker, the PDS/PPI Node manager. For questions or problems regarding this DVD-R, please contact the PPI PDS operator:
Internet: pds_operator@igpp.ucla.edu
Telephone: (310) 206-6073
U.S. Mail:
PDS Operator
c/o Dr. Raymond Walker
3845 Slichter Hall
UCLA - IGPP
Los Angeles, CA 90095-1567
For questions regarding PDS Standards or other disks available from the PDS, please contact PDS Operator at the PDS Central Node (at JPL):
Internet: pds_operator@jpl.nasa.gov
Telephone: (818) 354-4321
U.S. Mail:
Planetary Data System, PDS Operator
Jet Propulsion Laboratory
Mail Stop 202-101
4800 Oak Grove Dr.
Pasadena, CA 91109-8099
The PDS, and the Planetary Plasma Interactions (PPI) Node in particular, assume no legal liability for errors on this disk. All users are encouraged to verify the "correctness" of the data prior to submitting any publications or other work based on these data. Errors on this disk should be reported back to the PPI Node of the PDS through the ERRATA reporting procedures described above.