molasearch Documentation

molasearch - Find MOLA PEDR filenames for specified time range
MOLASEARCH will find the MOLA PEDR files that correspond to a
specified time range found in Updated MOLA Cumulative Index.
The time range can be specified by either providing a moc image
(with the FROM parameter) or a start and stop J2000 time
(START and STOP parametes).

This tool is especially useful when locating mola pedr files
for a particular moc frame of interest.

The pedr files that correspond to the specified time range
is placed in the output list specified by the TO parameter.

This procedure is used in combination with procedures
"mocftp", for downloading a mola pedr,  and "mola2isis",
for extracting mola profiles from the pedr for use by
the ISIS system.


***EXECUTION ALTERNATIVES***

This procedure can run within the ISIS environment, but outside
TAE.  At the unix prompt the following command can be
entered:

molasearch [FROM=(moc.imq or moc.cub)] FILEOUT=pedr.lis
           [START=J2000startTime STOP=J2000stopTime]
           [INDEX=molaIndex] [EXISTS=overwrite/rename]

molasearch [(moc.imq or moc.cub)] pedr.lis
           [J2000startTime] [J2000stopTime] [molaIndex]
           [overwrite/rename]

molasearch.pl [(moc.imq or moc.cub)] pedr.lis
              [J2000startTime] [J2000stopTime]
              [molaIndex] [overwrite/rename]

Examples
molasearch from=m0203098.imq to=m0203098pedr.lis
           index=/work3/mgs/mola/data/updatedindex exists=overwrite

molasearch m0203098.cub m0203098pedr.lis -- --
           /work3/mgs/mola/data/updatedindex

molasearch.pl  -- pedr.lis 7892345 7899345 /work3/mgs/mola/data rename



Programmer:  Glenn Bennett, USGS, Flagstaff, 15 Jan 2001
             Eric Eliason, U.S.G.S., Flagstaff, 01 Feb 2001
_Ver	$Id: molasearch.html,v 1.4 2006/07/19 03:06:17 isismgr Exp $

MOC image in PDS or ISIS format.
Either FROM or START,STOP must
be provided but not both.

--

Output file containing list of
PEDR files found for specifed
data coverage.

NONE

J2000 start time.
If START is specified then STOP
must also be specified

--

J2000 stop time.
IF STOP is specified then START
must also be specified

--

Optional pedr cumulative index
file name.         DEFAULT:
$ISISMGSDATA/pedcmidx_update.tab

--

'overwrite' or 'rename'
existing PEDR.lis    (Optional)

--

ADDITIONAL NOTES:

Parm	Description
FROM	The FROM parameter specifies a moc image file. If FROM is specified, molasearch will look at the label information of the moc image to determine its J2000 time range. The procedure then looks at $ISISMGSDATA/pedcmidx_update.tab file to determine what pedr file corresponds to the coverage of the moc image. The format of the moc image can be either a PDS or ISIS cube file. Note that either the FROM parameter or the START,STOP parameters can be specified but not both.
FILEOUT	The FILEOUT parameter provides the name of the output file that lists the name of the pedr files that correspond to the specified data coverage. This file can be passed to "mocftp" to download the mola pedr files from the "pds-geosciences.wustl.edu" site or some alternate ftp or web site.
START	J2000 time of start of data coverage. Molasearch will find the pedr files that correspond to the time coverage specified by START and STOP. If START is specified then STOP must also be specified.
STOP	J2000 time of end of data coverage. Molasearch will find the pedr files that correspond to the time coverage specified by START and STOP. If STOP is specified then START must also be specfied.
INDEX	You may optionally specifiy a pedr cumulative index file. The default file used is $ISISMGSDATA/pedcmidx_update.tab. Note that this file is not the same format as the pedr cumulative index file found on the MOLA CD-ROM distribtuion set. This file can be created useing the "make_pedr_index.pl" procedure with the mola CD-ROM cumulative index file as input. This procedure adds J2000 time ranges to the table and eliminates outdated versions of the mola pedr files.
EXISTS	'overwrite' or 'rename' existing PEDR.lis (Optional)