PDS_VERSION_ID     = PDS3
RECORD_TYPE        = STREAM
OBJECT             = TEXT
  PUBLICATION_DATE = 1999-12-06
  NOTE             = "Description of software provided with the
    MGS MOLA archive volumes"
END_OBJECT         = TEXT
END

SOFTWARE ON THE MGS MOLA ARCHIVE VOLUMES

The Software directory on MGS MOLA archive volumes contains three programs
for accessing data in PEDR files. They are:

   MPROF - an IDL script that generates topography profiles
   SPLITORB - an IDL script that separates a PEDR into single orbits
   PEDR2TAB - a Fortran program that generates an ASCII table of
     PEDR data (replaces an earlier program called PDCODE)

The programs on this archive volume are the latest versions that were
available. They work with the MOLA PEDRs as described in the PEDR
Software Interface Specification version 2.718. Updates to these
programs, and possibly additional software, are posted as they become
available on the PDS Geosciences Node web site at
http://wwwpds.wustl.edu.

This software is provided for Sun/UNIX and PC/Windows platforms, and a
Macintosh version of PEDR2TAB is also provided. The MOLA Science Team
web site has the same software plus variants for other architectures;
see http://ltpwww.gsfc.nasa.gov/tharsis/software.html. Questions about
the software on this archive volume may be addressed to the PDS
Geosciences Node at geosci@wunder.wustl.edu.  For information about
additional versions of this software, or about the format of MOLA data
products, contact Gregory Neumann, MOLA Science Team, at
Gregory.Neumann@GSFC.NASA.GOV.


1. MPROF

MPROF is a script for use with the commercial image processing
software package IDL, a product of Research Systems, Inc., 2995
Wilderness Place, Boulder, Colorado 80301
(http://www.rsinc.com). MPROF can be used only on a computer that has
IDL software installed. The script generates topography profiles from
PEDR data products.  Instructions for using the script are in the file
mprfinfo.txt in the MPROF directory.

MPROF was written by C. David Brown, Dept. of Earth and Planetary 
Sciences, Washington University.

2. SPLITORB

SPLITORB is an IDL script that reads a PEDR containing data from
multiple orbits and generates separate PEDR files each containing data
from a single orbit. This script is meant to accompany the MPROF script
described above. MPROF was written to operate on PEDR files that contain
only one orbit's worth of data. A Mapping Phase PEDR must first be
broken down into separate orbits using SPLITORB before MPROF can be used
to plot the data.

SPLITORB was written by Judd Bowman, PDS Geosciences Node, Washington
University. It was adapted from the C program SPLITPEDR by C. David 
Brown, Dept. of Earth and Planetary Sciences, Washington University.

3. PEDR2TAB

PEDR2TAB is a program that reads MOLA PEDR files and produces an ASCII
table of selected fields, 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. The program is
written in Fortran 77 with MIL-STD-1753 and other extensions.

PEDR2TAB was written by Gregory Neumann, MOLA Science Team,
NASA/Goddard Space Flight Center. 


3. Contents of the Software Directory

   SOFTINFO.TXT      Description of files in SOFTWARE directory.
  
   [MPROF]           Directory containing MPROF software to
                     generate PEDR topography profiles.
   
     MPRFINFO.TXT    Instructions for using MPROF.PRO.
     MPROF.PRO       Script for use with UNIX or PC versions of IDL.
   
   [PEDR2TAB]        Directory containing PEDR2TAB software
                       to generate PEDR ASCII tables.

     [MAC]           Directory containing Macintosh version.

       MOLA.LBL      Example PDS label for PEDR2TAB output.
       P2TAB68K.HQX  BINHEX file containing executable
                       program compiled for Macintosh 68K.
       P2TABFPU.HQX  BINHEX file containing executable
                       program compiled for Macintosh 68K FPU.
       P2TABPPC.HQX  BINHEX file containing executable
                       program compiled for PowerPC.
       P2TINFO.TXT   Instructions for using PEDR2TAB.
       PEDR2TAB.F    Fortran 77 source code for Macintosh.
       PEDR2TAB.PRM  Preferences file to be edited by user.
            
     [PC]            Directory containing PC/Windows version.
       MOLA.LBL      Example PDS label for PEDR2TAB output.
       P2TINFO.TXT   Instructions for using PEDR2TAB.
       PEDR2TAB.EXE  Executable file compiled for MS-DOS.
       PEDR2TAB.F    Fortran 77 source code for PC/Windows.
       PEDR2TAB.PRM  Preferences file to be edited by user.
            
     [SUN]           Directory containing Sun/UNIX version.
       MOLA.LBL      Example PDS label for PEDR2TAB output.
       P2TINFO.TXT   Instructions for using PEDR2TAB.
       PEDR2TAB.EXE  Executable file compiled for Solaris 2.4.
       PEDR2TAB.F    Fortran 77 source code for Sun/UNIX.
       PEDR2TAB.PRM  Preferences file to be edited by user.
        
   [SPLITORB]        Directory containing SPLITORB software
                       to separate a PEDR into single orbits.
            
     SPLTINFO.TXT    Instructions for using SPLITORB.PRO.
     SPLITORB.PRO    Script for use with UNIX or PC versions of IDL.


