CCSD3ZF0000100000001NJPL3IF0PDS200000001 = SFDU_LABEL RECORD_TYPE = STREAM PRODUCT_CREATION_TIME = 1999-01-26 OBJECT = TEXT NOTE = "Description of the FORTRAN software provided with the MOLA CD-ROM set" END_OBJECT = TEXT END There are two utility programs provided, PEDR2TAB, and AREOID. PEDR2TAB converts binary PEDR files to ASCII tables. (An earlier version, known as TABLE, is now obsolete.) Since all MOLA data are available in integer form, virtually any computer can extract the binary data in full precision. AREOID calculates the areoid reference surface at an arbitrary point on the planetary surface, so that other terrain models may be compared. These programs are written in the stable and portable Fortran-77 language, with MIL-STD-1753 features and other extensions. Source code is provided, with executables for most common workstations and personal computers. The user interface differs slightly, however. Although the software contained herein has been tested, no warranty, expressed or implied, is made by NASA, the Jet Propulsion Laboratory (JPL), or the Goddard Space Flight Center (GSFC), as to the accuracy and functioning of the software and related materials, and no responsibility is assumed by NASA, JPL, or GSFC. HOW TO INSTALL PROGRAMS: 0. For PEDR2TAB, you must choose the appropriate version of the source code and executable from the directories BIGENDIAN (Mac, Sun, HP, RS6000, SGI, IBM370, etc.) or SMALLENDIAN (VAX, ALPHA, IBM PC or compatible). AREOID is architecture-independent, apart from user interface. 1. Copy the executable binary to a directory where it will be found. If the hardware platform and operating system you use are not compatible, recompilation may be necessary. The executables may need to be renamed to suit your architecture. The Mac executables are compiled separately for the PowerPC and 68K platforms. 2. Copy the preferences or .prm file to the working directory, edited according to one's needs, noting the comments therein. The PEDR files need not be in the same directory, but some implementations may try to create output in the PEDR directory, unless a single explicit output file is given. ----------------------------------------------------------------------------- PROGRAM PEDR2TAB - output ascii table(s) from MOLA PEDRs, one line for each altimetry shot detected. The user may choose to see all ranges, or only those that are/are not ground hits, in a selected region. The user may output any of eight groups of MOLA instrument values. By default, topography, range, planetary radius, and flags are output. See the document "PEDR2TAB.FMT" for names and descriptions of the MOLA output. By default a single file "MOLA.TAB" is created containing all selected shots. The file "PEDR2TAB.PRM" allows the user to select the parameters to output and the region to select, and to change the output conventions. As an option, each PEDR file in a list is searched for frames in the selected region and lines are output, either to one big file, or separate files by the same name with a suffix ".TAB". On computers with a command-line-interface, one may either invoke "PEDR2TAB" for a single file, or PEDR2TAB with no arguments to read a list of files. SYSTEM REQUIREMENTS, RUN TIME ENVIRONMENT and BUGS: 1. Workstations with big-endian numerics (i.e., SUN) use the UNIX versions. PC's using little-endian numerics use a version with a byte-swapping function, as do DEC ALPHAs and VAXes. DEC compilers define record length differently from other systems (irecl=194 instead of 776). They use only modest memory allocation via the FORTRAN runtime environment. 2. This software is not supported by the MOLA Instrument and Science Teams. The PEDR Software Interface Specification 2.7 is the authoritative document, and should be consulted if questions arise. If you have any comments, improvements, or bug reports, please e-mail to: Gregory.Neumann@gsfc.nasa.gov COMMAND-LINE-INTERFACE PEDR2TAB without arguments queries on stdin for the name of a file which may be either a PEDR with extension ".B" or ".b" , or a list of PEDR filenames. A single ASCII output file may be generated with a user-specified name, defaulting to "MOLA.TAB", or individual PEDR-named files with a user-specified suffix, defaulting to ".TAB". PEDR2TAB generates output file(s) as described above. Either way, console messages are written to stdout. MAC INTERFACE The program uses the Language Systems Fortran FILE=* extension to open a file through a Finder dialog window. Output is generated as described above for the command-line interface. If the file is a list, folder paths must be qualified with colons (:), for example, "MGSL0001:PEDR:AP000XX:AP00003K.B". If copied by ftp or other means, PEDR's must be transferred in raw or binary mode. It is very important that the binary files have a filetype of "TEXT" or other document type when accessed, as the OPEN routine doesn't see unknown file types. The output file (defaults to MOLA.TAB) is a TEXT document with creator "MPS", for MacIntosh Programmers Workshop, but should be readable by a spreadsheet program or text processor. ----------------------------------------------------------------------- PROGRAM AREOID - calculate equipotential topographic reference surface. ----------------------------------------------------------------------- This program allows one to compare the topography on the CD with planetary radii obtained from other sources. It accepts three columns of input in free format, lat-lon-radius or lon-lat-radius, and outputs the corresponding areoid radius and topography. Units are areocentric degrees of arc and meters. It assumes a degree-and-order 70 potential model, and an equatorial radius of 3396000. meters. The "GMM1.2" file is an interim solution incorporating the earlier GMM-1 model and MGS tracking data through SPO-1. It is for reference only. It is not a validated science data product, nor is it to be used for any purpose other than comparison with this MOLA release. UNIX INTERFACE The program optionally accepts alternate potential models from the command line. It is designed as a filter, taking from standard input and writing to standard output, either of which may be redirected or pipes. MAC INTERFACE The program uses the Language Systems Fortran FILE=* extension to open input and output files through a Finder dialog window. A single output ASCII table is generated when the program is run. It is very important that the input file have a filetype of "TEXT" or other non-application type when accessed. The output file (defaults to AREOID.TAB) is an "MPW document" but can be read by a spreadsheet program or text processor. **** THE SOFTWARE ELEMENTS TO COPY ***** softinfo.txt this document pedr2tab.fmt Output format description PROGRAM PEDR2TAB: pedr2tab. Executables for various platforms. See README files. pedr2tab.f FORTRAN source for UNIX programmers pedr2tab.DEC.f FORTRAN source for Digital Equipment (VAX, ALPHA) pedr2tab_PC.f FORTRAN source for Microsoft PC's (WinXX, DOS) pedr2tab_PCLINUX.f FORTRAN source for PC's running LINUX pedr2tab.MAC.f FORTRAN source for MacOS programmers PEDR2TAB.PRM Preferences (parameters) read by all versions FILELIST Sample list of PEDR filenames PROGRAM AREOID: areoid. various executables GMM1.2 potential model used in the SPO-1 release GMM1.3 potential model used in the SPO-1&2 release areoid.f.UNIX FORTRAN source for UNIX programmers areoid.f.MAC FORTRAN source for MacOS programmers areoid.prefs runtime preferences
This software is under development and benefits from community feedback.
Back to MOLA home page