Thermal Emission Imaging System

2001 Mars Odyssey

 

 

 

 

 

STANDARD DATA PRODUCT

ARCHIVE VOLUME

SOFTWARE INTERFACE SPECIFICATION

 ( THEMIS Archive Volume SIS )

 

 

 

 

 

 

 

 

 

 

Version 2.0

July 1, 2007

Mars Space Flight Facility, Arizona State University


DOCUMENT CHANGE LOG

 

Change

Date

Affected Sections

Initial Draft

5/31/2002

All

First revision

10/01/2002

Most

Archive design revision; added BTR & ABR as standard products; defined virtual volume

01/01/03

Most

Browse image format change

07/01/03

Acronyms, Sections 2.2, 3.2.4, Appendices A & B

VIS calibration files changed to  subdirectories containing multiple files

04/01/04

Section 2.3, Appendix A

Update to INDEX directory contents

07/01/04

Section 2.7, Appendices A & B

Update to DOCUMENT directory contents

10/01/04

Section 2.6, Appendices A & B

Addition of Appendix C. GEOMETRY

Update of references 6 & 10

01/01/06

Acronyms, Sections 1.2, Appendices B & C

Section 1.3

Updates related to IR-GEO products

Addition of ODY_ORIENT_POINT text

07/01/09

Acronyms, Sections 1.2, 5.0, Appendices B & C

Sections 2.6, Appendices A & B

 


TABLE OF CONTENTS

DOCUMENT CHANGE LOG........................................................................................................ II

TABLE OF CONTENTS............................................................................................................... III

ACRONYMS AND ABBREVIATIONS........................................................................................ V

1. Introduction................................................................................................................................... 1

1.1 Purpose and Scope................................................................................................................. 1

1.2 Content Overview................................................................................................................... 1

1.3 Applicable Documents and Constraints.................................................................................... 1

1.4 Relationships with Other Interfaces.......................................................................................... 2

2. Archive Volume Contents.............................................................................................................. 2

2.1 Root Directory Contents......................................................................................................... 2

2.2 Browse Directory Contents..................................................................................................... 3

2.3 Calib Directory Contents......................................................................................................... 3

2.4 Catalog Directory Contents..................................................................................................... 4

2.5 Data Directory Contents and Naming...................................................................................... 5

2.6 Document Directory Contents................................................................................................. 6

2.7 Index Directory Contents........................................................................................................ 6

2.8 Software Directory Contents................................................................................................... 7

3. Archive Volume Format................................................................................................................. 8

3.1 Disk Format........................................................................................................................... 8

3.2 File Formats........................................................................................................................... 8

3.2.1 PDS Label Format............................................................................................................ 8

3.2.2 Document File Format....................................................................................................... 9

3.2.3 Catalog File Format......................................................................................................... 10

3.2.4 PNG and JPG File Formats............................................................................................. 10

3.2.5 IMAGE File Format........................................................................................................ 10

3.2.6 Tabular File Format......................................................................................................... 10

3.2.7 QUBE File Format.......................................................................................................... 10

 Archive Volume Generation............................................................................................................ 11

4.1 Interface Media Characteristics............................................................................................. 11

4.2 Labeling and Identification..................................................................................................... 11

4.3 Data Product Sizes and Delivery Rates.................................................................................. 12

4.4 Data Transfer and Validation Methods.................................................................................. 13

5. Support Staff and Cognizant Persons........................................................................................... 13

5.1 THEMIS Archive Volume Staff............................................................................................. 13

5.2 PDS Personnel Responsible for Archive Support................................................................... 14

Appendix A: Archive Volume Directory Structure............................................................................ 15

A.1 IREDR Volumes: ODTIEv_xxxx.......................................................................................... 15

A.2 VISEDR Volumes: ODTVEv_xxxx...................................................................................... 16

A.3 IRRDR Volumes: ODTIRv_xxxx.......................................................................................... 18

A.4 VISRDR Volumes: ODTVRv_xxxx...................................................................................... 19

A.5 IRBTR Volumes: ODTIBv_xxxx.......................................................................................... 21

A.6 VISABR Volumes: ODTVBv_xxxx...................................................................................... 22

Appendix B: THEMIS Virtual Archive Volume................................................................................ 25

B.1 Virtual Archive Volume Contents.......................................................................................... 25

B.2 Virtual Volume Directory Structure....................................................................................... 26

Appendix C: THEMIS Geometrically Registered Products............................................................... 30

C.1 Geometry Product Overview................................................................................................ 30

C.2 Geometry Directory Contents............................................................................................... 30

 

 


ACRONYMS AND ABBREVIATIONS

 

ABR

Apparent Brightness Record

ASCII

American Standard Code for Information Interchange

ASU

Arizona State University

BTR

Brightness Temperature Record

DCS

DeCorrelation Stretch record

DVD

Digital Versatile Disk

EDR

Experiment Data Record

GEO

Geometrically registered record

IR

Infrared

ISIS

Integrated Software for Imaging Spectrometers

ISO

International Standards Organization

JPEG

Joint Photographic Experts Group

JPL

Jet Propulsion Laboratory

Mbyte

Megabyte

NASA

National Aeronautics and Space Administration

NSSDC

National Space Science Data Center

ODY

2001 Mars Odyssey

PBT

Projected Brightness Temperature record

PDS

Planetary Data System

PNG

Portable Network Graphics

SDVT

Science Data Validation Team

SIS

Software Interface Specification

RDR

Reduced Data Record

TLM

Telemetry

THM

THermal EMission Imaging System

VIS

Visible

 


GLOSSARY

 

Archive – An archive consists of one or more data sets along with all the documentation and ancillary information needed to understand and use the data. An archive is a logical construct independent of the medium on which it is stored.

Archive Volume – A volume is a unit of media on which data products are stored; for example, one CD-ROM or DVD-ROM. An archive volume is a volume containing all or part of an archive; that is, data products plus documentation and ancillary files.

Archive Volume Set – When an archive spans multiple volumes, they are called an archive volume set. Usually the documentation and some ancillary files are repeated on each volume of the set, so that a single volume can be used alone. 

Virtual Archive Volume – When an archive is available online, it is not constrained by the size limitations of physical media and it is called a virtual archive volume.  The virtual archive mimics the directory structure of a single archive volume, with an expanded data directory to contain all of the data available on the archive volume set.

Catalog Information – Descriptive information about a data set (e.g. mission description, spacecraft description, instrument description), expressed in Object Description Language (ODL) which is suitable for loading into a PDS catalog.

Data Product – A labeled grouping of data resulting from a scientific observation, usually stored in one file. A product label identifies, describes, and defines the structure of the data. An example of a data product is a planetary image, a spectrum table, or a time series table.

Data Set – An accumulation of data products. A data set together with supporting documentation and ancillary files is an archive.

Standard Data Product – A data product generated in a predefined way using well-understood procedures, processed in "pipeline" fashion. Data products that are generated in a non­standard way are sometimes called special data products.

 


1. Introduction

1.1 Purpose and Scope

This Software Interface Specification is intended to be used by those who wish to understand the format and content of the THEMIS Archive.  Typically, these individuals would be software engineers, data analysts, or planetary scientists.         

The specifications in this document apply to all THEMIS standard product archive volumes that are generated by the Mars Odyssey Project.

1.2 Content Overview

This Software Interface Specification (SIS) describes the content, generation, and format of the THEMIS Archive.  THEMIS is a combination visible (VIS) and infrared (IR) multi-spectral imager onboard the 2001 Mars Odyssey Orbiter.  The standard data products in the archive are the raw (EDR), the calibrated (RDR) spectral image QUBEs, and either a visible apparent brightness image (ABR) or an infrared brightness temperature image (BTR) derived from the RDR QUBE.  All products are available at both visible or thermal infrared wavelengths: VISEDR or IREDR, VISRDR or IRRDR, and VISABR or IRBTR.  In this text, the acronyms THM-EDR and THM-RDR may be used to collectively reference the raw and calibrated data products at both wavelengths.  Geometrically projected spectral images and derived products are available as special, non-standard data products generated from the RDR QUBE. The THEMIS Team at the ASU Mars Space Flight Facility is responsible for generating these products and assembling the archive.   

·                    Applicable Documents and Constraints

This Archive Volume SIS is intended to be consistent with the following documents:

1.      Mars Exploration Program Data Management Plan, R. E. Arvidson and S. Slavney, Rev. 2, Nov. 2, 2000.

2.      2001 Mars Odyssey Orbiter Archive Generation, Validation and Transfer Plan, R. E. Arvidson, R. S. Saunders, and S. Slavney, JPL D-20679, November 3, 2000.

3.      Planetary Data System Data Preparation Work­book, February 1995, Version 3.1, JPL D-7669, Part 1.

4.      Planetary Data System Standards Refer­ence,  October 30, 2002, Version 3.5, JPL D-7669, Part 2.

5.      ISO 9660-1988, Information Processing - Volume and File Structure of CD-ROM for Information Exchange, April 15, 1988. 

The user is referred to the following THEMIS documents for additional information:

6.      The Thermal Emission Imaging System (THEMIS) for the Mars 2001 Odyssey Mission, P.R. Christensen, et. Al., Space Science Review, 2001, Vol 110, pp85-130, 2004.

7.      Calibration Report for the Thermal Emission Imaging System (THEMIS) for the 2001 Mars Odyssey Mission, P.R. Christensen.

8.      THEMIS Standard Data Products Software Interface Specification, January 2003, JPL D-xxxx.

9.      Mars Odyssey THEMIS: Data Processing User’s Guide, P.R. Christensen.

10.  Mars Odyssey THEMIS: Geometric Processing User’s Guide, K. Murray.

1.3 Relationships with Other Interfaces

This Archive Volume SIS could be affected by changes to the design of the THEMIS standard data products or the THEMIS processing software, described respectively in the THEMIS Software Interface Specification [8] and in the THEMIS Processing User’s Guide [9].

·                    Archive Volume Contents

This section describes the contents of the THEMIS archive volumes, including the file names, file contents, file types, and organization responsible for providing the files.  Data from the six THEMIS standard datasets (IREDR, VISEDR, IRRDR, VISRDR, IRBTR, and VISABR) are stored in separate archive volumes;  however, each volume has a similar directory structure, as described below and shown in Appendix A.

THEMIS archive volumes will be available on physical media only for permanent archive purposes, and available online for public consumption (details in section 4).  The online archive is based on the format of the physical archive, with minor differences due to the size limitations of the latter.  The format of the online archive is described in Appendix B.

·                    Root Directory Contents

Files in the Root directory include an overview of the archive, a description of the volume for the PDS Catalog, and a list of errata or comments about the archive.  All files in this directory are provided by the THEMIS team.  The following files are contained in the Root directory.

File Name

File Contents

AAREADME.TXT

Volume content and format information

AAREADME.HTM

Hypertext version of AAREADME.TXT

AAREADME.LBL

A PDS detached label that describes both AAREADME.TXT and AAREADME.HTM

ERRATA.TXT

A cumulative listing of comments and updates concerning all archive volumes published to date

VOLDESC.CAT

A description of the contents of this volume in a PDS format readable by both humans and computers

 

1.4 Browse Directory Contents

The Browse directory is available with the calibrated and derived datasets (IRRDR, VISRDR, IRBTR, and VISABR).  It contains reduced-size, easily viewed versions of data products to be used to help identify products of interest available on this archive volume.  Browse image names are based on the PRODUCT_ID of the data product that they represent.  The names follow the pattern of Aooooonnn.png, where

            A            is a 1 letter description of the type of image collected;  [ V = visible image;  I = infrared image; ]

            ooooo     is a 5-digit mission orbit number when the image was collected;  [ 01000 = mapping orbit number example ]

            nnn          is a 3-digit image sequence number indicating the order that images were collected each orbit;  [ 001 =  first image collected in the ooooo orbit ]

            .png         in a 3-letter extension describing this product as a PNG file.

Each browse image has the same dimensions (samples by lines) as a single band of the source data product.  Infrared browse images are derived from the data collected in band 9 (centered at 12.57 mm) of the source IRRDR product.  Visible browse images are derived from the data in band 3 (centered at 0.654 mm) of the source VISRDR product, then geographically projected.  If the named band is not available in the source product the first available band, in numerical order, is used to create the browse image.  Note that there are no browse images for infrared reset (R-RDR) images.

Thumbnail images are browse images reduced to 10% of the original file size.  Thumbnail image names follow the pattern of Aooooonnn_small.jpg, with “A”, “o”, and “n”  defined as above.

Individual browse and thumbnail images are contained in subdirectories following the same organizational conventions of the Data subdirectories which they represent (see Section 2.5).  The file in this directory is provided by the THEMIS team.  The following files are contained in the Browse directory.

File Name

File Contents

BROWSINFO.TXT

A description of the contents of this directory.

 

1.5 Calib Directory Contents

The Calib directory contains calibration documentation and files used to process the data products.  Several subdirectories have been created within the Calib directory to store related calibration files.  All files in this directory and its subdirectories are provided by the THEMIS team.  The following subdirectories and files are contained in the Calib directory;  instrument specific files or subdirectories (i.e. those marked with *) will only be available on the appropriate dataset volumes.

Subdirectory Name

Subdirectory Contents

BIAS_FILES *

Files used in VIS calibration; see THEMIS Processing User’s Guide [9] for list of current files

DESMEAR_FILES *

Files used in VIS calibration; see THEMIS Processing User’s Guide [9] for list of current files

SENSITIVITY_FILES *

Files used in VIS calibration; see THEMIS Processing User’s Guide [9] for list of current files

STRAYLIGHT_FILES *

Files used in VIS calibration; see THEMIS Processing User’s Guide [9] for list of current files

 

File Name

File Contents

CALIBINFO.TXT

A description of the contents of this directory

CALIB.LBL

A PDS detached label that describes CALIB.PDF files

CALIB.PDF

The THEMIS Calibration Report as a PDF file

CALIB_APXB.PDF

The THEMIS Calibration Report, Appendix B as a PDF file

CALIB_FIGS.PDF

Figures for the THEMIS Calibration Report as a PDF file

IRF_FILE *

Used in IR calibration; see THEMIS Processing User’s Guide [9]

PROCESS.HTM

The THEMIS Data Processing User Guide in HTML format

PROCESS.PDF

The THEMIS Data Processing User Guide as a PDF file

PROCESS.LBL

A PDS detached label that describes both PROCESS.TXT and PROCESS.PDF

TEMP2RAD_FILE *

Used in IR calibration; see THEMIS Processing User’s Guide [9]

 

1.6 Catalog Directory Contents

The files in the Catalog directory provide a top-level understanding of the mission, spacecraft, instruments, and data sets.  The files in this directory are coordinated with the PDS data engineer, who is responsible for loading them into the PDS catalog.  The THEMIS team has provided all of the files in this directory except the INSTHOST.CAT, MARTGT.CAT, and MISSION.CAT.  One or more of the following files may be found in the Catalog directory; files that are dataset specific (i.e. filename starts with ODT) will only be available on the appropriate dataset volumes.

File Name

File Contents

CATINFO.TXT

A description of the contents of this directory

INSTHOST.CAT

Instrument host (Mars Odyssey spacecraft) information for the PDS catalog

INST.CAT

Instrument information for the PDS catalog

MARTGT.CAT

Physical information for the planetary target Mars

MISSION.CAT

Mission information for the PDS catalog

PERSON.CAT

THEMIS and PDS personnel information for the PDS catalog

ODTIBDS.CAT

IRBTR data set information for the PDS catalog

ODTIBREL.CAT

IRBTR release information for the PDS catalog

ODTIEDS.CAT

IREDR data set information for the PDS catalog

ODTIEREL.CAT

IREDR release information for the PDS catalog

ODTIRDS.CAT

IRRDR data set information for the PDS catalog

ODTIRREL.CAT

IRRDR release information for the PDS catalog

ODTVBDS.CAT

VISABR data set information for the PDS catalog

ODTVBREL.CAT

VISABR release information for the PDS catalog

ODTVEDS.CAT

VISEDR data set information for the PDS catalog

ODTVEREL.CAT

VISEDR release information for the PDS catalog

ODTVRDS.CAT

VISRDR data set information for the PDS catalog

ODTVRREL.CAT

VISRDR release information for the PDS catalog

PERSON.CAT

THEMIS and PDS personnel information for the PDS catalog

REF.CAT

References mentioned in other *.CAT files

 

1.7 Data Directory Contents and Naming

The Data directory contains data subdirectories and related overview files;  the THEMIS standard data products (see THEMIS Standard Data Product SIS [8]) are stored in the data subdirectories.  The number of subdirectories on an archive volume will maximize the storage space of the archive media, but will vary between individual volumes due to the inconsistent data volume over any given block of orbits. 

The data subdirectories contain the image data products in groups of 10 orbits.  For raw infrared volumes, a calibration image from an orbit outside of the range of the 10-orbit subdirectories may be duplicated on the volume that contains the IR image that requires that calibration image. The subdirectories are named for the data contents following the pattern of “AoooXXPPP” where

            A         is a 1 letter description of the type of image collected;  [ V = visible image;  I = infrared image;  R = infrared reset image;  S = infrared shutter image ]

            ooo      is the first 3 numbers of the mission orbit number when the data was collected, zero padded

            XX       is a placeholder representing the remaining digit of the mission orbit number

            PPP     is a 3 letter description of the processing level of the data products;  [ ABR = VIS apparent brightness image; BTR = IR brightness temperature image; EDR = raw data;  RDR = radiometrically calibrated data  ]

A detailed description of the data products is available in the THEMIS Software Interface Specification [8]. 

All files and standard data products in this directory are provided by the THEMIS team. The following files are contained in the Data directory or the indicated subdirectory.

File Name

File Contents

DATAINFO.TXT

A description of the contents of this directory

TLM.FMT

The TLM.FMT file is included with raw, infrared data subdirectories (IooooXEDR, RooooXEDR, and SooooXEDR). The TLM format file contains the names of all fields stored in the TLM table header object in infrared raw data QUBEs.

 

·                    Document Directory Contents

The Document directory contains documentation to help the user understand and use the archive data.  All files in this directory and all subdirectories are provided by the THEMIS team. 

The following files are contained in the Document directory.

File Name

File Contents

DOCINFO.TXT

A description of the contents of this directory

ARCHSIS.HTM

The Archive Volume SIS (this document) in HTML format

ARCHSIS.PDF

The Archive Volume SIS (this document) as a PDF file

ARCHSIS.LBL

A PDS detached label that describes both ARCHSIS.TXT and ARCHSIS.PDF

ODY_ORIENT_POINT.TXT

A text file describing the orientation and pointing of the Odyssey spacecraft

SDPSIS_HTM

A subdirectory containing the HTML files of the THEMIS Standard Data Product SIS

SDPSIS.PDF

The THEMIS Standard Data Product SIS as a PDF file

SDPSIS.LBL

A PDS detached label that describes both SDPSIS.TXT and SDPSIS.PDF

 

The following files are contained in the SDPSIS_HTM subdirectory.

File Name

File Contents

SDPSIS.HTM

The THEMIS Standard Data Product SIS in HTML format

SDPSIS_IMG00x.GIF

GIF formatted images sourced by the SDPSIS.HTM.

 

1.8 Index Directory Contents

Files in the Index directory are provided to help the user locate products on this archive volume and on previously released volumes in the archive.  All files in this directory are provided by the THEMIS team.  The following files are contained in the Index directory.  

File Name

File Contents

CMIDX_ODTVB.TAB

Cumulative index table listing release information for all IR-BTR data products released to date

CMIDX_ODTIB.LBL

A PDS detached label that describes the CMIDX_ODTIB.TAB

CMIDX_ODTIE.TAB

Cumulative index table listing release information for all IR-EDR data products released to date

CMIDX_ODTIE.LBL

A PDS detached label that describes the CMIDX_ODTIEX.TAB

CMIDX_ODTIR.TAB

Cumulative index table listing release information for all IR-RDR data products released to date

CMIDX_ODTIR.LBL

A PDS detached label that describes the CMIDX_ODTIR.TAB

CMIDX_ODTVB.TAB

Cumulative index table listing release information for all VIS-ABR data products released to date

CMIDX_ODTVB.LBL

A PDS detached label that describes the CMIDX_ODTVB.TAB

CMIDX_ODTVE.TAB

Cumulative index table listing release information for all VIS-EDR data products released to date

CMIDX_ODTVE.LBL

A PDS detached label that describes the CMIDX_ODTVE.TAB

CMIDX_ODTVR.TAB

Cumulative index table listing release information for all VIS-RDR data products released to date

CMIDX_ODTVR.LBL

A PDS detached label that describes the CMIDX_ODTVR.TAB

INDEX_ODTIB.TAB

Index table listing release information for all IR-BTR data products on this volume

INDEX_ODTIB.LBL

A PDS detached label that describes INDEX_ODTIB.TAB

INDEX_ODTIE.TAB

Index table listing release information for all IR-EDR data products on this volume

INDEX_ODTIE.LBL

A PDS detached label that describes INDEX_ODTIE.TAB

INDEX_ODTIR.TAB

Index table listing release information for all IR-RDR data products on this volume

INDEX_ODTIR.LBL

A PDS detached label that describes INDEX_ODTIR.TAB

INDEX_ODTVB.TAB

Index table listing release information for all VIS-ABR data products on this volume

INDEX_ODTVB.LBL

A PDS detached label that describes INDEX_ODTVB.TAB

INDEX_ODTVE.TAB

Index table listing release information for all VIS-EDR data products on this volume

INDEX_ODTVE.LBL

A PDS detached label that describes INDEX_ODTVE.TAB

INDEX_ODTVR.TAB

Index table listing release information for all VIS-RDR data products on this volume

INDEX_ODTVR.LBL

A PDS detached label that describes INDEX_ODTVR.TAB

INDXINFO.TXT

A description of the contents of this directory

THMIDX_IR.LBL

A PDS detached label that describes THMIDX_IR.TAB

THMIDX_IR.TAB

Index table listing general observation information and geometric parameters for all available IR observations

THMIDX_VIS.LBL

A PDS detached label that describes THMIDX_VIS.TAB

THMIDX_VIS.TAB

Index table listing general observation information and geometric parameters for all available VIS observations

 

1.9 Software Directory Contents

The Software directory contains software documentation and source code that may be useful when manipulating the THEMIS data products.  All files in this directory and software subdirectories are provided by the THEMIS team.  These files are subject to change throughout the mission and only the most recent version will be available on the archive.  The following files are contained in the Software directory or the indicated subdirectory.

File Name

File Contents

SOFTINFO.TXT

A description of the contents of this directory

SRCINFO.TXT

A description of the contents of SRC subdirectory; available in the SRC subdirectory

MD5_QUBE.PL

Pearl source code to calculate the MD5 value of a THM-EDR or THM-RDR; available in the SRC subdirectory

NASAVIEW.TXT

Hints for opening THEMIS data products using the NASA View software

 

·                    Archive Volume Format

This section describes the format of THEMIS Archive Volumes. Data that comprise the archive will be formatted in accordance with Planetary Data System specifications (PDS Data Preparation Work­book, [4] and PDS Standards Refer­ence, [5]).

1.10 Disk Format

Archive Volumes have a digital versatile disk (DVD) format that is compatible with the computer operating systems MS‑DOS, Macintosh, and SunOS. The volume format is in accordance with ISO 9660 level 2 Interchange Standard [6].

1.11 File Formats

This section describes file formats for the kinds of files contained on Archive Volumes.

·                    PDS Label Format

All text and data  files in the archive have PDS labels associated with them, either embedded at the beginning of the file or detached in a separate file;  the label location is described in each of the following individual “file format” sections.  For examples of PDS labels for each type of data product, see the THEMIS Standard Data Product SIS [8].

            A PDS label, whether embedded or detached from its associated file, 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 <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,

                     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 of the DVD.  '[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 the DVD root itself.

            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.

 1.11.1 Document File Format

Document files with the .TXT suffix exist in the Root, Browse, Catalog, Data, Document, and Index directories.  They are ASCII files which 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.

Documents in the Document directory may contain formatting and figures that cannot be rendered as ASCII text.  Therefore, each document is given in two formats, hypertext and PDF, and is accompanied by  a detached PDS label.  The hypertext file contains ASCII text plus hypertext markup language (HTML) commands that enable it to be viewed in a Web browser such as Netscape Navigator or Microsoft Internet Explorer.  The hypertext file may be accompanied by ancillary files such as images and style sheets that are incorporated into the document by the Web browser.  The second 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.

 1.11.2 Catalog File Format

            Catalog files (suffix .CAT) exist in the Root and Catalog directories.  They are ASCII text files with an embedded PDS label.  The text contents are formatted in an object-oriented structure consisting of sets of 'keyword=value' declarations.  Lines in a .CAT 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.

 1.11.3 PNG and JPG File Formats

THEMIS browse images are stored as PNG and JPEG files (.jpg suffix) in the Browse subdirectories.  PNG and JPG images are 24-bit per pixel, color images in binary format.  The THEMIS team uses the standardized image compression algorithms to create the browse files.  For more information see http://www.libpng.org/pub/png  and http://www.jpg.org.  

 1.11.4 IMAGE File Format

THEMIS brightness records are single band images stored as IMAGE files (.IMG suffix) in the Data subdirectories.  All THEMIS IMAGEs adhere to the PDS standards for IMAGE objects as defined in the PDS Standards Reference [4].  Each IMAGE is composed of a header and a binary array of data derived from radiometric calibration of one observation.  Each IMAGE header includes the embedded, ASCII PDS label, with information stored as ASCII text in a “keyword = value” format compliant with PDS standards. 

For more information about the format and content of these data products, see the THEMIS Data Product SIS [8].

 1.11.5 Tabular File Format

Tabular files (.TAB suffix) exist in the Index directory.  Tabular files are ASCII files formatted for direct reading into many database management systems on various computers.  All fields are separated by commas, and character fields are enclosed in double quotation marks (").  (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" and "bytes" values listed in the labels do not include the commas between fields or the quotation marks surrounding character fields.  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.

            All tabular files are described by PDS labels, either embedded at the beginning of the file or detached.  If detached, the PDS label file has the same name as the data file it describes, with the extension .LBL; for example, the file INDEX.TAB is accompanied by the detached label file INDEX.LBL in the same directory.

 1.11.6  QUBE File Format

THEMIS raw and calibrated data are multispectral images stored as QUBE files (.QUB suffix) in the Data subdirectories.  All THEMIS QUBEs adhere to the PDS standards for SPECTRAL_QUBE objects as defined in the PDS Standards Reference [4].  Each QUBE is composed of a header and a binary array of data collected during one observation. 

Each QUBE header includes the embedded, ASCII PDS label and a HISTORY data object;  raw infrared (IREDR) data products also contain a telemetry (TLM) data table.  The HISTORY object is a cumulative record of all the computer manipulations of the data file.  The information is stored as ASCII text in a “keyword = value” format similar to, but not intended to be compliant with, PDS standards.  The TLM table follows the PDS standards for a binary table of fixed-length records, and is accompanied by a detached PDS label (TLM.FMT) that defines the table structure.

For more information about the format and content of these data products, see the THEMIS Data Product SIS [8]. 

 

·                    Archive Volume Generation

1.12 Interface Media Characteristics

All archive volumes in the THEMIS Standard Product Archive conform to the ISO 9660 standards (ISO 9660-1988, [6]).

1.13 Labeling and Identification

As per the PDS Standards Reference [4], each THEMIS archive volume will bear a VOLUME_ID based on the last two components of the VOLUME_SET_ID.  The VOLUME_SET_ID is USA_NASA_PDS_ODTdsv_xxxx, where

            OD      identifies this volume set with the Mars Odyssey spacecraft

            T          identifies this volume set with the THEMIS instrument

            dsv       identifies the THEMIS DATA_SET_ID and the version number of the data  set

            xxxx     is the volume number within the volume set.

VOLUME_SET_ID

VOLUME_ID

DATA_SET_ID

USA_NASA_PDS_ODTIEv_xxxx

ODTIEv_xxxx

ODY-M-THM-2-IREDR-v1.0

USA_NASA_PDS_ODTVEv_xxxx

ODTVEv_xxxx

ODY-M-THM-2-VISEDR-v1.0

USA_NASA_PDS_ODTIRv_xxxx

ODTIRv_xxxx

ODY-M-THM-3-IRRDR-v1.0

USA_NASA_PDS_ODTVRv_xxxx

ODTVRv_xxxx

ODY-M-THM-3-VISRDR-v1.0

USA_NASA_PDS_ODTIBv_xxxx

ODTIBv_xxxx

ODY-M-THM-3-IRBTR-v1.0

USA_NASA_PDS_ODTVBv_xxxx

ODTVBv_xxxx

ODY-M-THM-3-VISRDR-v1.0

For example, the first volumes in the original data release [v = 0] have the VOLUME_ID values of ODTIE0_0001, ODTVE0_0001, ODTIR0_0001, ODTVR0_0001, ODTIB0_0001, and ODTVB0_0001 for each data set respectively.  The data available on  each volume will maximize the space available, as described in Section 1.3;  no attempt will be made to correlate the data in a given volume number (e.g. ODTIE0_9999) with the same volume number of another  volume set ( e.g. ODTIR0_9999).     

1.14 Data Product Sizes and Delivery Rates

The size of individual raw data products (VISEDR & IREDR) depends on several factors: image type (VIS vs. IR), length of an image (# frames), and the number of bands in the image.  Within these parameters, a raw VIS image (VISEDR) can vary in size from 0.38 to 3.7 Mbytes;  a raw IR image (IREDR) can vary in size from 0.07 to 199 Mbytes.  Calibration (VISRDR & IRRDR) increases the file size by a factor of two, as compared to the corresponding raw image.

The estimated total volume of data to be collected over the course of the mission is limited by the available downlink allocated to THEMIS.  Many factors affect the actual downlink available on any given day, which can vary from 0 to 375 Mbytes per day.  THEMIS mission planners will maximize data collection by balancing the day’s available allocated downlink against the size-defining parameters of the daily planned observations (VIS/IR, image length, number of bands). 

For example, the following shows the expected content range of the 10 orbit data subdirectories over the course of the mission, taking into account the primary variables affecting file size and data  volume.

Subdirectory Name

No. of QUBEs

Subdirectory Size

IooooXEDR

10 - 180

125 - 2150  Mbytes

VooooXEDR

1 - 500

4 – 1750  Mbytes

IooooXRDR

10 - 180

250 – 4300  Mbytes

VooooXRDR

1 - 500

8 – 3500  Mbytes

IooooXBTR

10 - 180

10 – 180  Mbytes

VooooXABR

1 - 500

3 –  1500 Mbytes

In compliance with the Odyssey Archive Plan [2], THEMIS standard data products will become available through PDS six months after ground receipt of the last raw data within the three month acquisition period.  An approximate THEMIS archive volume delivery schedule, based on the nominal science mission timeline and THEMIS primary data acquisition periods, is shown below.

Data Collection Period

Delivery Date

March 2002

Oct 2002*

Apr – Jun 2002

Jan 2003

Jul – Sept 2002

April 2003

Oct – Dec 2002

 July 2003

Jan – Mar 2003

Oct 2003

Apr – Jun 2003

Jan 2004

Jul – Sept 2003

April 2004

Oct – Dec 2003

 July 2004

Jan – Mar 2004

Oct 2004

Apr - Jun 2004

Jan 2005

*Delivery includes only ABR, BTR, and EDR standard data products.

1.15 Data Transfer and Validation Methods

In compliance with the Odyssey Archive Plan [2], the THEMIS Team will produce complete THM-EDR, THM-RDR, IR-BTR, and VIS-ABR Standard Product Archive Volumes at the ASU Mars Space Flight Facility.  Archive volumes will be written as necessary to write-once DVDs (DVD-Rs) for distribution to co-investigators and the Science Data Validation Team (SDVT).  The PDS Imaging Node will receive a DVD copy of each archive volume to verify that it conforms to the THM Standard Data Product SIS [3] and to PDS standards for archive volumes. 

Upon approval of a volume by the SDVT, the THEMIS Team will make the volume available online for public consumption (see Appendix B).  For archive purposes, the THEMIS Team will generate three DVD copies of each volume and deliver them to the permanent archive sites: PDS Imaging Node, PDS Central Node, and the National Space Science Data Center (NSSDC).  THEMIS will make additional copies for the Mars Odyssey Project of a volume by special request only.  

·                    Support Staff and Cognizant Persons

·                    THEMIS Archive Volume Staff

                Mars Space Flight Facility

                Arizona State University

                Box 876305

                Tempe, Arizona  85287-6305

 

Kelly C. Bender

Mission Planning & Operations                 480-965-1790             archive@mars.asu.edu

 

Philip R. Christensen

THEMIS Principal Investigator                 480-965-1790             archive@mars.asu.edu

 

Noel S. Gorelick

Software Engineer                                            480-965-1790             archive@mars.asu.edu

 

Greg L. Mehall

THEMIS Instrument Manager                    480-965-1790             archive@mars.asu.edu

 

Kimberly C. Murray

Data Validation & Archiving                      480-965-1790             archive@mars.asu.edu

 

1.16 PDS Personnel Responsible for Archive Support

 

Raymond E. Arvidson

Interdisciplinary Scientist for Data & Archives

        Washington University

        Campus Box 1169

        One Brookings Drive

        St. Louis, Missouri  63130

                                                                                    314-935-5679             geosci@wunder.wustl.edu

 

Eric M. Eliason

PDS-Flagstaff Imaging Node, THEMIS Archive Manager

        United States Geological Survey

        2255 North Gemini Drive

        Flagstaff, Arizona  86001

                                                                                    928-556-7113             pdsmgr@usgs.gov

 

Patricia A. Garcia

PDS-Flagstaff Imaging Node, THEMIS Archiving

        United States Geological Survey

        2255 North Gemini Drive

        Flagstaff, Arizona  86001

                                                                                    928-556-7090             pdsmgr@usgs.gov

 

Susan K. LaVoie

PDS-JPL Imaging Node

        Jet Propulsion Laboratory

        4800 Oak Grove Drive

        Pasadena, California  91199-8099

                                                                                    818-354-5677             pdsmgr@jpl.nasa.gov

 


·                    Archive Volume Directory Structure

Below are the directory structures of the THEMIS archive volumes.  There are six THEMIS archive volume sets corresponding to the six THEMIS datasets: IREDR, VISEDR, IRRDR, VISRDR, IRBTR, AND VISABR.  Names without extensions are directory names (e.g. CATALOG), while names with extensions are file names (e.g. CATINFO.TXT).  Lowercase letters in names are placeholders for numbers described in Sections 2.2 and 2.5 of the main text.

·                    IREDR Volumes: ODTIEv_xxxx

ROOT

 | ------ AAREADME.HTM

 | ------ AAREADME.LBL

 | ------ AAREADME.TXT

 | ------ ERRATA.TXT

 | ------ VOLDESC.CAT

 | ------ CALIB

 |          | ----- CALIBINFO.TXT

 |          | ----- CALIB.LBL

 |          | ----- CALIB.PDF

 |          | ----- CALIB_APXB.PDF

 |          | ----- CALIB_FIGS.PDF

 |          | ----- IRF_FILE

 |          | ----- PROCESS_HTM

 |          |           | ----- PROCESS_IR.HTM

 |          |           | ----- PROCESS_VIS.HTM

 |          |           | ----- VISIMAGE00x.GIF

 |          |           | ----- VISIMAGE00x.JPG

 |          | ----- PROCESS.LBL

 |          | ----- PROCESS_IR.PDF

 |          | ----- PROCESS_VIS.PDF

 |          | ----- TEMP2RAD_FILE

 | ------ CATALOG

 |          | ----- CATINFO.TXT

 |          | ----- INST.CAT

 |          | ----- INSTHOST.CAT

 |          | ----- MARTGT.CAT

 |          | ----- MISSION.CAT

 |          | ----- ODTIEDS.CAT

 |          | ----- ODTIEREL.CAT

 |          | ----- PERSON.CAT

 |          | ----- REF.CAT

 | ------ DATA

 |          | ----- DATAINFO.TXT

 |          | ----- IooooXEDR

 |          |           | ----- IooooonnnEDR.QUB

 |          |           | ----- TLM.FMT

 |          | ----- RooooXEDR

 |          |           | ----- RooooonnnEDR.QUB

 |          |           | ----- TLM.FMT

 |          | ----- SooooXEDR

 |          |           | ----- SooooonnnEDR.QUB

 |          |           | ----- TLM.FMT

 | ------ 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

 |          | ----- INDXINFO.TXT

 |          | ----- CMIDX_ODTIE.LBL

 |          | ----- CMIDX_ODTIE.TAB

 |          | ----- INDEX­_ODTIE.LBL

 |          | ----- INDEX­_ODTIE.TAB

 |          | ----- THMIDX_IR.LBL

 |          | ----- THMIDX_IR.TAB

 |          | ----- THMIDX_VIS.LBL

 |          | ----- THMIDX_VIS.TAB

 | ------ SOFTWARE

 |          | ----- SOFTINFO.TXT

 |          | ----- SRC

 |          |           | ----- SRCINFO.TXT

 |          |           | ----- MD5_QUBE.PL

·                    VISEDR Volumes: ODTVEv_xxxx

ROOT

 | ------ AAREADME.HTM

 | ------ AAREADME.LBL

 | ------ AAREADME.TXT

 | ------ ERRATA.TXT

 | ------ VOLDESC.CAT

 | ------ CALIB

 |          | ----- BIAS_FILES

 |          | ----- CALIBINFO.TXT

 |          | ----- CALIB.LBL

 |          | ----- CALIB.PDF

 |          | ----- CALIB_APXB.PDF

 |          | ----- CALIB_FIGS.PDF

 |          | ----- DESMEAR_FILES

 |          | ----- PROCESS_HTM

 |          |           | ----- PROCESS_IR.HTM

 |          |           | ----- PROCESS_VIS.HTM

 |          |           | ----- VISIMAGE00x.GIF

 |          |           | ----- VISIMAGE00x.JPG

 |          | ----- PROCESS.LBL

 |          | ----- PROCESS_IR.PDF

 |          | ----- PROCESS_VIS.PDF

 |          | ----- SENSITIVITY_FILES

 |          | ----- STRAYLIGHT_FILES

 | ------ CATALOG

 |          | ----- CATINFO.TXT

 |          | ----- INST.CAT

 |          | ----- INSTHOST.CAT

 |          | ----- MARTGT.CAT

 |          | ----- MISSION.CAT

 |          | ----- ODTVEDS.CAT

 |          | ----- ODTVEREL.CAT

 |          | ----- PERSON.CAT

 |          | ----- REF.CAT

 | ------ DATA

 |          | ----- DATAINFO.TXT

 |          | ----- VooooXEDR

 |          |           | ----- VooooonnnEDR.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

 |          | ----- INDXINFO.TXT

 |          | ----- CMIDX_ODTVE.LBL

 |          | ----- CMIDX_ODTVE.TAB

 |          | ----- INDEX­_ODTVE.LBL

 |          | ----- INDEX­_ODTVE.TAB

 |          | ----- THMIDX_IR.LBL

 |          | ----- THMIDX_IR.TAB

 |          | ----- THMIDX_VIS.LBL

 |          | ----- THMIDX_VIS.TAB

 | ------ SOFTWARE

 |          | ----- SOFTINFO.TXT

 |          | ----- SRC

 |          |           | ----- SRCINFO.TXT

 |          |           | ----- MD5_QUBE.PL

·                    IRRDR Volumes: ODTIRv_xxxx

ROOT

 | ------ AAREADME.HTM

 | ------ AAREADME.LBL

 | ------ AAREADME.TXT

 | ------ ERRATA.TXT

 | ------ VOLDESC.CAT

 | ------ BROWSE

 |          | ----- BROWINFO.TXT

 |          | ----- IooooX

 |          |           | ----- Iooooonnn.png

 |          |           | ----- Iooooonnn_small.jpg

 | ------ CALIB

 |          | ----- CALIBINFO.TXT

 |          | ----- CALIB.LBL

 |          | ----- CALIB.PDF

 |          | ----- CALIB_APXB.PDF

 |          | ----- CALIB_FIGS.PDF

 |          | ----- IRF_FILE

 |          | ----- PROCESS_HTM

 |          |           | ----- PROCESS_IR.HTM

 |          |           | ----- PROCESS_VIS.HTM

 |          |           | ----- VISIMAGE00x.GIF

 |          |           | ----- VISIMAGE00x.JPG

 |          | ----- PROCESS.LBL

 |          | ----- PROCESS_IR.PDF

 |          | ----- PROCESS_VIS.PDF

 |          | ----- TEMP2RAD_FILE

 | ------ CATALOG

 |          | ----- CATINFO.TXT

 |          | ----- INST.CAT

 |          | ----- INSTHOST.CAT

 |          | ----- MARTGT.CAT

 |          | ----- MISSION.CAT

 |          | ----- ODTIRDS.CAT

 |          | ----- ODTIR.CAT

 |          | ----- PERSON.CAT

 |          | ----- REF.CAT

 | ------ DATA

 |          | ----- DATAINFO.TXT

 |          | ----- IooooXRDR

 |          |           | ----- IooooonnnRDR.QUB

 |          | ----- RooooXRDR

 |          |           | ----- RooooonnnRDR.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

 |          | ----- INDXINFO.TXT

 |          | ----- CMIDX_ODTIR.LBL

 |          | ----- CMIDX_ODTIR.TAB

 |          | ----- INDEX­_ODTIR.LBL

 |          | ----- INDEX­_ODTIR.TAB

 |          | ----- THMIDX_IR.LBL

 |          | ----- THMIDX_IR.TAB

 |          | ----- THMIDX_VIS.LBL

 |          | ----- THMIDX_VIS.TAB

 | ------ SOFTWARE

 |          | ----- SOFTINFO.TXT

 |          | ----- SRC

 |          |           | ----- SRCINFO.TXT

 |          |           | ----- MD5_QUBE.PL

·                    VISRDR Volumes: ODTVRv_xxxx

ROOT

 | ------ AAREADME.HTM

 | ------ AAREADME.LBL

 | ------ AAREADME.TXT

 | ------ ERRATA.TXT

 | ------ VOLDESC.CAT

 | ------ BROWSE

 |          | ----- BROWINFO.TXT

 |          | ----- VooooX

 |          |           | ----- Vooooonnn.png

 |          |           | ----- Vooooonnn_small.jpg

 | ------ CALIB

 |          | ----- BIAS_FILES

 |          | ----- CALIBINFO.TXT

 |          | ----- CALIB.LBL

 |          | ----- CALIB.PDF

 |          | ----- CALIB_APXB.PDF

 |          | ----- CALIB_FIGS.PDF

 |          | ----- DESMEAR_FILES

 |          | ----- PROCESS_HTM

 |          |           | ----- PROCESS_IR.HTM

 |          |           | ----- PROCESS_VIS.HTM

 |          |           | ----- VISIMAGE00x.GIF

 |          |           | ----- VISIMAGE00x.JPG

 |          | ----- PROCESS.LBL

 |          | ----- PROCESS_IR.PDF

 |          | ----- PROCESS_VIS.PDF

 |          | ----- SENSITIVITY_FILES

 |          | ----- STRAYLIGHT_FILES

 | ------ CATALOG

 |          | ----- CATINFO.TXT

 |          | ----- INST.CAT

 |          | ----- INSTHOST.CAT

 |          | ----- MARTGT.CAT

 |          | ----- MISSION.CAT

 |          | ----- ODTVRDS.CAT

 |          | ----- ODTVRREL.CAT

 |          | ----- PERSON.CAT

 |          | ----- REF.CAT

 | ------ DATA

 |          | ----- DATAINFO.TXT

 |          | ----- VooooXRDR

 |          |           | ----- 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

 |          | ----- INDXINFO.TXT

 |          | ----- CMIDX_ODTVR.LBL

 |          | ----- CMIDX_ODTVR.TAB

 |          | ----- INDEX­_ODTVR.LBL

 |          | ----- INDEX­_ODTVR.TAB

 |          | ----- THMIDX_IR.LBL

 |          | ----- THMIDX_IR.TAB

 |          | ----- THMIDX_VIS.LBL

 |          | ----- THMIDX_VIS.TAB

 | ------ SOFTWARE

 |          | ----- SOFTINFO.TXT

 |          | ----- SRC

 |          |           | ----- SRCINFO.TXT

 |          |           | ----- MD5_QUBE.PL

 .1 IRBTR Volumes: ODTIBv_xxxx

ROOT

 | ------ AAREADME.HTM

 | ------ AAREADME.LBL

 | ------ AAREADME.TXT

 | ------ ERRATA.TXT

 | ------ VOLDESC.CAT

 | ------ BROWSE

 |          | ----- BROWINFO.TXT

 |          | ----- IooooX

 |          |           | ----- Iooooonnn.png

 |          |           | ----- Iooooonnn_small.jpg

 | ------ CALIB

 |          | ----- CALIBINFO.TXT

 |          | ----- CALIB.LBL

 |          | ----- CALIB.PDF

 |          | ----- CALIB_APXB.PDF

 |          | ----- CALIB_FIGS.PDF

 |          | ----- IRF_FILE

 |          | ----- PROCESS_HTM

 |          |           | ----- PROCESS_IR.HTM

 |          |           | ----- PROCESS_VIS.HTM

 |          |           | ----- VISIMAGE00x.GIF

 |          |           | ----- VISIMAGE00x.JPG

 |          | ----- PROCESS.LBL

 |          | ----- PROCESS_IR.PDF

 |          | ----- PROCESS_VIS.PDF

 |          | ----- TEMP2RAD_FILE

 | ------ CATALOG

 |          | ----- CATINFO.TXT

 |          | ----- INST.CAT

 |          | ----- INSTHOST.CAT

 |          | ----- MARTGT.CAT

 |          | ----- MISSION.CAT

 |          | ----- ODTIRDS.CAT

 |          | ----- ODTIR.CAT

 |          | ----- PERSON.CAT

 |          | ----- REF.CAT

 | ------ DATA

 |          | ----- DATAINFO.TXT

 |          | ----- IooooXBTR

 |          |           | ----- IooooonnnBTR.IMG

 | ------ 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

 |          | ----- INDXINFO.TXT

 |          | ----- CMIDX_ODTIB.LBL

 |          | ----- CMIDX_ODTIB.TAB

 |          | ----- INDEX­_ODTIB.LBL

 |          | ----- INDEX­_ODTIB.TAB

 |          | ----- THMIDX_IR.LBL

 |          | ----- THMIDX_IR.TAB

 |          | ----- THMIDX_VIS.LBL

 |          | ----- THMIDX_VIS.TAB

 | ------ SOFTWARE

 |          | ----- SOFTINFO.TXT

 |          | ----- SRC

 |          |           | ----- SRCINFO.TXT

 |          |           | ----- MD5_QUBE.PL

 .2 VISABR Volumes: ODTVBv_xxxx

ROOT

 | ------ AAREADME.HTM

 | ------ AAREADME.LBL

 | ------ AAREADME.TXT

 | ------ ERRATA.TXT

 | ------ VOLDESC.CAT

 | ------ BROWSE

 |          | ----- BROWINFO.TXT

 |          | ----- VooooX

 |          |           | ----- Vooooonnn.png

 |          |           | ----- Vooooonnn_small.jpg

 | ------ CALIB

 |          | ----- BIAS_FILES

 |          | ----- CALIBINFO.TXT

 |          | ----- CALIB.LBL

 |          | ----- CALIB.PDF

 |          | ----- CALIB_APXB.PDF

 |          | ----- CALIB_FIGS.PDF

 |          | ----- DESMEAR_FILES

 |          | ----- PROCESS_HTM

 |          |           | ----- PROCESS_IR.HTM

 |          |           | ----- PROCESS_VIS.HTM

 |          |           | ----- VISIMAGE00x.GIF

 |          |           | ----- VISIMAGE00x.JPG

 |          | ----- PROCESS.LBL

 |          | ----- PROCESS_IR.PDF

 |          | ----- PROCESS_VIS.PDF

 |          | ----- SENSITIVITY_FILES

 |          | ----- STRAYLIGHT_FILES

 | ------ CATALOG

 |          | ----- CATINFO.TXT

 |          | ----- INST.CAT

 |          | ----- INSTHOST.CAT

 |          | ----- MARTGT.CAT

 |          | ----- MISSION.CAT

 |          | ----- ODTVRDS.CAT

 |          | ----- ODTVRREL.CAT

 |          | ----- PERSON.CAT

 |          | ----- REF.CAT

 | ------ DATA

 |          | ----- DATAINFO.TXT

 |          | ----- VooooXABR

 |          |           | ----- VooooonnnABR.IMG

 | ------ 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

 |          | ----- INDXINFO.TXT

 |          | ----- CMIDX_ODTIB.LBL

 |          | ----- CMIDX_ODTIB.TAB

 |          | ----- INDEX­_ODTIB.LBL

 |          | ----- INDEX­_ODTIB.TAB

 |          | ----- THMIDX_IR.LBL

 |          | ----- THMIDX_IR.TAB

 |          | ----- THMIDX_VIS.LBL

 |          | ----- THMIDX_VIS.TAB

 | ------ SOFTWARE

 |          | ----- SOFTINFO.TXT

 |          | ----- SRC

 |          |           | ----- SRCINFO.TXT

 |          |           | ----- MD5_QUBE.PL


·                    THEMIS Virtual Archive Volume

 .3 Virtual Archive Volume Contents

In compliance with the Odyssey Archive Plan [2], and as discussed in Sections 4.3 and 4.4 above, THEMIS standard data products will be made available online from the PDS THEMIS Sub Node (http://themis-data.asu.edu).  The THEMIS Virtual Archive is a very large PDS logical volume, containing all six of the THEMIS datasets.  Although the overall structure of the Virtual Archive mimics the directory structure of the single archive volumes described in the body of this text, there are several significant differences to be noted.

1.               The DATA directories are first divided into dataset directories, named according to the archive VOLUME_ID naming convention  (see Section 4.2), with x’s used as placeholders for the volume numbers.  Within these dataset directories are image subdirectories which contain data products in groups of 100 orbits.  As on the archive volumes, the image subdirectories are named following the pattern AoooXXPPP (see Section 2.5 for the pattern definition).   

2.               The BROWSE directory is divided into image subdirectories of 100 orbits, similar to the IRRDR and VISRDR DATA subdirectories from which the browse products were derived. 

3.               Both infrared and visible calibration files are available in the CALIB directory.

4.               A logical volume VOLDESC.CAT will be available at the root level for all data in the virtual archive volume.  Individual logical volume objects (ODTaaVOL.CAT) are available within the DATA-dataset directory;  these are equivalent to the VOLDESC.CAT files on the individual archive volumes.

5.               All six dataset files (ODTIBDS.CAT, ODTIEDS.CAT, ODTIRDS.CAT, ODTVBDS.CAT, ODTVEDS.CAT, and ODTVRDS.CAT) and all six release catalogs (ODTIBREL.CAT, ODTIEREL.CAT, ODTIRREL.CAT, ODTVBREL.CAT, ODTVEREL.CAT, and ODTVRREL.CAT) are available in the CATALOG directory.

6.               All index information for the dataset is included in the INDEX_ODTaa.TAB, THMIDX_IR.TAB, and THMIDX_VIS.TAB files.

7.               A GEOMETRY directory has been added containing the geometrically registered images and their associated files;  see Appendix C for more information about these data products.  

Below is the directory structure of the THEMIS virtual archive volume;  lowercase o’s are used as placeholders for the first 3-digits of the orbit number in image subdirectories names.  All directory and file names listed below are case insensitive; o’s and n’s are used to represent orbit numbers and image numbers respectively.


 .4 Virtual Volume Directory Structure

root

 | ------ aareadme.htm

 | ------ aareadme.lbl

 | ------ aareadme.txt

 | ------ errata.txt

 | ------ voldesc.cat

 | ------ browse

 |          | ----- browinfo.txt

 |          | ----- ioooxx

 |          |           | ----- iooooonnn.png

 |          |           | ----- iooooonnn_small.jpg

 |          | ----- voooxx

 |          |           | ----- vooooonnn.png

 |          |           | ----- vooooonnn_small.jpg

 | ------ calib

 |          | ----- bias_files

 |          | ----- calibinfo.txt

 |          | ----- calib.lbl

 |          | ----- calib.pdf

 |          | ----- calib_apxb.pdf

 |          | ----- calib_figs.pdf

 |          | ----- desmear_files

 |          | ----- irf_file

 |          | ----- process_htm

 |          |           | ----- process_ir.htm

 |          |           | ----- process_vis.htm

 |          |           | ----- visimage00x.gif

 |          |           | ----- visimage00x.jpg

 |          | ----- process.lbl

 |          | ----- prcess_ir.pdf

 |          | ----- process_vis.pdf

 |          | ----- temp2rad_file

 |          | ----- sensitivity_files

 |          | ----- straylight_files

 | ------ catalog

 |          | ----- catinfo.txt

 |          | ----- inst.cat

 |          | ----- insthost.cat

 |          | ----- martgt.cat

 |          | ----- mission.cat

 |          | ----- odtibds.cat

 |          | ----- odtibrel.cat

 |          | ----- odtieds.cat

 |          | ----- odtierel.cat

 |          | ----- odtigds.cat

 |          | ----- odtigrel.cat

 |          | ----- odtipds.cat

 |          | ----- odtiprel.cat

 |          | ----- odtirds.cat

 |          | ----- odtirrel.cat

 |          | ----- odtvbds.cat

 |          | ----- odtvbre..cat

 |          | ----- odtveds.cat

 |          | ----- odtverel.cat

 |          | ----- odtvgds.cat

 |          | ----- odtvgrel.cat

 |          | ----- odtvrds.cat

 |          | ----- odtvrrel.cat

 |          | ----- person.cat

 |          | ----- ref.cat

 | ------ data

 |          | ----- datainfo.txt

 |          | ----- odtibv_xxxx

 |          |           | ----- ioooxxbtr

 |          |           |           | ----- iooooonnnbtr.img

 |          |           | ----- odtibvol.cat

 |          | ----- odtiev_xxxx

 |          |           | ----- ioooxxedr

 |          |           |           | ----- iooooonnnedr.qub

 |          |           |           | ----- tlm.fmt

 |          |           | ----- roooxxedr

 |          |           |           | ----- rooooonnnedr.qub

 |          |           |           | ----- tlm.fmt

 |          |           | ----- soooxxedr

 |          |           |           | ----- sooooonnnedr.qub

 |          |           |           | ----- tlm.fmt

 |          |           | ----- odtievol.cat

 |          | ----- odtirv_xxxx

 |          |           | ----- ioooxxrdr

 |          |           |           | ----- iooooonnnrdr.qub

 |          |           | ----- roooxxrdr

 |          |           |           | ----- rooooonnnrdr.qub

 |          |           | ----- odtirvol.cat

 |          | ----- odtvbv_xxxx

 |          |           | ----- voooxxabr

 |          |           |           | ----- vooooonnnabr.img

 |          |           | ----- odtvbvol.cat

 |          | ----- odtvev_xxxx

 |          |           | ----- voooxxedr

 |          |           |           | ----- vooooonnnedr.qub

 |          |           | ----- odtvevol.cat

 |          | ----- odtvrv_xxxx

 |          |           | ----- voooxxrdr

 |          |           |           | ----- vooooonnnrdr.qub

 |          |           | ----- odtvrvol.cat

 | ------ document

 |          | ----- archsis.htm

 |          | ----- archsis.lbl

 |          | ----- archsis.pdf

 |          | ----- docinfo.txt

 |          | ----- ody_orient_point.txt

 |          | ----- sdpsis_htm

 |          |           | ----- sdpsis.htm

 |          |           | ----- sdpsis_img00x.gif

 |          | ----- sdpsis.lbl

 |          | ----- sdpsis.pdf

 | ------ geometry

 |          | ----- browse

 |          |           | ----- browse2info.txt

 |          |           | ----- ioooxxbws2

 |          |           |           | ----- iooooonnn.png

 |          | ----- browse_dcs

 |          |           | ----- dcsinfo.txt

 |          |           | ----- ioooxxdcs

 |          |           |           | ----- iooooonnndcs.png

 |          | ----- geoinfo.txt

 |          | ----- geometry_htm

 |          |           | ----- geom_img00x.gif

 |          |           | ----- geometry.htm

 |          | ----- geometry.lbl

 |          | ----- geometry.pdf

 |          | ----- odtigv_xxxx

 |          |           | ----- odtigvol.cat

 |          |           | ----- ioooxxgeo

 |          |           |           | ----- iooooonnnggg.cub.gz

 |          |           |           | ----- iooooonnnggg.lbl

 |          | ----- odtipv_xxxx

 |          |           | ----- odtipvol.cat

 |          |           | ----- ioooxxpbt

 |          |           |           | ----- iooooonnnpbt.img

 |          | ----- odtvgv_xxxx

 |          |           | ----- odtvgvol.cat

 |          |           | ----- voooxxgeo

 |          |           |           | ----- vooooonnnggg.cub

 |          |           |           | ----- vooooonnnggg.lbl

 | ------ index

 |          | ----- index_irdcs.lbl

 |          | ----- index_irdcs.tab

 |          | ----- index_odtib .lbl

 |          | ----- index_odtib .tab

 |          | ----- index_odtie.lbl

 |          | ----- index_odtie.tab

 |          | ----- index_odtig.lbl

 |          | ----- index_odtig.tab

 |          | ----- index_odtip.lbl

 |          | ----- index_odtip.tab

 |          | ----- index_odtir.lbl

 |          | ----- index_odtir.tab

 |          | ----- index_odtvb.lbl

 |          | ----- index_odtvb.tab

 |          | ----- index_odtve.lbl

 |          | ----- index_odtve.tab

 |          | ----- index_odtvg.lbl

 |          | ----- index_odtvg.tab

 |          | ----- index_odtvr.lbl

 |          | ----- index_odtvr.tab

 |          | ----- indxinfo.txt

 |          | ----- thmidx_ir.lbl

 |          | ----- thmidx_ir.tab

 |          | ----- thmidx_vis.lbl

 |          | ----- thmidx_vis.tab

 | ------ software

 |          | ----- doc

 |          |           | ----- nasaview.txt

 |          | ----- softinfo.txt

 |          | ----- src

 |          |           | ----- srcinfo.txt

 |          |           | ----- md5_qube.pl


·                    THEMIS Geometrically Registered Products

 .5 Geometry Product Overview

Geometrically registered (GEO) multi-spectral images are made available in the virtual archive volume as special data products.  The images are generated by geometrically projecting THEMIS infrared and visible radiance products (IR-RDR and VIS-RDR QUBEs) using the ISIS software (http:// isis.astrogeology.usgs.gov/Isis2/isis-bin/isis.cgi).  The resulting projected radiance image maintains the standard ISIS multispectral CUBE format, including an attached label.  Geometric parameters, such as latitude and longitude, are calculated from the image for each corner and the center point then stored in index tables (thmidx_ir.tab or thmidx_vis.tab, Section 2.7). 

For selected THEMIS images special derived products are generated from the geometrically projected images.  For infrared images these products may include projected brightness temperature (IR-PBT) records and decorrelation stretched (IR-DCS) images.  Browse images (Section 3.2.4) are provided to easily view the projected products.

THEMIS projected products are named following a pattern similar to that established for the standard data products Aooooonnnggg.ext, where the processing level “ggg” is an abbreviation representing the geographic processing applied to the image, and the “ext” is the extension appropriate for the product type (Section 3).  A detached PDS label (Aooooonnnggg.lbl, as per Section 3.2.1) is available with each GEO image and includes the cumulative processing history for the image. 

A detailed description of the data processing and special image products is available in the Mars Odyssey THEMIS: Geometric Processing User’s Guide [10].

·                    Geometry Directory Contents

The Geometry directory contains data subdirectories, related overview files, and documentation.  The data subdirectories contain the geometrically registered image data products, the associated PDS labels (where available), and projected browse images.  As with the other image directories in the virtual archive volume, the subdirectories are divided in groups of 100 orbits and named following the pattern AoooXXPPP (see Appendix A or B).  All files in this directory are provided by the THEMIS team.  The following files are contained in the Geometry directory, unless otherwise noted.

File Name

File Contents

BWS2INFO.TXT

A description of the contents of the geometry browse directory; file in GEOMETRY/BROWSE directory

DCSINFO.TXT

A description of the contents of the IRDCS logical volume written in PDS format and located in the browse_dcs subdirectory

GEOINFO.TXT

A description of the contents of the geometry directory

GEOMETRY.HTM

The THEMIS Geometric Procssing User’s Guide in HTML format

GEOMETRY.LBL

A PDS detached label that describes both GEOMETRY.TXT and GEOMETRY.PDF

GEOMETRY.PDF

The THEMIS Geometric Procssing User’s Guide as a PDF file

CMIDX_ODTIG.LBL

A PDS detached label that describes the CMIDX_ODTIG.TAB; file in INDEX directory

CMIDX_ODTIG.TAB

Cumulative index table listing release information for all IR-GEO data products released to date; file in INDEX directory

CMIDX_ODTVG.LBL

A PDS detached label that describes the CMIDX_ODTVG.TAB; file in INDEX directory

CMIDX_ODTVG.TAB

Cumulative index table listing release information for all VIS-GEO data products released to date; file in INDEX directory

INDEX_ODTIG.LBL

A PDS detached label that describes INDEX_ODTIG.TAB; file in INDEX directory

INDEX_ODTIG.TAB

Index table listing release information for all IR-GEO data products on this volume; file in INDEX directory

INDEX_ODTVG.LBL

A PDS detached label that describes INDEX_ODTVG.TAB; file in INDEX directory

INDEX_ODTVG.TAB

Index table listing release information for all VIS-GEO data products on this volume; file in INDEX directory

ODTIGDS.CAT

IRGEO data set information for the PDS catalog; file in CATALOG directory

ODTIGREL.CAT

IRGEO release information for the PDS catalog; file in CATALOG directory

ODTIGVOL.CAT

A description of the contents of the IRGEO logical volume written in PDS format and located in the odtigv_xxxx subdirectory

ODTIPDS.CAT

IRPBT data set information for the PDS catalog; file in CATALOG directory

ODTIPREL.CAT

IRPBT release information for the PDS catalog; file in CATALOG directory

ODTIPVOL.CAT

A description of the contents of the IRPBT logical volume written in PDS format and located in the odtipv_xxxx subdirectory

ODTVGDS.CAT

VISGEO data set information for the PDS catalog; file in CATALOG directory

ODTVGREL.CAT

VISGEO release information for the PDS catalog; file in CATALOG directory

ODTVGVOL.CAT

A description of the contents of the VISGEO logical volume written in PDS format and located in the in odtvgv_xxxx subdirectory