Clementine Software

This page describes and points to software that provides display and processing capabilities for the Clementine data archived on the CD-ROM set and available in NRL Clementine WWW site. The software is listed below by platform. Below that is an overview of the software's functionality. The individuals supporting this web site have limited experience with the software and consequently can not offer too much advice with regard to it's use.

Operating System	Binaries	Documentation	Source
SunOS	clemedexe.tzu	clemdcmp.txt software.cat xv.txt	clemdsrc.tzu xv3a.tz
MacOS	clemdexe.hqx image.hqx	clemdcmp.txt image.txt software.cat	clemdsrc.hqx
DOS	clemdcmp.exe climdisp.exe climdisp.hlp	clemdcmp.txt climdisp.txt software.cat	bitstrm.c clemdcmp.c clemdcmp.mak decomp.c huffman.c jpeg_c.h pds.c pds.h

Decompression Software

The PCDOS, MAC and SUNOS software can be used to decompress the Clementine raw images. CLEMDCMP will decompress the raw image and output it into one of four formats:

decompressed PDS labeled file which contains PDS labels, the histogram object, and an image object, either the browse image or the full image
decompressed image file, no labels
a decompressed image in the GIF format
a decompressed image in the TIFF format

The source code is provided for each platform. Instructions on how to install and run the software is in the file CLEMDCMP.TXT.

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.

Display Software

CLIMDISP is an image display and processing program. It can be used to display Clementine uncompressed images and histograms. See CLIMDISP.TXT 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 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. See XV.TXT 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.

Send comments to webmaster@www.nrl.navy.mil