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
<BYTES>)
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<BYTES>
^object = "filename.ext"
^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 the
beginning of the file (record 1, byte 1), <BYTES> 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.