CCSD3ZF0000100000001NJPL3IF0PDSX00000001 PDS_VERSION_ID = PDS3 RECORD_TYPE = FIXED_LENGTH RECORD_BYTES = 80 OBJECT = TEXT PUBLICATION_DATE = 1994-08-01 NOTE = "Description of software provided with the Magellan FMAP CD-ROM set" END_OBJECT = TEXT END Magellan FMAP Software Although the software contained on this CDROM has 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. 1. Reprojection Software The VAXVMS, SUNOS, PCDOS, and MAC subdirectories all contain software which can be used to change the projection parameters of an FMAP image tile. The program NEWMAP can be used to change the center longitude and/or map projection of a tile. This program will take as input a file in the Sinusoidal Equal-Area map projection and will create an output file in either the Sinusoidal Equal-Area or Simple Cylindrical map projection. The primary use of this program is to change the center longitude of a Sinusoidal Equal-Area image so that it can be mosaicked with another Sinusoidal Equal-Area image (the center longitude of Sinusoidal Equal-Area images must be the same in order to be mosaicked). NEWMAP allows you to determine the resampling technique to be used for reprojection. The resampling options available are Nearest Neighbor and Bilinear. The Bilinear option requires you to specify a null sample density value (normally 0) which is not used in the resampling calculations. The NEWMAP program was designed to work specifically for FMAP image products. Generality was not added to the software to allow for the continual change of PDS standards over time. The results produced by running the software on other products cannot be predicted or guaranteed. The NEWMAP program produces an output log file in which all command line arguments and map label information are stored for each execution of the program. This file will be stored in a location defined by the user. The default is to store this file in the same directory where the software resides. The log file is a standard ASCII file that can be edited or printed. 2. Mosaicking Software The VAXVMS, SUNOS, PCDOS, and MAC subdirectories all contain software which can be used to mosaic FMAP image tiles. The MOSAIC program supports files in either the Sinusoidal Equal-Area or Simple Cylindrical map projection. The input file's location in the mosaic file is based on map label parameters. In order to mosaic two files, both files must 1) be in the same map projection, 2) have the same map scale, 3) have the same center longitude (if they are in Sinusoidal Equal-Area projection), and 4) have the same center latitude (if they are in Simple Cylindrical projection). You can specify the entire input file to be mosaicked or a sub-area of it. The program will determine the input file's location in the mosaic file based upon the latitude and longitude ranges of each file. If the output mosaic file does not exist prior to execution of the MOSAIC program, then the map label parameters of the input file will be transferred to the output file, unless different values for the parameters are specified during input. The MOSAIC program was designed to work specifically for FMAP image products. Generality was not added to the software to allow for the continual change of PDS standards over time. The results produced by running the software on other products cannot be predicted or guaranteed. The MOSAIC program produces an output log file in which all command line arguments and map label information are stored for each execution of the program. This file will be stored in a location defined by the user. The default is to store this file in the same directory where the software resides. The log file is a standard ASCII file that can be edited or printed. 3. Miscellaneous Software Two image display programs are also supplied on this disk. The IMAGE program in the MAC subdirectory is discussed in the IMAGE.TXT file in that same directory. The IMDISP program in the PCDOS subdirectory is discussed in the IMDISP.TXT file in that same directory. NOTE: If you use Adobe Photoshop on a Macintosh to open the image files on this disk as raw images and the image does not display properly, then try swapping the height and width parameters that are determined by Adobe Photoshop. Also, when opening the text files using Microsoft Word on a Macintosh, you must use a monospaced Courier type font or the files will appear to be incorrectly formatted. All text files on this disk use a carriage return/line feed sequence as the line delimiter. In order to convert the text files to Macintosh format, use the Apple File Exchange utility with the MS-DOS to Mac option. 4. Installing and Using Software on an Apple Macintosh The NEWMAP.HQX and MOSAIC.HQX files contain Stuffit archives that have been translated to BinHex format. To install the software, first copy the BinHex files to a Macintosh. Then run the Stuffit program, version 3.0.5 or later. Select the "BinHex Decode" action in the "Translate" menu. This will transform the files into Stuffit Archive files named NEWMAP.SIT and MOSAIC.SIT. Select the "Open" action in the "File" menu to extract the archives. The Newmap and Mosaic software was created using Version 3.2.3 of the Macintosh Programmers' Workshop development software. Double click on the Mosaic icon to execute the program. Using the "File" menu, enter the names of the input and output files. You must specify if the output file is a new file or an old file when entering the output file information. Using the "Input" option of the "Parameters" menu, enter the input file information. Using the "Output" option of the "Parameters" menu, enter the output file information. The output file information goes into effect only if the output file does not exist prior to execution of the Mosaic program. Using the "Log File" option of the "Parameters" menu, enter the name and location of the output log file. Double click on the Newmap icon to execute the program. Using the "File" menu, enter the names of the input and output files. Using the "Output Projection" option of the "Parameters" menu, choose either Sinusoidal Equal-Area or Simple Cylindrical as the output map projection. If you choose Sinusoidal Equal-Area, the program will prompt you for the center longitude of the output file. Using the "Resampling Technique" option of the "Parameters" menu, choose Nearest Neighbor or Bi_Linear for the resampling technique to be used. If you choose Bi_Linear, the program will prompt you for a null value. Using the "Log File" option of the "Parameters" menu, enter the name and location of the output log file. 5. Installing and Using Software on an IBM PC Running MS-DOS The files NEWMAP.EXE and MOSAIC.EXE in the PCDOS subdirectory can be run as is directly from the CD-ROM. The NEWMAP.EXE and MOSAIC.EXE software was created using Version 9.5 of the Watcom C/C++ 32-bit development software. DOS4GW.EXE is a DOS Extender produced by Rational Systems, Inc. and was supplied with the Watcom compiler. DOS4GW.EXE serves as a memory manager for NEWMAP.EXE and MOSAIC.EXE and, as a result, must be resident in the same directory as NEWMAP.EXE and MOSAIC.EXE in order for them to work. The programs have been tested on an IBM PC 386 using DOS 5.0 and an IBM PC 486 using DOS 6.0. Use the following commands to compile and link the programs (using Watcom C/C++ 32-bit Version 9.5): wcl386 /l=dos4g mosaic.c wcl386 /l=dos4g newmap.c Brief help information is available for each program by executing a command line with the program name only. The help information includes the command line syntax and a description of the command line arguments needed by the programs. 6. Installing and Using Software on a SUN UNIX Workstation The files NEWMAP.EXE and MOSAIC.EXE in the SUNOS subdirectory can be run as is directly from the CD-ROM. These programs have been tested on a SUN SPARCstation running version 4.1.3 of SunOS. The programs were compiled and linked using the cc compiler which is available with the System V software installation option under SunOS 4.1. Use the following commands to compile and link the programs: cc -o mosaic mosaic.c /usr/lib/libm.a cc -o newmap newmap.c /usr/lib/libm.a Brief help information is available for each program by executing a command line with the program name only. The help information includes the command line syntax and a description of the command line arguments needed by the programs. 7. Installing and Using Software on a VAX Running VMS The files NEWMAP.EXE and MOSAIC.EXE in the VAXVMS subdirectory can be run as is directly from the CD-ROM. These programs have been tested on a VAX running VMS Version 5.5-2. Use the following commands to compile and link the programs: define lnk$library sys$library:vaxccurse.olb define lnk$library_1 sys$library:vaxcrtl.olb cc mosaic.c link mosaic.c cc newmap.c link newmap.c On a VAX you will need to "install" the programs to be able to use command line arguments by using the following commands: newmap :== $DISKNAME:[DIRECTORY]newmap.exe mosaic :== $DISKNAME:[DIRECTORY]mosaic.exe where DISKNAME and DIRECTORY are the disk drive and directory where the programs are stored. Brief help information is available for each program by executing a command line with the program name only. The help information includes the command line syntax and a description of the command line arguments needed by the programs.