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.