getrange Documentation

getrange - Get latitude and longitude range of a list of images
Given a list of input image filenames for a high resolution quadrangle
on Mars or Venus, "getrange" will return the latitude and longitude
range of the outer boundary of the images (called the range of the sub-
quadrangle) and if MTMQUAD defaults to "NO", the center longitude of the
subquadrangle.  If no list is entered, the quadrangle latitude and long-
itude range will be returned.  The ascii string of the quadrangle name
(6 characters) will also be returned.  IF MTMQUAD equals "YES" a center
longitude for the standard MTM quadrangle is returned even if "getrange"
is finding a latitude and longitude range for a subquadrangle.  NOTE:
"getrange" should be run only from a procedure.  The parameters that are
output only, CLON, LATR1, LATR2, LONR1, LONR2, and AQUAD return values
to the running procedure.  For example,  the user's procedure might
have a call to "getrange" with twenty images and then the procedure
might call "hilev3a".  The CLON, LATR1, LATR2, etc. are being passed to
"hilev3a" from "getrange".

PROGRAMMER: K.T. Thompson, USGS, Flagstaff, AZ;  6 Oct 2000

Input images to mosaic
(default extension is .cub)

--

quadrangle name (-90000 to
90000)

NONE

MARS or VENUS

MARS

Is this a Mars 1:500k quadrangle
(YES, NO)

The remaining parameters are
output only and will be passed
to the next procedure.

NO

Center longitude of QUAD
Output parameter only

NONE

Lower latitude of range
Output parameter only

NONE

Upper latitude of range
Output parameter only

NONE

Lower longitude of range
Output parameter only

NONE

Upper longitude of range
Output parameter only

NONE

QUAD name in ASCII
Output parameter only

NONE

ADDITIONAL NOTES:

Parm	Description
FROM	This is not a FROMLIST. Your procedure needs to have the actual FROM cubes listed. If a list of images is entered, the latitude and longitude range of the list of images will be returned. If no images are listed, the quadrangle bound- aries will be returned. Example format as produced by "hi- dim": getrange (/work1/myname/hiimage/009b37l2, /work1/myname/hiimage/009b38l2, /work1/myname/hiimage/009b39l2 ) 45222 MARS CLON LATR1 LATR2 LONR1 LONR2 AQUAD
QUAD	This is an integer ranging from -90000 to 90000. The first 3 digits are the center latitude of the quadrangle to the nearest degree and the second three are the center longitude ranging from 0 to 360.
PLANET	This program will find high resolution quadrangle parameters for Mars or Venus. (10 characters)
MTMQUAD	Is this a Mars 1:500k high resolution quadrangle? If "yes" then "getrange" returns a center longitude for the standard MTM quadrangle. With MTMQUAD = "NO",the center longitude of the subquadrangle will be found instead. Later, in "tran", if MTMQUAD = "YES", the output will be trimmed by .4 degree on all sides to conform to the standard MTM quadrangle for- mat only if PIX = 1024.0 pix/deg. Otherwise, the output boundaries will remain the same.
CLON	On Mars, longitude is divided into 20 degree increments and the center longitude of each twenty degreee zone is the CLON of a quadrangle, starting with 10 degrees. On Venus, the center longitude of the quadrangles is the center of the longitude range of each quadrangle. If MTMQUAD = "NO", a center longitude for the subquadrangle (range of the actual images) will be found. Output parameter only.
LATR1	This will become the lowest latitude of the list of images entered, or the lowest latitude of the quadrangle if no list was entered. Output parameter only
LATR2	This will become the highest latitude of the list of images entered, or the highest latitude of the quadrangle if no list was entered. Output parameter only
LONR1	This will become the lowest longitude of the list of images entered, or the lowest longitude of the quadrangle if no list was entered. Output parameter only
LONR2	This will become the highest longitude of the list of images entered, or the highest longitude of the quadrangle if no list was entered. Output parameter only
AQUAD	This is the quadrangle name converted to Ascii (6 charac- ters) Output parameter only