PDS_VERSION_ID = PDS3 RECORD_TYPE = STREAM OBJECT = TEXT PUBLICATION_DATE = 2017-05-12 INTERCHANGE_FORMAT = ASCII NOTE = "N/A" END_OBJECT = TEXT END MErcury Surface, Space ENvironment, GEochemistry and Ranging (MESSENGER) Mercury Dual Imaging System (MDIS) Map Projected Multispectral Reduced Data Record (MDR) Archive 1. Introduction This archive contains data acquired by the MErcury Surface, Space ENvironment, GEochemistry and Ranging (MESSENGER) Mercury Dual Imaging System (MDIS) instrument. 2. File Formats This section describes the format of the kinds of filed contained on the MDIS Archive Volumes. Data that comprise the Archive will be formatted in accordance with Planetary Data System standards. 2.1. Document File Formats Document files with the .TXT suffix exist in the ROOT, INDEX, CATALOG, DOCUMENT, and CALIB directories, and in the BROWSE and EXTRAS directories if they are present. They are ASCII files which may have embedded PDS labels. Lines in a .TXT file end with a carriage return character (ASCII 13) and a line feed character (ASCII 10). This allows the files to be readable under various operating systems. Some documents in the DOCUMENT and CALIB directories contain formatting and figures that cannot easily be rendered as ASCII text. Therefore each document is given in PDF format. PDF (Portable Document Format) is a proprietary format of Adobe Systems Incorporated that is frequently used for distributing documents. Adobe offers free software, Acrobat Reader, for viewing PDF files. Some type of ASCII text versions of these documents will also be included, possibly using HTML or XML, in order to meet the PDS requirement that documents must be archived as ASCII text. 2.2. Tabular File Format Tabular files (.TAB suffix) exist in the INDEX and CALIB directories, and EXTRAS directory if it is present. Tabular files are ASCII files formatted for direct reading into many database management systems on various computers. All fields are separated by commas. (Character fields are padded with spaces to keep quotation marks in the same columns of successive records.) Character fields are left justified, and numeric fields are right justified. The 'start byte' listed in the labels indicate the starting position in bytes of each field in a record; the field length 'bytes' does not include the commas between fields, or quotation marks for ASCII strings. 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 text file with embedded line delimiters on those that don't. Every MDIS tabular file is described by a detached PDS label with the same name as the data file it describes, and the extension .LBL. For example, the file INDEX.TAB is accompanied by the detached label file INDEX.LBL in the same directory. 2.3. PDS Label Format All data files in the MDIS MDR archive have attached PDS labels. For examples of PDS labels, see the Data Product SIS in the DOCUMENT directory. A PDS label provides descriptive information about the associated file. The PDS label is an object-oriented structure consisting of sets of 'keyword=value' declarations. The object to which the label refers (e.g. IMAGE, TABLE, etc.) 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 embedded 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 = ("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 the up to 36 character, alphanumeric upper-case file name, ext is the 3 character upper-case file extension Lines of text in detached labels end with a carriage return character (ASCII 13) and a line feed character (ASCII 10). This allows the files to be readable under various operating systems. 2.4. Catalog File Format Catalog files (suffix .CAT) exist in the ROOT and CATALOG directories. They are text files formatted in an object-oriented structure consisting of sets of 'keyword=value' declarations, so that they are readable by humans and by software. 2.5. Science Data File Formats For more information about the format and content of the data products, see the discussions in the MDIS Data Product SIS located in the DOCUMENT directory. 3. Archive Contents Files in this archive are organized into a series of subdirectories below the top-level directory. The archive organization and the contents of each directory are described below. Top-level Directory ------------------- AAREADME.TXT The file you are currently reading. ERRATA.TXT This text file content describes known anomalies and errors along with additional comments and updates concerning the archive volume. VOLDESC.CAT This text file contains a description of the volume contents as a PDS catalog object. It is a required file on PDS archive volumes. INDEX Directory --------------- The INDEX directory contains PDS index files for this archive. An index file is an ASCII table with each record (or line) in the table containing information about a single data product in archive. Files in the Index directory are provided to help the user locate products on the archive volume. INDXINFO.TXT Identifies and describes the function of each file in the index subdirectory. This includes a description of the structure and contents of the index table and usage notes. INDEX.TAB The image index file is organized as a table: there is a row for each map tile image on the volume; the columns contain the image and mapping parameters. Information includes map projection type, resolution, and map extents in latitude and longitude. INDEX.LBL Detached PDS label for INDEX.TAB that describes its organization and contents. MD5.TAB The checksum table. The checksum table is a listing of all files in the archive (with the exception of the checksum table itself) that gives the MD5 checksum (message digest) for the file and the full path including file name. It is generated by the commonly available "MD5Deep" utility. This file is useful as a manifest for the archive and for data integrity assurance. MD5.LBL Detached PDS label for MD5.TAB that describes its organization and contents. MDR Directory -------------- The MDR directory contains the 8-color Map Projected Multispectral RDR (MDR) data set. It consists of a mosaicked global color map of 8-color image sets, as reflectance corrected to i = 30, e = 0, and g = 30 deg. sampled at a scale of 64 pixels per degree, compiled from images taken as a part of the global 8-color map campaign described in section 2.3.1.3. Each of 54 map tiles, defined geographically in the same manner as the BDRs, is composed of 8 bands corresponding to 8 of the 11 WAC filters. Versions 0, 1, and 2 of the map also contain 5 additional bands representing "backplane" data as follows: (a) observation id for each image set, (b) MDR metric, a metric used to determine the stacking order of component images (see section 2.5.2.3), and (c) solar incidence angle, (d) emission angle, and (e) phase angle for the 750-nm image in the set. Versions 0, 1, and 2 are uncontrolled, projected onto an ellipsoidal model of Mercury, and photometrically corrected using a Hapke photometric model with parameters optimized to lower solar incidence angles (and different from parameters used in map products containing higher-incidence angle data). Version 3 of the map, delivered one year after the end of orbital operations, is compiled differently. Instead of the value from any single image being used at a particular pixel location in a given wavelength band, the value used is the average from all of the images at that location where criteria for image scale, photometric geometry, and detector temperature are met. The averaging approach minimizes artifacts of time-variable instrument calibration. The 9 backplanes are redefined, and contain (a) the count of 8-color image sets at each location, and (b-j) for each wavelength band of corrected reflectance, the standard deviation to the average value. In addition, version 3 is controlled using version 1 DDRs (where image control uses NAC and WAC G-filter images), and projected onto a global digital elevation model. It uses a Kaasalainen-Shkuratov photometric model, whose parameters are the same for any given wavelength band across all MESSENGER end-of-mission map data products. For the south polar region only, there is a redundant tile having lower spatial resolution that eliminates coverage gaps present in the nominal version of the tile. Version 4, delivered two years after the end of orbital operations, is similar to version 3 except that its map projection uses version 2 DDRs (where image control is based on WAC G-filter images only), resulting in less blur during averaging of overlying images. The MDR version 4 dataset has 6 special case maps with different parameters and file naming than the other maps. In Mercury charts H01 and H03, there are additional higher resolution maps with "128PPD" in the file name which provide higher resolution for a limited area using only images with resolution better than 500 m/pixel. The H15 chart has an additional version (also present in version 3) with more complete polar coverage using lower resolution images to 2700 m/pixel, with "_2700_" in the file name. See the CDR/RDR data product SIS in the DOCUMENT directory for a more detailed description of the MDRs, the mapping campaigns, and definitions of the i, e, and g values. DOCUMENT Directory ------------------ The DOCUMENT directory contains documentation to help the user understand and use the archive data. DOCINFO.TXT Identifies and describes the function of each file in the document directory. MDIS_CDR_RDRSIS.DOC Software Interface Specification for the CDR/RDR data products as a Microsoft Word document. MDIS_CDR_RDRSIS.PDF Software Interface Specification for the CDR/RDR data products as an Adobe PDF document. MDIS_CDR_RDRSIS.HTM Software Interface Specification for the CDR/RDR data products as an HTML document. MDIS_CDR_RDRSIS.LBL PDS label for MDIS_CDR_RDRSIS.PDF and MDIS_CDR_RDRSIS.HTM. PDSDD.FUL The PDS Data Dictionary that includes definitions of all keywords used in MESSENGER data labels, including MESSENGER-specific keywords (i.e. the MESSENGER Local Data Dictionary). This is a text file that is human-readable and also usable as input to PDS label validation software. CATALOG Directory ----------------- The files in the Catalog directory provide a top-level understanding of the mission, spacecraft, instrument, and data set. The files in this directory become part of the PDS Catalog to provide background information for the user searching for data. Their format and contents are further specified in the PDS Standards Reference. CATINFO.TXT Identifies and describes the function of each file in the catalog directory. MDIS_MDR_DS.CAT MDR data set description. INSTHOST.CAT Description of the MESSENGER spacecraft for the PDS catalog. MDIS_NAC_INST.CAT, MDIS_WAC_INST.CAT Description of the MDIS NAC and WAC instruments for the PDS catalog. MDR_MAP.CAT MDIS data set map projection information for equatorial region. MDR_POLAR_MAP.CAT MDIS data set map projection information for polar region. MISSION.CAT Description of the MESSENGER mission for the PDS catalog. PERSON.CAT List of personnel associated with the MESSENGER mission. REF.CAT Catalog objects' citation list for the PDS catalog. TARGET.CAT Contains the definition for all MDIS targets (objects of interest that the instrument observed). CALIB Directory --------------- The CALIB directory contains the calibration files used in the processing of the raw data to create the CDRs or needed to use the data products on the volume. The file CALINFO.TXT describes the files in the CALIB directory. The MDR volume includes a subset of the full set of calibration files and explanatory text that is included with the Experiment Data Record (EDR) and Calibrated Data Record (CDR) archives. CALINFO.TXT Describes the contents of the directory. CALIB/SUPPORT Directory ----------------------- This directory contains characterizations of the instrument that are not part of the calibration process per se, but were used to derive the calibration files that are used. Please see the CALINFO.TXT file and the section on the CALIB directory in the MDIS CDR/RDR SIS document for descriptions of the specific files. EXTRAS Directory ---------------- The EXTRAS directory contains other materials that the user may find helpful, but that are beyond the scope of the required elements of the archive. The MDR archive contains a BROWSE directory within the EXTRAS directory (EXTRAS/BROWSE) that contains viewable PNG format image representations of the primary data products and associated metadata. Also in the EXTRAS directory are shapefiles that record the MDIS image coverage area of Mercury during the orbital mission. See the file EXTRINFO.TXT for more information about the files in this directory. 4. Whom to Contact for Information For questions concerning this volume set, contact: PDS - Flagstaff Imaging Node United states Geological Survey 2255 North Gemini Drive Flagstaff, AZ 86001 Electronic mail address: pdsmgr@usgs.gov For general information related to the PDS, contact: Planetary Data System, PDS Operator M/S 202-101 Jet Propulsion Laboratory 4800 Oak Grove Drive Pasadena, CA 91109-8099 (818) 354-4321 WWW Site: http://pds.jpl.nasa.gov/ E-mail: pds_operator@jpl.nasa.gov 5. Cognizant Persons This archive volume designed and produced at Applied Coherent Technology, Inc. in Herndon, VA by Christopher Hash, Raymond Espiritu, and Erick Malaret, and at the Applied Physics Laboratory, Laurel, MD by Alan Mick, Scott Murchie, Louise Prockter, Michele Gannon and Mike Reid. Please see the CATALOG/PERSON.CAT file for a current contact list.