PDS_VERSION_ID = PDS3 PRODUCT_ID = "AAREADME.TXT" RECORD_TYPE = STREAM RELEASE_ID = 0001 REVISION_ID = 0000 OBJECT = TEXT PUBLICATION_DATE = 2007-11-30 NOTE = "N/A" END_OBJECT = TEXT END MARSIS Raw Data Archive 1. Introduction a. Science data content b. Conformance to PDS standards c. Document or institutional references for additional science information 2. Volume format a. Computer systems that can access the volume b. International standards to which the volume conforms 3. File formats a. Data record formats b. Specifications for specialized files (e.g., Postscript) c. Description of PDS objects, pointers, etc. 4. Volume contents a. Directory structure of the volume 5. Recommended CD-ROM drives (if applicable) a. Driver descriptions and notes for all appropriate computer platforms 6. Errata (if applicable) a. Known errors, cautionary notes, disclaimers, etc. b. Reference to the ERRATA.TXT file on the volume or online 7. Contacts a. Names and addresses of people or organizations to contact for questions concerning science data , technical support, data product generation and labelling, etc. Whom to Contact for Information MEX Project Scientist: A. Chicarro email: achicarr@rssd.esa.int phone: (31) 71 565 3613 fax: (31) 71 565 4697 smail: Postbus 290, 2200 AG Noordwijk, NL For any PSA related issues: PSA Helpdesk: e-mail: psahelp@rssd.esa.int MARS EXPRESS MARSIS EXPERIMENT DATA RECORD ARCHIVE VOLUME 1. Overview This volume contains Level 1b data collected during the primary mission of the Mars Express spacecraft, that is the instrument scientific telemetry correlated with the auxiliary information needed to locate observations in space and time. Level 1b data users are mainly radar scientists interested in redoing the entire processing of the received signal, while the fact that unprocessed subsurface sounding echoes do not show any obvious indication of subsurface interfaces makes these data of little use for geologists. In the DATA directory, data are divided into a number of subdirectories, each containing data collected over ten orbits. These subdirectories are named so as to make clear which data products they contain and when such data were collected. Their name is in the form pppoooX, where ppp is a group of letter denoting the kind of data product contained in the subdirectory (EDR for Experiment Data Records), and ooo are the digits common to numbers of the orbits in which data were acquired: for example, the subdirectory named EDR188X contains all files of Level 1b data collected from orbit 1880 to orbit 1889. For a complete description of each data product, the user is referred to the DOCUMENT/MARSIS_EAICD.TXT text on the archive volume. Data products archived in this volume are copies of files produced by the MARSIS team. Errors and anomalies in the original data and comments about the archive are noted in the ERRATA.TXT file. 2. Archive Volume - Concept of Delivery Within the Planetary Science Archive (PSA) the archive volume represents an online delivery. This might be not fully compliant with the PDS standard 3.6, but the PSA itself can produce fully compatible archive volumes after the end of the mission. Deliveries are based on the concept of a release and a revision. This concept allows the delivery of experiment data without the delivery of all supplementary information, that has already been delivered at the first initial delivery of a fully PDS compatible Archive Volume, containing the VOLDESC.CAT file and all necessary CATALOG, DOCUMENT, INDEX, DATA, etc directories and their content. Labels used in the MARSIS Experiment Data Record Archive are specifically related to the concept of release and revision. A data set release (or volume release) contains data from a well-defined period of time and is identified by the VOLUME_RELEASE_ID (4 digit number) : [0001:9999]. A volume release is made of at least one revision: the initial revision. The initial revision contains the initial data of a data set release and is identified by a VOLUME_REVISION_ID equal to 0000. A subsequent revision of the data set release (updated files, supplementary files, deleted files) would need the value of the VOLUME_REVISION_ID to be incremented by one. A release catalog object need to be included in the catalog object to fully describe the release. The release object contains all keyword-value pairs that are necessary to identify a revision within a release. The DESCRIPTION part of the DATA_SET_RELEASE object will contain the full history of the release including all previous revisions. Each revision of a release is added in the release catalog object and all necessary information about this revision is given by a REVISION object. 3. File Formats This section provides a brief description of the files and data objects available on the MARSIS archive volume: text files, PDF files, PNG files and PDS objects. A complete description of each file format is available in the DOCUMENT/MARSIS_EAICD.TXT text on the archive volume. Text and detached PDS label files have stream or fixed-length record format, and line lengths of must of 80 characters, including a carriage return (ASCII 13) at the end of the record. This allows the files to be read by MS-DOS/ Windows, Unix, and VMS operating systems. Documents that contain formatting and figures that cannot be rendered as ASCII text are provided as ASCII text with separate PNG figures or PDF files. The PDF (Portable Document Format) file is a proprietary format of Adobe Systems. Incorporated that can be viewed using the free Acrobat Reader software. A PDS label provides descriptive information about the associated file. PDS labels in the MARSIS Experiment Data Record Archive conform to PDS standards [Planetary Science Data Dictionary, 2001; PDS Standards Reference, 2003]. For examples of the PDS labels used with each type of data product, see the DOCUMENT/MARSIS_EAICD.TXT text on the archive volume. In general, the PDS label is an object-oriented structure consisting of sets of 'keyword = value' declarations; the object to which the label refers is denoted by a statement of the form: ^object = location in which the carat character (^, also called a pointer in this context) indicates where to find the object. In an attached label, the location denotes 4. File Naming Convention All data product files are named using the same file naming convention. File names are built by a concatenation of three-letter components separated by underscore characters ("_"). Each component provides one type of information on the content of the file. Components are concatenated in the following order, although not all of them are necessarily present in any given file name: File type Operative mode Instrument state Data form Data product Orbit Number Extension File type refers to the type of data file: MARSIS data products can consist of up to two files each, the first of which contains the data proper, and is called a "frame file" (the corresponding component is FRM), while the second, called a "geometry file" (GEO in short) contains geometric information used to locate observations in space and time. Operative modes, instrument states, data forms and data product types are described in the DOCUMENT/MARSIS_EAICD.PDF document, while the orbit number is a four-digit number identifying an orbit according to rules defined by the Mars Express mission control. File extension defines the format of data contained in the file: the extension is usually ".DAT", denoting that the file contains a binary table object. 4. Applicable Software MARSIS data products can be read by the PDS software NASAView, which Reads a PDS label and displays the associated image or table. NASAView is free software and is available for several computer platforms. NASAView is available for free from the Planetary Data System, but the source code is not available. Platforms supported are LINUX, SOLARIS, Windows and Power MAC. The executable of the program can be downloaded following links found at http://pds.jpl.nasa.gov/tools/software_download.cfm 5. Volume Contents Files on the MARSIS EDR archive volume are organized into a series of subdirectories below the top-level directory. See the xxxxINFO.TXT files in each directory for specific information on the files in the directory. The following table shows the generalized structure and contents of the MARSIS archive volumes. Top-level ROOT | |- AAREADME.TXT The file you are reading | |- ERRATA.TXT Description of known anomalies and error present | on the volume. | |- VOLDESC.CAT Description of the contents of the volume | in a PDS format for the PDS Catalog | | |- [DATA] A directory containing the data + associated | label files | | | |- DATAINFO.TXT Description of files in this directory | | | | | | | |-[EDRXXXX] A directory containing file(s) *DAT, *.LBL | | | collected during the MARS nominal phase | | | | |- [CATALOG] A directory containing information about the data set | | | |- CATINFO.TXT Description of files in this directory | | | |- DATASET.CAT PDS catalogue object for the MARSIS | | data set | | | |- RELEASE.CAT PDS catalogue object for current | | release and revision status of the | | data set | |- MISSION.CAT PDS catalogue object for the mission | | | |- INSTRUMENT_HOST.CAT Description of the Mars Express | | spacecraft | | | |- INSTRUMENT.CAT PDS catalogue object for the | | instrument | | | | | |- PERSON.CAT Listing of the people involved | | in the production of this archive | | volume | |- REFERENCE.CAT List of pertinent references. | | | |- SOFT.CAT Description of the software included | | on the volume. | |- [INDEX] A directory containing an index of data files. | | | |- INDXINFO.TXT Description of files in this directory. | | | | | |- INDEX.TAB PDS table listing all files in the | | DATA directory for the | | corresponding release and revision | |- INDEX.LBL PDS label to describe INDEX.TAB | | | |- GEO_MARS.TAB PDS table, listing geometric | | properties of all data products | | in the DATA directory for the | | corresponding release and revision | |- GEO_MARS.LBL PDS label, to describe GEO_MARS.TAB | |-[LABEL] The LABEL directory contains include (*.FMT) | | files for the Mars Express MARSIS | | Experiment Data Record archive volume | | | | | |- [DOCUMENT] A directory containing information documents. | | | |- DOCINFO.TXT Description of files in this | | directory. | | | |- MARSIS_EAICD.PDF The MARSIS EAICD in PDF format | |- MARSIS_EAICD.TXT The MARSIS EAICD in TXT format | |- MARSIS_EAICD.LBL PDS label for MARSIS_EAICD.PDF and | | MARSIS_EAICD.TXT | | | |- MARSIS_PSD.PDF MARSIS Packet Structure Definition, | | Issue 6, LABEN TL 16927, | | 3 February 2003[AD04] | |- MARSIS_PSD.LBL PDS label that describes for | | MARSIS_PSD.PDF | | | |- MARSIS_PT.PDF MARSIS DES Parameters Table, | | Issue 3, LABEN TL 18546 [AD03] | |- MARSIS_PT.LBL PDS label that describes for | | MARSIS_PT.PDF | | | |- MARSIS_OST.PDF MARSIS DES Operation Sequence Table | | Issue 1, LABEN TL 19392, | | 29 January 2003 [AD02] | |- MARSIS_OST.LBL PDS label that describes for | | MARSIS_OST.PDF | | | |- MARSIS_FUM.PDF MARSIS Flight User Manual, | | Issue 3, INFOCOM ID-MAR-0008-INF, | | 18 December 2003 [AD01] | |- MARSIS_FUM.LBL PDS label that describes for | | MARSIS_FUM.PDF 6. Whom to Contact for Information For questions concerning this data set: Contact GIOVANNI PICARDI (Principal Investigator) or RAFFAELLA NOSCHESE (Archive Manager). See personnel information in PERSON.CAT catalog. For questions related to the mission and the Planetary Science Archive of ESA: MEX Project Scientist: A. Chicarro email: achicarr@rssd.esa.int phone: (31) 71 565 3613 fax: (31) 71 565 4697 smail: Postbus 290, 2200 AG Noordwijk, NL For any PSA related issues: PSA Helpdesk: e-mail: psahelp@rssd.esa.int