Thermal Emission Imaging System

2001 Mars Odyssey

 

 

 

 

 

STANDARD DATA PRODUCT

ARCHIVE VOLUME

SOFTWARE INTERFACE SPECIFICATION

 ( THEMIS Archive Volume SIS )

 

 

 

 

 

 

 

 

 

 

Version 2.0

January 1, 2006

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

 


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

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

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

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

3. Archive Volume Format................................................................................................................. 7

3.1 Disk Format........................................................................................................................... 7

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

3.2.4 PNG and JPG File Formats............................................................................................... 9

3.2.5 IMAGE File Format.......................................................................................................... 9

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

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

 Archive Volume Generation............................................................................................................ 10

4.1 Interface Media Characteristics............................................................................................. 10

4.2 Labeling and Identification..................................................................................................... 10

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

4.4 Data Transfer and Validation Methods.................................................................................. 12

5. Support Staff and Cognizant Persons........................................................................................... 12

5.1 THEMIS Archive Volume Staff............................................................................................. 12

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

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

A.1 IREDR Volumes: ODTIEv_xxxx.......................................................................................... 14

A.2 VISEDR Volumes: ODTVEv_xxxx...................................................................................... 15

A.3 IRRDR Volumes: ODTIRv_xxxx.......................................................................................... 16

A.4 VISRDR Volumes: ODTVRv_xxxx...................................................................................... 18

A.5 IRBTR Volumes: ODTIBv_xxxx.......................................................................................... 19

A.6 VISABR Volumes: ODTVBv_xxxx...................................................................................... 20

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

B.1 Virtual Archive Volume Contents.......................................................................................... 23

B.2 Virtual Volume Directory Structure....................................................................................... 23

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

C.1 Geometry Product Overview................................................................................................ 27

C.2 Geometry Directory Contents............................................................................................... 27

 

 


ACRONYMS AND ABBREVIATIONS

 

ABR

Apparent Brightness Record

ASCII

American Standard Code for Information Interchange

ASU

Arizona State University

BTR

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

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 are available as special, non-standard data products derived from the RDR QUBE. The THEMIS Team at the ASU Mars Space Flight Facility is responsible for generating these products and assembling the archive.