CCSD3ZF0000100000001NJPL3IF0PDS200000001 = SFDU_LABEL RECORD_TYPE = STREAM PRODUCT_CREATION_TIME = 1991-12-08 OBJECT = TEXT NOTE = "Description of the Sun software provided with the MDIM CD-ROM set" END_OBJECT = TEXT END Two programs are provided for use with the images on this CD-ROM set. The first is the XV program by John Bradley of the University of Pennsylvania. XV is a public domain program for displaying images on a Sun Spark4 workstation. The README.XV file provides information about using the program. The file xvdocs.ps contains a user manual for the program. It can be printed using the command "lpr xvdocs.ps". The source code for this program is available via anonymous ftp from export.lcs.mit.edu in the directory contrib. The other program is called READER.BIN and is described below. UNIX/SUN SPARCSTATION WITH OPEN WINDOWS 2.0 INTERFACE ----------------------------------------------------- Although the software contained on this CDROM have been used and tested, no warranty, expressed or implied, is made by NASA, the Jet Propulsion Laboratory (JPL), or the United States Geological Survey (USGS) as to the accuracy and functioning of the software and related materials, and no responsibility is assumed by NASA, JPL, or the USGS. HOW TO INSTALL: 1. Create a sub-directory to install the PDS map reader software. mkdir 2. Change directory into the sub-directory just created. cd 3. Copy the appropriate software from the SOFTWARE.SUN directory. **** THE SOFTWARE ELEMENTS TO COPY ***** reader.bin executable software.txt this document gray.pal grayscale color map mars.pal pseudo mars color map openwin.pal optional grayscale color map with a bit of the OpenWindow 2.0 default colors (to avoid color map flicker) SYSTEM REQUIREMENTS, RUN TIME and BUGS: 1. To run this software you need a Sun SparcStation with OpenWindows 2.0 (It may work with OSF/Motif). 2. The S/W was developed using OpenWindows 2.0, devGuide 1.1, and PDS Toolbox on a Sun's SparcStation 2. 3. Exiting the OpenWindows after running this program, the console color map is clobbered. Use 'clear_colormap' to restore the default console color map. I don't know what causes this. 4. The program has been tested on the 8-bit MDIM but not for 16-bit DTM. 5. This software is not supported and it is distributed as it is. Use it at your own risk. If you have any comments, improvements, or bug reports, please e-mail to: min@trantor.jpl.nasa.gov or US mail to Min-Kun Chung, M/S 301-142 Jet Propulsion Laboratory 4800 Oak Grove Drive Pasadena, CA 91109 HOW TO USE THE PROGRAM: 1. Just type in "reader.bin" The optional parameters are as follows: reader.bin is the PDS digital image map name. i.e. mi70n135.img The default is no map when first loaded. is the color map file name. i.e. gray.pal A color map file is an ASCII text file with a series of 4 number columns. The structure of the file is as follows: color index red blue green For example, a gray scale map will look as follows: 0 0 0 0 1 1 1 1 2 2 2 2 . . . . . . . . . . . . 254 254 254 254 255 255 255 255 The default is the gray scale color map. is the fraction of the color to ignore from each end, low and high. The histogram data on the PDS header is used to set STRETCH LOW and STRETCH HIGH value using this stretch_fraction value. The default is set to 0.000025. is to indicate the 16-bit DTM data is in Sun short integer format. This requires no byte swapping on the Sun. The default assumes the 16-bit data is in VAX format, and requires byte swapping. 2. The program opens a window titled "PDS MAP DISPLAY." The functions in this window are as follows: Typing in the PDS map name to load and clicking the LOAD button loads the PDS map. Typing in the map name to load and typing return does the same thing. If the map name typed in is a directory (or a blank), then a directory browser is popped up. The (current) directory is listed in the DIRECTORY of the directory browser. An optional filter may be specified in the FILTER such as *.img. Clicking once on an entry of the file name list popup displays the name on the map name entry item. Then the LOAD button can be pressed to load the map. Double clicking on the map name entry of the popup list also loads the map. Typing in the zoom factor and clicking the ZOOM button zooms the current map by that factor. Typing in the factor and typing return also does the same thing. Clicking on the COLOR button opens a color control pop window. 3. When a new map is loaded, the 8-bit histogram is examined along with the parameter, and the color map is stretched (or the STRETCH LOW and HIGH values are set) to give a better contrast automatically. 4. The PDS COLOR MAP CONTROL window allows a manual color control. Typing in the colormap name and clicking on the LOAD button loads the desired color. See above for the format of a color map. "gray.pal" and "mars.pal" colormaps are provided. On the COLOR MAP CONTROL window is a wide color bar. This shows all 256 colors allocated to the map. The left most position is color index 0 and the right most position is color index 255. The CYCLE slider shifts the color map. For example, cycle 100 will cause the original color index 0 to be changed to color index 100. CYCLE can be set more easily by clicking the middle button with the cursor on the color bar canvas. STRETCH LOW and STRETCH HIGH enable color stretch. For example if the LO value is 50 and HI value is 200, then the original color index from 0 to 255 is re-scaled to fit from 50 to 200. STRETCH LOW value and STRETCH HIGH value can be set more easily by clicking on LEFT and RIGHT mouse buttons with the cursor on the color bar canvas. Clicking on the RESET button resets the CYCLE to 0, STRETCH LOW to 0, and STRETCH HIGH to 255.