THEMIS DATA ARCHIVE 1. Overview This volume contains THEMIS data products generated from observations acquired by the Thermal Emission Imaging System (THEMIS) on Mars Odyssey 2001 (ODY). The imaging system is comprised of a three-mirror anastigmat telescope in a rugged enclosure, a visible/infrared beamsplitter, a silicon focal plane for visible detection, and a microbolometer for infrared detection. A calibration flag provides thermal calibration and a DC restore capability; it will also be used to protect the detectors from unintentional direct illumination from the Sun when the instrument is not in use. Infrared data is collected in 9 wavelengths centered from 6.6 to 15.0 microns at 100 meter per pixel resolution; the 6.6 micron band is collected twice to result in a 10 band image. Visible data is collected in 5 spectral bands at a resolution of 18 meters per pixel. The THEMIS data products are archived in two separate, but related volume sets. Data products that maintain the camera registration (i.e. in raw raster order as collected) are available in the THEMIS Standard Products volume set; data products that have been spatially registered to the Martian surface are available in the THEMIS Projected Products volume set. The THEMIS Standard Products volumes (USA_NASA_PDS_ODTSDP_100XX) include products from the following datasets: DATA_SET_ID CONTENTS DESCRIPTION ----------------------- ---------------------------------------------- ODY-M_THM-2-IREDR-v1.0 (EDR) Raw infrared records ODY-M_THM-2-VISEDR-v1.0 (EDR) Raw visible records ODY-M_THM-3-IRRDR-v1.0 (RDR) Calibrated infrared records ODY-M_THM-3-VISRDR-v1.0 (RDR) Calibrated visible records ODY-M_THM-3-IRBTR-v1.0 (BTR) Infrared brightness temperature records ODY-M_THM-3-VISABR-v1.0 (ABR) Visible apparent brightness records The THEMIS Projected Products volumes (USA_NASA_PDS_ODTGEO_200XX) include products from the following datasets: DATA_SET_ID CONTENTS DESCRIPTION ----------------------- -------------------------------------------- ODY-M_THM-5-IRGEO-v2.0 (GEO) Infrared geometric projected cubes ODY-M_THM-5-VISGEO-v2.0 (GEO) Visible geometric projected cubes ODY-M_THM-5-IRPBT-v2.0 (PBT) Infrared projected brightness records ODY-M_THM-5-VISALB-v2.0 (ALB) Visible projected albedo records (not applicable) (DCS) Infrared decorrelation images (not applicable) (RGB) Visible color browse images A brief overview of all products is presented below; for a complete description of each data product, the user is referred, as appropriate, to the DOCUMENT/SDPSIS text or the DOCUMENT/GEOMETRY text on the archive volume. Raw and calibrated thermal and visible records are stored as individual multi-spectral data QUBEs. The header of each raw thermal data QUBE contains a table of instrument diagnostic information sampled throughout the observation. Thermal and visible radiometrically calibrated records are stored as multi-spectral data QUBEs, similar to their raw sources. Thermal brightness temperature records (BTR) and visible apparent brightness records (ABR) are created from one band of the calibrated data and stored in IMAGE files with an attached PDS header. One browse image is provided for each thermal or visible observation, representing the data content available. The browse image is usually derived from the product with the highest processing level achieved for that observation, and is stored as a simple PNG image. Geometric projection (GEO) images of thermal or visible observations are stored as individual multi-spectral, ISIS data CUBEs with detached ASCII labels. Special derived products of thermal images may include projected brightness records (PBT), stored in IMAGE files, and decorrelation stretch (DCS) images, stored as simple PNG files. Special derived products of visible images may include projected albedo records (ALB), stored in IMAGE files, and false color composite (RGB) images, stored as simple PNG files. There is one browse image provided per projection and stored as a simple PNG image. Data products archived in this volume are copies of files released by the THEMIS team. Errors and anomalies in the original data and comments about the archive are noted in the ERRATA.TXT file on each volume. Supporting documentation and labels of standard products conform to the Planetary Data System (PDS) Standards, Version 3.4, Jet Propulsion Laboratory (JPL) document JPL D-7669 (6/15/2001) and the Planetary Science Data Dictionary, JPL document JPL D-7116, (7/27/2001). 2. DVD Volume Format The THEMIS archive DVD volumes have been formatted so that Sun and PC users may access the data. Specifically, the volumes have been formatted according to the ISO-9660 level 1 Interchange Standard. For further information, refer to the ISO-9660 Standard Document: RF# ISO 9660-1988, April 15, 1988. The DVD volumes do not contain any Extended Attribute Records (XAR). Thus, some VAX/VMS users may have problems accessing files on this volume. 3. File Formats This section provides a brief description of the files and data objects available on the THEMIS archive volumes; complete descriptions are available on each archive volume in the documents specified below. The THEMIS archive includes text files in the following formats: ASCII text files, PDF files, HTML files, PNG and JPG files. The THEMIS archive includes PDS data objects, such as LABELs, QUBEs, and IMAGEs, as well as ISIS data CUBE objects. All text and detached PDS label 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 MS-DOS/Windows, Unix, and VMS operating systems. Documents that contain formatting and figures that cannot be rendered as ASCII text are provided as HTML and PDF files. The hypertext file contains ASCII text plus hypertext markup language (HTML) commands that enable it to be viewed in a Web browser. The PDF (Portable Document Format) file is a proprietary format of Adobe Systems Incorporated a that can be viewed using the free Acrobat Reader software. PNG "browse" and JPEG "thumbnail" files are provided as a way to quickly view the image contents of a THEMIS observation. Standard image compression algorithms are used to convert the most highly calibrated image available for each thermal or visible observation. PNG files are binary with the data reduced to 8 bits per pixel; the compression algorithm is lossless. JPEG files are binary with the data reduced to 8 bits per pixel; the compression algorithm is lossy. A PDS label, whether embedded or detached from its associated file, provides descriptive information about the associated file. All PDS labels in the THEMIS Standard Data Archive conform to PDS standards [Planetary Science Data Dictionary, 2001; PDS Standards Reference, 2001]. For examples of the PDS labels used with each type of data product, see the DOCUMENT/SDPSIS text on each 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 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 = ("[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 the up to 8 character, alphanumeric upper-case file name, ext is the 3 character upper-case file extension, and dirlist is a 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). The list begins at the directory level below the root directory. '[dirlist]' may be omitted when the object being described is located either in the same directory as the detached label or in a subdirectory named LABEL that is located in a higher level of the directory tree (typically root itself). THEMIS raw and radiometrically calibrated records are stored in PDS SPECTRAL_QUBE objects as defined in the PDS Standards Reference [2002]. A SPECTRAL_QUBE is a three-dimensional array of binary data values in two spatial dimensions (samples and lines) and one spectral dimension (bands). THEMIS QUBEs may include one or more of the following: an attached PDS label, an ASCII HISTORY data object, a telemetry (TLM) table object, and SUFFIX data planes. THEMIS geometrically projected images are stored in ISIS CUBE objects which are similar to the PDS SPECTRAL_QUBE objects, but are not intended to conform to the PDS Standards Reference. An ISIS CUBE is a three-dimensional array of binary data values, with an attached label. A PDS compliant detached ASCII label is provided for each THEMIS GEO product. For a complete description of these products and examples of the PDS labels, see the GEOMETRY/GEOMETRY text on the archive volume. THEMIS thermal brightness temperature records, visible apparent brightness records, thermal projected brightness temperature records, and visible projected albedo records are all stored in PDS IMAGE objects as defined in the PDS Standards Reference [2002]. A THEMIS IMAGE is composed of a PDS header attached to a two-dimensional array of binary data values. 4. Applicable Software Any software package that can handle multi-spectral data sets can be used to display and analyze the THEMIS Standard Data Products. Large, THEMIS CUBE images with the ".gz" extension need to be uncompressed before usage; see http://www.gzip.org to obtain a copy of the software. Hints for opening THEMIS data in commonly available software packages are available as simple text files in the SOFTWARE/DOC directory. The THEMIS team uses the software tool DAVINCI to display and analyze the SPECTRAL_QUBEs and IMAGEs; this software tool is available at http://davinci.asu.edu. 5. Volume Contents The following diagram outlines the contents of a single archive volume which only includes data from a single publication release period (approximately three months of THEMIS observations). Subtle differences exist between the archive volume directory structure and the online virtual volume (logical volume) directory structure. See the Appendices of the DOCUMENT/ARCHSIS text for detailed discussions of both directory structures. Files on the THEMIS archive volumes 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. In the generalized structure shown below, the following lowercase abbreviations may be used : g = placeholder for projection abbreviation n = placeholder for image numbers o = placeholder for orbit numbers v = placeholder for volume version number x = placeholder for volume number * = wildcard placeholder for multiple files with this filename pattern ODTSDP_vxxxx (Top-level directory) | ----- AAREADME.HTM | ----- AAREADME.LBL | ----- AAREADME.TXT | ----- ERRATA.TXT | ----- VOLDESC_vxxxx.CAT | ----- BROWSE | | ----- BROWINFO.TXT | | ----- ODTBWSv_xxxx | | | ----- IoooXX | | | | ----- Iooooonnn.png | | | | ----- Iooooonnn_small.jpg | | | ----- VoooXX | | | | ----- Vooooonnn.png | | | | ----- Vooooonnn_small.jpg | ----- CALIB | | ----- BIAS_FILES | | | ----- ZEROFRAME*_BIAS.FITS | | ----- CALIBINFO.TXT | | ----- CALIB.LBL | | ----- CALIB.PDF | | ----- CALIB_APXB.PDF | | ----- CALIB_FIGS.PDF | | ----- DESMEAR_FILES | | | ----- DEZERO*_COEFFS.TXT | | | ----- ZEROFRAME*_ZERO.FITS | | ----- IRF_FILE | | ----- PROCESS_HTM | | | ----- PROCESS_IR.HTM | | | ----- PROCESS_VIS.HTM | | | ----- VISIMAGE00x.GIF | | | ----- VISIMAGE00x.JPG | | ----- PROCESS.LBL | | ----- PROCESS_IR.PDF | | ----- PROCESS_VIS.PDF | | ----- SENSITIVITY_FILES | | | ----- FLAT_FRAMES*.PROF*.FITS | | ----- STRAYLIGHT_FILES | | | ----- DESTRAY*_FRAME*_*.FITS | | ----- TEMP2RAD_FILE | ----- CATALOG | | ----- CATINFO.TXT | | ----- INST.CAT | | ----- INSTHOST.CAT | | ----- MARTGT.CAT | | ----- MISSION.CAT | | ----- ODTIBDS.CAT | | ----- ODTIBREL.CAT | | ----- ODTIEDS.CAT | | ----- ODTIEREL.CAT | | ----- ODTIRDS.CAT | | ----- ODTIRREL.CAT | | ----- ODTVBDS.CAT | | ----- ODTVBREL.CAT | | ----- ODTVEDS.CAT | | ----- ODTVEREL.CAT | | ----- ODTVRDS.CAT | | ----- ODTVRREL.CAT | | ----- PERSON.CAT | | ----- REF.CAT | ----- DATA | | ----- DATAINFO.TXT | | ----- ODTIBv_xxxx | | | ----- IoooXXBTR | | | | ----- IooooonnnBTR.IMG | | ----- ODTIEv_xxxx | | | ----- IoooXXEDR | | | | ----- IooooonnnEDR.QUB | | | | ----- TLM.FMT | | | ----- RoooXXEDR | | | | ----- RooooonnnEDR.QUB | | | | ----- TLM.FMT | | | ----- SoooXXEDR | | | | ----- SooooonnnEDR.QUB | | | | ----- TLM.FMT | | ----- ODTIRv_xxxx | | | ----- IoooXXRDR | | | | ----- IooooonnnRDR.QUB | | | ----- RoooXXRDR | | | | ----- RooooonnnRDR.QUB | | ----- ODTVBv_xxxx | | | ----- VoooXXABR | | | | ----- VooooonnnABR.IMG | | ----- ODTVEv_xxxx | | | ----- VoooXXEDR | | | | ----- VooooonnnEDR.QUB | | ----- ODTVRv_xxxx | | | ----- VoooXXRDR | | | | ----- VooooonnnRDR.QUB | ----- DOCUMENT | | ----- ARCHSIS.HTM | | ----- ARCHSIS.LBL | | ----- ARCHSIS.PDF | | ----- DOCINFO.TXT | | ----- ODY_ORIENT_POINT.TXT | | ----- SDPSIS_HTM | | | ----- SDPSIS.HTM | | | ----- SDPSIS_IMG00x.GIF | | ----- SDPSIS.LBL | | ----- SDPSIS.PDF | ----- INDEX | | ----- CMIDX_ODTIB.LBL | | ----- CMIDX_ODTIB.TAB | | ----- CMIDX_ODTIE.LBL | | ----- CMIDX_ODTIE.TAB | | ----- CMIDX_ODTIR.LBL | | ----- CMIDX_ODTIR.TAB | | ----- CMIDX_ODTVB.LBL | | ----- CMIDX_ODTVB.TAB | | ----- CMIDX_ODTVE.LBL | | ----- CMIDX_ODTVE.TAB | | ----- CMIDX_ODTVR.LBL | | ----- CMIDX_ODTVR.TAB | | ----- INDEX_ODTIBxxxx.LBL | | ----- INDEX_ODTIBxxxx.TAB | | ----- INDEX_ODTIExxxx.LBL | | ----- INDEX_ODTIExxxx.TAB | | ----- INDEX_ODTIRxxxx.LBL | | ----- INDEX_ODTIRxxxx.TAB | | ----- INDEX_ODTVBxxxx.LBL | | ----- INDEX_ODTVBxxxx.TAB | | ----- INDEX_ODTVExxxx.LBL | | ----- INDEX_ODTVExxxx.TAB | | ----- INDEX_ODTVRxxxx.LBL | | ----- INDEX_ODTVRxxxx.TAB | | ----- THMIDX_IR.LBL | | ----- THMIDX_IR.TAB | | ----- THMIDX_IRxxxx.LBL | | ----- THMIDX_IRxxxx.TAB | | ----- THMIDX_VIS.LBL | | ----- THMIDX_VIS.TAB | | ----- THMIDX_VISxxxx.LBL | | ----- THMIDX_VISxxxx.TAB | | ----- INDXINFO.TXT | ----- RELEASE.HTML | ----- SOFTWARE | | ----- DOC | | | ----- NASAVIEW.TXT | | ----- SOFTINFO.TXT | | ----- SRC | | | ----- MD5_QUBE.PL | | | ----- MD5_QUBE.PL.GZ | | | ----- SRCINFO.TXT ODTGEO_vxxxx (Top-level directory) | ----- AAREADME.HTM | ----- AAREADME.LBL | ----- AAREADME.TXT | ----- ERRATA.TXT | ----- VOLDESC_vxxxx.CAT | ----- BROWSE | | ----- ODTBWSv_xxxx | | | ----- IoooXXBWS2 | | | | ----- Iooooonnnggg.png | | | ----- VoooXXBWS2 | | | | ----- Vooooonnnggg.png | | ----- ODTDCSv_xxxx | | | ----- IoooXXDCS | | | | ----- IooooonnnDCS.png | | ----- ODTRGBv_xxxx | | | ----- VoooXXRGB | | | | ----- VooooonnnRGB.png | ----- CALIB | | ----- BIAS_FILES | | | ----- ZEROFRAME*_BIAS.FITS | | ----- CALIBINFO.TXT | | ----- CALIB.LBL | | ----- CALIB.PDF | | ----- CALIB_APXB.PDF | | ----- CALIB_FIGS.PDF | | ----- DESMEAR_FILES | | | ----- DEZERO*_COEFFS.TXT | | | ----- ZEROFRAME*_ZERO.FITS | | ----- IRF_FILE | | ----- PROCESS_HTM | | | ----- PROCESS_IR.HTM | | | ----- PROCESS_VIS.HTM | | | ----- VISIMAGE00x.GIF | | | ----- VISIMAGE00x.JPG | | ----- PROCESS.LBL | | ----- PROCESS_IR.PDF | | ----- PROCESS_VIS.PDF | | ----- SENSITIVITY_FILES | | | ----- FLAT_FRAMES*.PROF*.FITS | | ----- STRAYLIGHT_FILES | | | ----- DESTRAY*_FRAME*_*.FITS | | ----- TEMP2RAD_FILE | ----- CATALOG | | ----- CATINFO.TXT | | ----- DSMAP_EQR.CAT | | ----- DSMAP_POL.CAT | | ----- DSMAP_SNU.CAT | | ----- INST.CAT | | ----- INSTHOST.CAT | | ----- MARTGT.CAT | | ----- MISSION.CAT | | ----- ODTIGDS.CAT | | ----- ODTIGREL.CAT | | ----- ODTIPDS.CAT | | ----- ODTIPREL.CAT | | ----- ODTVADS.CAT | | ----- ODTVAREL.CAT | | ----- ODTVGDS.CAT | | ----- ODTVGREL.CAT | | ----- PERSON.CAT | | ----- REF.CAT | | ----- ZIP.CAT | ----- DATA | | ----- DATAINFO.TXT | | ----- ODTIGv_xxxx | | | ----- IoooXXGEO | | | | ----- Iooooonnnggg.LBL | | | | ----- Iooooonnnggg.CUB.gz | | ----- ODTIPv_xxxx | | | ----- IoooXXPBT | | | | ----- IooooonnnPBT.IMG | | ----- ODTVAv_xxxx | | | ----- VoooXXALB | | | | ----- VooooonnnALB.IMG | | ----- ODTVGv_xxxx | | | ----- VoooXXGEO | | | | ----- Vooooonnnggg.LBL | | | | ----- Vooooonnnggg.CUB | ----- DOCUMENT | | ----- ARCHSIS.HTM | | ----- ARCHSIS.LBL | | ----- ARCHSIS.PDF | | ----- DOCINFO.TXT | | ----- ODY_ORIENT_POINT.TXT | | ----- GEOMETRY_HTM | | | ----- GEOM_IMG00x.GIF | | | ----- GEOMETRY.HTM | | ----- GEOMETRY.LBL | | ----- GEOMETRY.PDF | ----- INDEX | | ----- CMIDX_IRDCS.LBL | | ----- CMIDX_IRDCS.TAB | | ----- CMIDX_ODTIG.LBL | | ----- CMIDX_ODTIG.TAB | | ----- CMIDX_ODTIP.LBL | | ----- CMIDX_ODTIP.TAB | | ----- CMIDX_ODTVA.LBL | | ----- CMIDX_ODTVA.TAB | | ----- CMIDX_ODTVG.LBL | | ----- CMIDX_ODTVG.TAB | | ----- CMIDX_VISRGB.LBL | | ----- CMIDX_VISRGB.TAB | | ----- INDEX_IRDCSxxxx.LBL | | ----- INDEX_IRDCSxxxx.TAB | | ----- INDEX_ODTIGxxxx.LBL | | ----- INDEX_ODTIGxxxx.TAB | | ----- INDEX_ODTIPxxxx.LBL | | ----- INDEX_ODTIPxxxx.TAB | | ----- INDEX_ODTVAxxxx.LBL | | ----- INDEX_ODTVAxxxx.TAB | | ----- INDEX_ODTVGxxxx.LBL | | ----- INDEX_ODTVGxxxx.TAB | | ----- INDEX_VISRGBxxxx.LBL | | ----- INDEX_VISRGBxxxx.TAB | | ----- THMIDX_IR.LBL | | ----- THMIDX_IR.TAB | | ----- THMIDX_IRxxxx.LBL | | ----- THMIDX_IRxxxx.TAB | | ----- THMIDX_VIS.LBL | | ----- THMIDX_VIS.TAB | | ----- THMIDX_VISxxxx.LBL | | ----- THMIDX_VISxxxx.TAB | | ----- INDXINFO.TXT | ----- RELEASE.HTML | ----- SOFTWARE | | ----- DOC | | | ----- NASAVIEW.TXT | | ----- SOFTINFO.TXT | | ----- SRC | | | ----- MD5_QUBE.PL | | | ----- MD5_QUBE.PL.GZ | | | ----- SRCINFO.TXT 6. Whom to Contact for Information For questions concerning this data set: PDS - Flagstaff Imaging Node United states Geological Survey 2255 North Gemini Drive Flagstaff, AZ 86001 Electronic mail address: pdsmgr@usgs.gov 7. Cognizant Persons THM-EDR and THM-RDR data were provided by Philip R. Christensen, THEMIS Principal Investigator, with assistance from Noel Gorelick, Greg Mehall, Kimberly Murray, and Kelly Bender at Arizona State University. THEMIS staff can be reached at archive@mars.asu.edu. Eric Eliason, Patricia Garcia, and Ray Arvidson at Planetary Data System Nodes assisted in the design of the archive volumes.