PDS_VERSION_ID = PDS3 RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 80 OBJECT = TEXT INTERCHANGE_FORMAT = ASCII PUBLICATION_DATE = 1994-10-01 NOTE = "Description of software directory provided with the Clementine CD-ROM set" END_OBJECT END Clementine Software This directory contains software that provides display and processing capabilities for the Clementine data archived on this CD-ROM set. 1. Decompression Software The PCDOS, MAC and SUNOS subdirectories all contain software which can be used to decompress the Clementine raw images. CLEMDCMP will decompress the raw image and output it into one of four formats: 1) decompressed PDS labeled file which contains PDS labels, the histogram object, and an image object, either the browse image or the full image 2) decompressed image file, no labels 3) a decompressed image in the GIF format 4) a decompressed image in the TIFF format The source code is provided in the SOURCE subdirectory, of each platform subdirectory. Instructions on how to install and run the software is in the file CLEMDCMP.TXT in the DOC subdirectory, of each platform subdirectory. Because the image decompression program, CLEMDCMP, requires a Discrete Cosine Transform (DCT) it may take several minutes to decompress an image on hardware platforms with slow processors. For example, in tests on a Macintosh IIci, the decompression takes approximately 4 minutes. CLEMDCMP has been tested on hardware platforms with modern processors, such as an Intel 486DX2/66-Mhz, and the decompression takes just several seconds. 2. Display Software CLIMDISP in the PCDOS/BIN subdirectory is an image display and processing program. It can be used to display Clementine uncompressed images and histograms. See CLIMDISP.TXT in the PCDOS/DOC subdirectory for instructions on how to install and run the program. Note: CLIMDISP currently can not create GIF formatted files for the Clementine images. Additionally, it can not read the version of GIF files created by the Clementine Decompression (CLEMDCMP) program which is also included on the Clementine EDR Archive CD-ROMs. If you wish to display Clementine images with CLIMDISP, generate a PDS format image file when decompressing with CLEMDCMP. A special version of NIH Image, found in the MAC/BIN subdirectory, will display PDS decompressed Clementine images. This program is stored in a Stuffit file which is in BinHex format. See IMAGE.TXT in the DOC subdirectory for instructions on how to install and run the program. The Clementine EDR image files use the PDS label constructs RECORD_TYPE = "UNK", and ^IMAGE = xxxxx to define the structure of the file. This form of the labels is not supported by the current versions of IMDISP and IMAGE4PDS that are widely distributed by the PDS. To read Clementine decompressed formatted files use the version of IMAGE and CLIMDISP programs that are supplied on this CD-ROM. The Clementine versions CLIMDISP and IMAGE have been tested only on the Clementine data products. No attempt has been made to determine if the Clementine program versions will work on any other PDS data product. XV is a shareware program for displaying images. XV was written by John Bradley of the University of Pennsylvania. It is in a compressed tar file in the SUNOS/SOURCE subdirectory. See XV.TXT in the SUNOS/DOC subdirectory for instructions on how to decompress and untar this file. XV will not display PDS labeled files, but will display TIF and GIF formatted files. The XV software, for image display on a sun/unix environment, is not able to read the Clementine PDS labeled files. If you intend to use XV as the display system for the CLementine data products, output GIF or TIFF images with the CLEMDCMP program. 3. SPICE Software Included on one of the ancillary disks associated with this volume set is the Navigation and Ancillary Information Facility (NAIF) Toolkit and some additional NAIF software. The major component of the NAIF Toolkit is the SPICE Library (SPICELIB), a collection of portable ANSI FORTRAN 77 subroutines. Some of these subroutines are used to read the SPICE kernel files containing Clementine ancillary data, such as spacecraft position, spacecraft attitude, instrument orientation and target body size, shape and orientation. Other SPICELIB subroutines may be used to compute typical observation geometry parameters--such as range, lighting angles, and LAT/LON of camera optic axis intercept on the target body. Several utility programs and SPICELIB demonstration programs are also included in the Toolkit. Versions of this software tested on many popular platforms are provided, as are instructions for porting the code to additional platforms. The FORTRAN subroutines can be called from a user's own application program, whether written in FORTRAN or C, or possibly yet another language. Consult your compiler's Reference Manual for instructions. One of the NAIF programs included in this software collection is PICGEO (for Picture Geometry). It was used to compute all of the geometric parameters appearing in the image labels and index tables. It is included so that users may clearly see the algorithms used in computing these quantities, and so that recalculation of image label geometry parameters using revised algorithms, or adding additional parameters, can be easily achieved. 4. Miscellaneous Image Processing Software MSHELL is an interactive command line and menu driven Image and Signal processing language, developed by ACT Corp., which runs under the Microsoft Windows 3.x or Microsoft NT. MSHELL provides powerful scientific image and signal visualization and processing. A number of custom features were added to the MSHELL Image/Signal Processing Environment to support the Clementine Program. This software is included on one of the ancillary disks associated with this volume set, and will be under a subdirectory of the PCDOS directory. 5. Software Directory Hierarchy The SOFTWARE subdirectories are based on hardware platforms. Under each platform subdirectory, the executables are in the BIN subdirectory, the source is in the SOURCE subdirectory and documentation on each program is in the DOC subdirectory. Each DOC subdirectory contains a file, SOFTWARE.CAT which is part of the PDS Software Inventory describing software available within the Planetary Science Community. The contents of the SOFTWARE directory are shown below. [SOFTWARE] | |-SOFTINFO.TXT | | | | |-[PCDOS] | | | |-[BIN] | | | | | |-CLEMDCMP.EXE | | | | | |-CLIMDISP.EXE | | | | | |-CLIMDISP.HLP | | | |-[SOURCE] | | | | | |-CLEMDCMP.C | | |-PDS.C | | |-BITSTRM.C | | |-DECOMP.C | | |-HUFFMAN.C | | |-WRITEGIF.C | | |-PDS.H | | |-JPEG_C.H | | | | | |-CLEMDCMP.MAK | | | |-[DOC] | | | |-CLEMDCMP.TXT | | | |-CLIMDISP.TXT | | | |-SOFTWARE.CAT | |-[MAC] | | | |-[BIN] | | | | | |-CLEMDEXE.HQX | | | | | |-IMAGE.HQX | | | |-[SOURCE] | | | | | |-CLEMDSRC.HQX | | | |-[DOC] | | | |-CLEMDCMP.TXT | | | |-IMAGE.TXT | | | |-SOFTWARE.CAT | |-[SUNOS] | |-[BIN] | | | |-CLEMDEXE.TZU | |-[SOURCE] | | | |-CLEMDSRC.TZU | | | |-XV3A.TZ | |-[DOC] | |-CLEMDCMP.TXT | |-XV.TXT | |-SOFTWARE.CAT