README.txt: Introduction to the Viking CIRTM CD-ROM Dale D. Noss, 7/20/94 Overview: This CDROM contains data from the Viking Infrared Thermal Mapper (IRTM) investigation. The two Viking orbiters were active in orbit about Mars during the years 1976 to 1980. This CD-ROM is an update of a software/data package produced by the Radiometry Testbed Node of the Planetary Data System (PDS). The original software/data product, collectively referred to as the RAD system, has been rewritten to run on UNIX workstations. The IRTM data set created by RAD has been reformatted using the Thermal Emission Spectrometer (TES) Database Management System created by Mark Mann at the Mars Global Surveyor Space Flight Facility at Arizona State University. Because the IRTM data set is now stored in TES database format, the software used to access the data had to be completely rewritten. The resulting package, called CIRTM, is a C language software/data product for use on Sun Microsystems Sparc workstations under a UNIX environment running OpenLook GUI. The CIRTM data set is now stored on two CD-ROM volumes. Volume 1 contains data from Viking Orbiter 1, while volume 2 contains data from Viking Orbiter 2. Both volumes contain the same software and documentation directories described here. Note: The CIRTM and TDB software is stored on CD-ROM as tarfiles. To see the directories discussed below, first extract the tarfile's contents. TO UNPACK THE CIRTM AND TDB SOFTWARE: 1) Find roughly 17 Mb of hard empty disk space. In our example let the package be installed in the user's root directory. 2) Mount either volume of the CIRTM CD-ROM. Assume CD-ROM path is /cdrom/ 3) cd ~ 4) cp /cdrom/tdb.tar ~ 5) cp /cdrom/cirtm.tar ~ 6) cp -r /cdrom/dsc ~/dsc 7) tar xvf tdb.tar 8) tar xvf cirtm.tar 9) rm tdb.tar cirtm.tar 10 cd ~/cirtm/cirtm_doc 11) lpr -v CIRTM_User_Manual.ps 12) Read the CIRTM User Manual. More installations instructions can be found in section 5.1. The software for the CIRTM package is located in the cirtm directory. Inside cirtm, users will find documentation, source code and makefiles to compile the software. The most important documentation is in the cirtm/cirtm_doc/CIRTM_User_Manual.ps file. This is a Postscript file that details how to set up the CIRTM package, how the user interface works and how to create new applications. The TES database (TDB) software is located in the tdb directory and contains source code and documentation. It should be pointed out that the TDB is a free standing package in no way dependent upon CIRTM. Rather, CIRTM uses the TDB as a "black box" reader for the CIRTM data set. Several large pieces of documentation were scavenged from the older RAD produced IRTM CD-ROM. These documents contain important information about the IRTM instruments, Viking Missions and IRTM data set. However some portions of the documents are now obsolete, because they contain references to the IRTM data set's pre-TDB format. The doc directory contains most of these RAD IRTM files. The VOLDESC.txt file, found in the root directory of this CD-ROM, also contains a wealth of useful information. Contents: readme.txt This file voldesc.txt General information about IRTM instrument, calibration and data. Removed from old RAD IRTM CD-ROM. Some information regarding data storage is out of date. cirtm.tar A tarfile which contains the directories below: /**********************************************************************/ cirtm: Main directory for the CIRTM package. Contains 6 subdirectories listing below. cirtm/cirtm_doc: Contains Postscript Users Guide to CIRTM. cirtm/cirtm_inc: Contains all include files for the CIRTM package cirtm/cirtm_main: Contains CIRTM applications and irtm_envs file which users must edit to set environmental variables correctly. irtm_envs makefile xbin.c xdir.c xfind.c xplot.c xprint.c cirtm/cirtm_src: Contains source code for all CIRTM package functions. cirtm/user_doc: Directory for user documentation. cirtm/user_inc: Directory for user include files. cirtm/user_main: Directory for user applications. makefile xfunc.c cirtm/user_src: Directory for user interface functions. text_func.c xview_func.c /*******************************************************************/ doc: Contains old documentation from USGS IRTM CD-ROM. Some information is out of date, but still quite useful. dsc: Contains four descriptor files for use with TES database tdb.tar A tarfile containing the directories shown below: /*******************************************************************/ tdb: Contains files for the Thermal Emission Spectrometer (TES) database required by CIRTM. tdb/doc: Contains Postscript file of TES Database Management System Software Specification Document. tdb/inc: Contains TES database include files. tdb/lib: Contains TES database library. tdb/src: Contains TES database source code. /**********************************************************************/ vo1_data: Contains all data files for the Viking Orbiter 1 IRTM instrument. Refer questions regarding this CD-ROM to: Dale D. Noss Mars Global Surveyor Space Flight Facility noss@steph.la.asu.edu or (602) 965-0206 The two individuals listed below both made critical contributions to the generation of this CD-ROM. Mark Mann Philip R. Christensen