USGS

Isis 2 Documentation


lev1plot Documentation

lev1plot - plot level1 ISIS images in level2 space.
"lev1plot" will plot the footprint boundaries of a list of level 1
images into level 2 projections using the SPICE information in the
kernels on the labels of the images.  This program can plot Control
points in a file, but does not plot Control points from the labels of the
images.  Match point file plotting is not implemented.  The projections
available are whatever projections are implemented in MAPPARS.

"lev1plot" creates a PostScript file that can be printed on a black and
white or color printer, can be plotted on a color plotter, or displayed
using the system program 'ghostview'.  Use your usual print command
lines when sending your file to any PostScript translating plotter or
printer, else you will have to get into the plotter/printer machine doc-
umentation.  For 'ghostview':


bug{927}>  ghostview 


If "lev1plot" is run with the default color file and then sent to a
black and white printer, the footprints, limbs, etc., will be printed in
various shades of gray.  Use COLOR=$ISISDATA/blackAndWhite.txt for all
black.

In addition, a TOERR file can be generated which will contain a list of
cubes which were unsuccessful.

Note that the output from "lev1plot" is an ascii file which you could
edit (if you know what you are doing).



PROGRAMMER: K Teal Thompson

ParmDescriptionDefault
INC
Get Range Faster but Sparser
NONE
CONTROL
Control Point File
NONE
MATCH
Match Point File
NONE
LONDIR
Direction of positive longitude
"WEST"
LATSYS
Latitude system
(default OGRAPHIC)
"OGRAPHIC"
FROMLIST
List of input cube file names
(No default extension)
NONE
TO
Postscript file (overwrites
existing)
NONE
TOERR
File listing unsuccessful cubes
NONE
MATFROM
File with matchpoints
MAPPARS
Map projection and parameters
(e.g., MAPPARS="SINU:0"
NONE
TARGDEF
Target or target definition
--
LATRANGE
Latitude range
(default=total range of cubes)
NONE
LONRANGE
Longitude range
(default=total range of cubes)
NONE
PAPER
Paper width & height
in inches.
   (or)
NONE
SCALE
fractional map scale, (i.e.
for 1:1,000,000 scale=1.0)
NONE
HEADER
User comment at top of page
NONE
FONTSZ
Font/character size of plot
title.
NONE
LINESZ
Width of the plottin line
[SMALL,MEDIUM,LARGE]
NONE
COLOR
Text file with red, green,
blue triples
NONE
QUAD
Plot quad boundaries
NONE
FOOT
Plot image footprints
NONE
LABEL
Product ID, Image Number or
Filename at image center
NONE
LIMB
Plot the limb in each image
NONE
TERM
Plot the terminator in each
image
NONE
LONSYS
Longitude system
(default 0 to 360)
360

ADDITIONAL NOTES:

ParmDescription
TOERR
A file which will contain the cubes in FROMLIST which
were unsuccessful and therefore statistics could not
be calculated.
INC
Input an Increment and get a correspondinly sparser range
calculation that will run faster.
CONTROL
Control Point File:  Lev1plot will overlay control point
numbers on the output plot based on their latitude and
longitude values.  The control point i.d.'s and their
associative lat/lon's are usually supplied by RAND's
software in ascii column format:

Example:   latitude    longitude   radii    control_pt_id

This feature on the output plot is useful in determining
which control point i.d.'s fall within the input image(s)
boundaries that are plotted.
MATCH
Match Point File
LONDIR
Direction of positive longitude
LATSYS
This parameter is used to define the latitude system
computed by "lev1" programs.  Valid values are either
OGRAPHIC or OCENTRIC.  The default is OGRAPHIC.  Your
selection is written to the labels of the cube or
table file.  This effects programs which output or
use the latitude, for example, "qview", "lev1stats",
"lev1tolev2".
FROMLIST
A maximum of 128 characters is allowed for each file name.
List one file per line.  Up to 10000 cubes can be listed.
INSTPARS
This parameter is used to specify instrument specific
properties.  For example, to define the location of
a new set of SPICE kernels.

**NOTE** For a detailed explanation of INSTPARS, tutor
the instpars.pdf (i.e., TAE> tutor instpars).
MAPPARS
See level.pdf
Enter a target definition file, target name (which will be
used to generate the default target definition file), or
use the default (copy target information from the FROM file.
Example:
  TARGDEF=mars

The software will try to find files:

  $ISISDATA/targets/mars.def.1
  $ISISDATA/targets/mars.def.2
  $ISISDATA/targets/mars.def.3

etc.

Or enter a user written target definition file path and
name:

  TARGDEF=/work1/elee/mars.def.3

If you want radii different from the defaults in the system,
you cannot enter the radii numbers here.  Copy the system
target definition file to your area and edit, putting the
radii you want into the definition file.  Then TARGDEF=your_
file.  Note also that the target definition file name will
be written to the cube labels, and you will help yourself
if you use a version system as is being done in ISIS.  Each
time you make edits to your target definition file, rename
it and keep the old versions lying around somewhere where
you can find them.

LATRANGE
Latitude range of the desired output plot.  If the range is
not entered then it will be automatically computed based
upon the input images.  If the range is entered then
LONRANGE must be entered as well.
LONRANGE
Longitude range of the desired output plot.  If the range is
not entered then it will be automatically computed based
upon the input images.  If the range is entered then
LATRANGE must be entered as well.
LONSYS
?
PAPER
Paper width and height in inches.  If scale is input, the
paper width necessary to print the plot will be reported.
Else if paper height and width are input, the resulting
scale will be reported.

Notice what might appear to be contradictory outputs:
For a sinusoidal projection & for LATRANGE = -90 to 90 and
LONRANGE = -180 to 180
  WIDTH  = 4
  HEIGHT = 6
program calculates:
  WIDTH scale (divided by million)  = 210
  HEIGHT scale (divided by million) = 70
chooses larger scale to make projection smaller to fit in
both directions:
  SCALE (divided by million) = 210
user inputs SCALE = 210 back into program and gets:
  Paper size calculated from input scale:
  (in Inches): 4.000293 x 2.000147
This is because WIDTH  = 4 determined scale; then user
inputs scale, which with LONRANGE = -180 to 180 gives 4
inches for WIDTH.  LATRANGE = -90 to 90 will obviously be
about half as big in the sinusoidal giving 2 inches for
HEIGHT.

Also for a sinusoidal projection & for LATRANGE = -90 to 90
and LONRANGE = -180 to 180
  WIDTH  = 4
  HEIGHT = 1
program calculates:
  WIDTH scale (divided by million)  = 210
  HEIGHT scale (divided by million) = 420
chooses larger scale to make projection smaller to fit in
both directions:
  SCALE (divided by million) = 420
user inputs SCALE = 420 back into program and gets:
  Paper size calculated from input scale:
  (in Inches): 2.000147 x 1.000073
This is because HEIGHT = 1 determined scale; then user
inputs scale, which with LATRANGE = -90 to 90 gives 1 inch
for HEIGHT.  LONRANGE = -180 to 180 will be about twice as
big in the sinusoidal and using the same scale results in 2
inches for WIDTH.

SCALE
The map scale is defined by the user or more commonly
defined by a specific map series. Most map series have
specific scales which vary throughout the series depending
on the projection.

For all projections except CYLI, SIMP and SINU, the map
scale is expressed as the ratio or proportion between
comparable measurements on the map to the surface
represented by the map. This ratio is often called the
Representative Fraction (RF). The RF is usually expressed
as 1:5,000,000 or 1/5,000,000. At this scale, 1 cm on the
map represents 5,000,000cm (50km) on the planet surface.
Enter the second number of the RF divided by 1,000,000
for the SCALE.
( i.e. for 1:10,000,000 RF , SCALE = 10
       for 1:18,261,561 RF , SCALE = 18.261561
       for 1:502,000 RF    , SCALE = .502
       for 1:24,000 RF     , SCALE = .024)

For CYLI, SIMP, and SINU projections, the scale is related
to kilometers per degree on the planet. To match a CYLI,
SIMP or SINU to another projection (will match only at the
equator), divide the desired RF scale by the number of
kilometers in one degree of longitude on the equator of
the planet. For example, to match a SINU to an existing
1:25,000,000 (SCALE=25) Mars map of another projection:

  Mars' equatorial radius is 3393.4 km. The circumference
  of Mars is 21,321.36 km (2 * PI * 3393.4). One degree of
  longitude is 59.226km (circumference/360). So the scale
  to use for the SINU is 25/59.226 or SCALE = .422112.

See HELP PAPER for more info.
See HELP * for more info.
HEADER
A comment or plot label at the top of the plot.  DEFAULT
will automatically write the concatenation of instrument and
map projection to the header.
FONTSZ
Font/character size for both the plot title and the user's
desired image ID for each image footprint.  As you plot on
increasing paper sizes, you may want to reduce font size.
LINESZ
First element is width of the line for gridding.  Second
element is width of the ticks.
SMALL = 0  thinnest line possible
MEDIUM= 1
LARGE = 2
COLOR
A text file with Red, Green, Blue values.  The default file
in the system $ISISDATA/color.txt has 12 repeating values. A
new color file can be produced by copying the default file
and editing it, to add/subtract/change color values.  Be ad-
vised that the total number of triples (repeating or not)
should be more than the number of images being plotted.

The user will get gray levels when using the same value for
each color in the triple.  COLOR= 0.,0.,0. will draw black
lines, COLOR=1.,1.,1.  will draw white lines, and intermedi-
ate values correspond to intermediate shades of gray.  Color
can only be printed on some printers.  To get color, vary
the values in relation to each other.
COLOR = 1. 0. 0. = red
COLOR = 0. 1. 0. = green
COLOR = 0. 0. 1. = blue
COLOR = 1. 1. 0. = yellow
COLOR = 1. 0. 1. = magenta
COLOR = 0. 1. 1. = cyan
COLOR = 1. 1. 1. = white
COLOR = .5 .5 .5 = gray

In the color text file, just put 3 values separated by
spaces on each line.
QUAD
Plot the boundaries of the user's latitude/longitude range
if input, or plot the defaulting latitude/longitude range.
FOOT
Plot images' projected footprints.  Note that for high reso-
lution images, the defaults to plot QUAD & FOOT may be
enough, but for low resolution images with limbs and term-
inators, set limb=y & term=y as well.  This is where the
color file will be used to select a different color for
each image footprint.  The default system color.txt file
has 12 colors that then begin repeating.
LABEL
Does the user want Product ID, Image Number or filename
plotted for each image at the center of the image footprint.
Null value produces nothing at the center.  Image labels
are plotted in the color of the image's footprint.
LIMB
Plot the projection of each image's limb.  Valid data points
on the image with emission angles between 85 degrees and 90
degrees are plotted with a "+" character in the same color
as the image's footprint.
TERM
Plot the projection of each image's terminator.  Valid data
points on the image with incidence angles between 87 degrees
and 90 degrees are plotted with an "*" character in the same
color as the image's footprint

Last updated: Jan 31 2005
File: pdfs2.html

Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov

ISIS Documentation Home Page