PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM OBJECT = TEXT PUBLICATION_DATE = 2015-03-06 NOTE = "AAREADME.TXT describes this volume." END_OBJECT = TEXT END MESSENGER Energetic Particle and Plasma Spectrometer Uncalibrated and Calibrated Document Archive Prepared for the Planetary Plasma Interactions Node of the Planetary Data System ======================================================================== Introduction ======================================================================== This volume contains documentation for the MESSENGER Energetic Particle and Plasma Spectrometer (EPPS) uncalibrated, calibrated and derived data volume sets. There are four EPPS volumes: one for documentation, one for EDR data, one for CDR data and one for DDR data. This is the DOCUMENT volume, which contains the documentation, not the actual data. Note that the EPPS is made up of two instrument subsystems, the Fast Imaging Plasma Spectrometer (FIPS), and the Energetic Particle Spectrometer (EPS). Thus two data volumes are delivered, the FIPS and the EPS. In some cases one file will be relevant to both data sets, in which case the data set id for both are included in the one label. A complete description of the design of this volume is given in the EPPS EDR software interface specification, the EPPS CDR software interface specification and the EPPS DDR software interface specification. An electronic copy of these documents is located in the /DOCUMENT directory on the DOCUMENT volume. This volume is intended for the use of scientists and students in the study of the of the planet Mercury. The data may be used for research and publication. ======================================================================== Volume Format ======================================================================== The volume is organized into a hierarchical directory structure. It is transferred from the MESSENGER SOC to the Planetary Plasma Interactions Node via the TCP/IP File Transfer Protocol (FTP) and thus the physical characteristics of the final storage media are unknown to the SOC. The CATALOG directory on the DOCUMENT volume contains PDS documentation describing the mission, spacecraft, instrument, and data set. These include: MISSION.CAT MESSENGER mission description INSTHOST.CAT MESSENGER spacecraft description INSTRUMENT.CAT EPPS instrument description EPPSEPSDATASET.CAT EPPS EPS uncalibrated data set description EPPSFIPSDATASET.CAT EPPS FIPS uncalibrated data set description EPPSEPSDATASET_CDR.CAT EPPS EPS calibrated data set description EPPSFIPSDATASET_CDR.CAT EPPS FIPS calibrated data set description EPPSEPSDATASET_DDR.CAT EPPS EPS derived data set description EPPSFIPSDATASET_DDR.CAT EPPS FIPS derived data set description REF.CAT MESSENGER mission reference information, including EPPS references. PERSON.CAT MESSENGER mission personnel contact information including EPPS personnel, identified as such. Note that the science data are not located on this, the DOCUMENT volume, but instead under the DATA directory on the DATA volume. The INDEX directory on the DATA volume contains a listing of all of the data products included on it. Additional information on volume organization is given in the EDR SIS, CDR SIS and DDR SIS (described above), and in the 'Volume Contents' section below. ======================================================================== File Formats ======================================================================== Catalog files (extension .CAT) on this volume are provided in ASCII format. Text files and detached label files contain 80-byte fixed-length ASCII records, with a carriage-return character (ASCII 13) in the 79th byte and a line-feed character (ASCII 10) in the 80th byte. This format allows the files to be read by MacOS, DOS, UNIX and VMS operating systems. Note that while both label and catalog files are ASCII, some operating systems will not recognize the .LBL and .CAT extensions as ASCII types. It may be necessary to either remap these extensions as ASCII in the system or text browser, or else to open the files from within the text browser. ======================================================================== Volume Set Information ======================================================================== The MESSENGER EPPS volume sets (EPPS_1XXX) include the following volumes: Volume ID. Contents ----------------- ----------------------------------------------------- MESSEPPS_EDR MESSENGER EPPS uncalibrated data. This volume contains EPPS data at Earth, Venus and Mercury over the interval 2004-216 (3 Aug) to the end of the mission. MESSEPPS_CDR MESSENGER EPPS calibrated data. This volume contains EPPS data at Earth, Venus and Mercury over the interval 2004-216 (3 Aug) to the end of the mission. MESSEPPS_DDR MESSENGER EPPS derived data. This volume contains EPPS data at Earth, Venus and Mercury over the interval 2004-216 (3 Aug) to the end of the mission. MESSEPPS_DOC This volume. MESSENGER EPPS documentation. ======================================================================== Volume Contents ======================================================================== Directory Structure and Contents for EPPS Document Archive Volume The following illustration shows the directory structure overview for the EPPS Document Archive Volume. This volume contains the EPPS documentation and any additional files required for the volume to be compliant with PDS standards. It does not contain the actual data, which is contained on the DATA volumes. The content of the volumes are expected to be updated with periodic releases according to the schedule found in the MESSENGER Data Management and Archiving Plan (DMAP). In addition, the DOCUMENT volume may be updated on an ad-hoc basis by the EPPS instrument team in order to release new and evolving information to the public. Note that in some deliveries, the products that belong in a particular directory may not yet be available. If a directory has no products in a particular delivery, it will not appear in the archive directory tree, nor in the following directory structure overview. Empty directories will not be delivered. For a full description of the entire potential directory structure, consult the SIS documents in the document volume. Directory Structure Overview ___________________________________|______________________ | | | _________|___________ | | | Directory Contents: Directory This is the top-level directory of the data volume. The following are files contained in the root directory. AAREADME.TXT: (This file) General information file. Provides users with information about the MESSENGER EPPS data products. Directs user to other documents on the volume containing more detailed information. VOLDESC.CAT: PDS file containing the VOLUME object. This gives a high level description of the contents of the volume. Information includes: production date, producer name and institution, volume ID, etc. ERRATA.TXT: Text file for identifying and describing errors and/or anomalies found in the current volume, and possibly previous volumes of a set. Any known errors for the associated volume will be documented in this file. MD5.TAB: Provides the MD5 checksum (message digest) for each file in the archive, with the exception of the MD5.TAB file itself. MD5.LBL: Detached PDS label for MD5.TAB. DIRECTORY This will contain the calibration tables needed to analyze the EPPS EDR, CDR and DDR data. CALINFO.TXT Brief description of the directory contents and naming conventions. EPPS_EPS_EDR2CDR: Describes the conversion of EPPS EDRs to CDRs for the EPS instrument. EPPS_FIPS_EDR2CDR: Describes the conversion of EPPS EDRs to CDRs for the FIPS instrument. FIP*.TAB: The FIPS energy per charge tables, as described in the EPPS CDR SIS, located in the DOCUMENT directory of this volume. DIRECTORY This subdirectory contains the catalog object files for the entire volume. The following files are included in the catalog subdirectory. CATINFO.TXT: Identifies and describes the function of each file in the catalog directory. EPPSEPSDATASET.CAT: Describes the general content of the EPS uncalibrated data set and includes information about the duration of the mission and the person or group responsible for producing the data. EPPSFIPSDATASET.CAT: Describes the general content of the FIPS uncalibrated data set and includes information about the duration of the mission and the person or group responsible for producing the data. EPPSEPSDATASET_CDR.CAT: Describes the general content of the EPS calibrated data set and includes information about the duration of the mission and the person or group responsible for producing the data. EPPSFIPSDATASET_CDR.CAT: Describes the general content of the FIPS calibrated data set and includes information about the duration of the mission and the person or group responsible for producing the data. EPPSEPSDATASET_DDR.CAT: Describes the general content of the EPS derived data set and includes information about the duration of the mission and the person or group responsible for producing the data. EPPSFIPSDATASET_DDR.CAT: Describes the general content of the FIPS derived data set and includes information about the duration of the mission and the person or group responsible for producing the data. NOTE: The DATASET.CAT catalog has been replicated as six separate catalog files, EPPSEPSDATASET.CAT, EPPSFIPSDATASET.CAT, EPPSEPSDATASET_CDR.CAT, EPPSFIPSDATASET_CDR.CAT, EPPSEPSDATASET_DDR.CAT, and EPPSFIPSDATASET_DDR.CAT. The files EPPSEPSDATASET.CAT and EPPSFIPSDATASET.CAT are essentially identical as are the corresponding CDR and DDR files, but each has a different data set id, one for the EPS detector and one for the FIPS detector. INSTRUMENT.CAT: Describes physical attributes of the EPPS instrument and provides relevant references to published literature. INSTHOST.CAT: Describes the MESSENGER spacecraft. MISSION.CAT: Describes the scientific goals and objectives of the MESSENGER program. It also identifies key people and institutions. PERSON.CAT: Lists and provides contact information for the people involved in the MESSENGER mission, including those involved with EPPS. REF.CAT: Contains the reference objects. These reference additional documents that may be useful to the person using the EPPS data. < DOCUMENT > Directory This subdirectory contains the documentation that will be needed in order to understand and analyze the EDR, CDR and DDR data volumes. The documents will be separated into individual subdirectories according to the document type. The document types are not restricted to the four shown in the graphical depiction of the directory structure. There will be as many document types as needed to categorize each document. The following file is included in the subdirectory. DOCINFO.TXT: Identifies and describes the function of each file in the DOCUMENT directory. EDR_SIS/: Directory containing the EDR SIS document in various formats. CDR_SIS/: Directory containing the CDR SIS document in various formats. DDR_SIS/: Directory containing the DDR SIS document in various formats. ======================================================================== Related PDS Products ======================================================================== ======================================================================== Errata ======================================================================== Every effort has been made to ensure that the data and documentation are of the best possible quality. However, mistakes are inevitable. The Planetary Plasma Interactions (PPI) Node of the PDS will maintain an online list of ERRATA where errors and updates are documented. Should any user of this product find an error on this volume, please report the error to the (PPI) Node so that the finding can be made public. All users are encouraged to verify the correctness of the data prior to submitting any publications or other work based on these data. 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 it was published. If you find an error on this disk, please report the error to the PDS Operator at the PPI Node of the PDS at the address or numbers listed under contacts below. ======================================================================== Contacts ======================================================================== For questions concerning these data products and documentation, contact: Planetary Plasma Interactions Node UNIVERSITY OF CALIFORNIA, LOS ANGELES INST. OF GEOPHYSICS AND PLANETARY PHYSICS 6707 GEOLOGY LOS ANGELES, CA 90095-1567 USA (310) 206-6073 WWW Site: http://pds-ppi.igpp.ucla.edu Electronic mail address: pds_operator@igpp.ucla.edu For questions regarding PDS Standards or other archive volumes 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 A list of personnel in the MESSENGER EPPS team that were involved in the production of this volume is given in /CATALOG/PERSON.CAT on the DOCUMENT volume. The PDS, and the Planetary Plasma Interactions 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 volume should be reported back to the PPI Node of the PDS through the ERRATA reporting procedures described above.