USGS

Isis 2 Documentation


grid Documentation

grid - Draw a grid on a cube
GRID will draw a rectangular or map projection grid on a cube,
alternating a high and low pixel along the lines so that the lines can
be seen through any type of feature.

PROGRAMMER: Kay Edwards, U.S.G.S., Flagstaff, AZ

ParmDescriptionDefault
FROM
Input cube file name
  (default extension is .cub)
NONE
SFROM
Input subcube specifier
" "
TO
Output cube name
  (default extension is .cub)
NONE
OPTION
MAP or RECT

The following parameters are
for the MAP option:
MAP
LAT
Latitude range
  (default=input)
--
LON
Longitude range
  (default=input)
--
LATINC
Latitude line increment
30.
LONINC
Longitude line increment
30.
LATC
Latitude increment while
creating longitude lines
0.
LONC
Longitude increment while
creating latitude lines
0.
TEMP
Temporary file for grid points
(Automatically deleted)
"grid_temp.dat"
SORT
Temporary file for grid sort
(Automatically deleted)

The following parameters are
for the RECT option:
"grid_sort.dat"
SS
Starting sample of grid
--
SL
Starting line of grid
--
NS
Number of samples in grid
--
NL
Number of lines in grid
--
SINC
Sample increment of grid
--
LINC
Line increment of grid

**End of special parameters**

--
HI
High dn value of grid
254.
LO
Low dn value of grid
254.
OTYPE
Output pixel type
0
ORANGE
Minimum and maximum
output pixel range
0,0
USERNOTE
Comment to user
" "

ADDITIONAL NOTES:

ParmDescription
FROM
Input cube file name.  If the file extension is omitted,
then ".cub" will be assumed.
SFROM
SFROM specifies the  subcube using a single string for all
three dimensions of the cube.  The order of the three
dimensions is always samples, lines, and bands and each
dimension is separated by a colon, "samples:lines:bands".

If a dimension is left blank, all the data for that
dimension is selected.  Therefore, the null string (" ")
selects the entire cube.  To select specific data from any
dimension, list the dimension numbers you want. For example,
"10-100:11,12:1-10", will select samples 10-100 inclusive,
lines 11 and 12, and bands 1-10 inclusive.  "(2):(2)" will
select every other sample and line, all the bands and all
the backplanes.  For more examples and explanation of the
many features of the SFROM parameter, refer to
Introduction To ISIS, Section 6, of the ISIS User's Manual.
TO
Input cube file name.  If the file extension is omitted,
then ".cub" will be assumed.
OPTION
This parameter allows the user to select either a
rectangular grid (RECT) or a grid based on the
mapping parameters in the labels (MAP).
LAT
This parameter will be used when OPTION=MAP.  This is the
latitude range of the grid.  The default is the range on
the input cube.
LON
This parameter will be used when OPTION=MAP.  This is the
longitude range of the grid.  The default is the range on
the input cube.
LATINC
This parameter will be used when OPTION=MAP.  This is the
increment of the latitude lines.  The default is set 30
degrees which is a reasonable spacing for a global image.
LONINC
This parameter will be used when OPTION=MAP.  This is the
increment of the longitude lines.  The default is set 30
degrees which is a reasonable spacing for a global image.
LATC
This parameter will be used when OPTION=MAP.  This is the
the frequency of latitude points to be plotted along a
line of longitude.  If this value is too high, the grid
will not be continuous.
LONC
This parameter will be used when OPTION=MAP.  This is the
the frequency of longitude points to be plotted along a
line of latitude.  If this value is too high, the grid
will not be continuous.
TEMP
This is a temporary file created by the program which
contains unsorted the line and sample positions of every
grid point.  This file is automatically deleted by the
program.
SORT
This is a temporary file created by the program which
contains sorted the line and sample positions of every grid
point.  This file is automatically deleted by the program.
HI
The grid will be drawn alternating HI and LO dn values so
that the grid will be visible through any type of feature.
The default is set to a reasonable value for 8-bit cubes
since they are the ones that are normally sent to the
film-writer.
LO
See HI
OTYPE
Output pixel data type.  Permitted values are:

    0 - output type is same as input file pixel type
    1 - 8-bit (integer with type conversion parameters)
    2 - 16-bit (integer with type conversion parameters)
    3 - 32-bit (floating point)

When processed data are being written back into the input
file, the output pixel type must be the same as the existing
pixel type in the input file.
ORANGE
Output pixel data range.  If the output pixel type is 1
(8-bit integer with type conversion parameters) or 2
(16-bit integer with type conversion parameters), then the
type conversion parameters in the output file will be set
to values that allow representing the specified range of
output values.  Output values outside this range will be
stored as the special "representation saturation" value.

The ORANGE parameter is ignored if the output pixel type is
3 (32-bit floating point) since type conversion parameters
are not applicable to floating point pixel values.

If both ORANGE(1) and ORANGE(2) are 0.0, then the type
conversion parameters in the output file will automatically
be set to allow representing the same range of values as
can be represented in the input file.  (The user will be
required to supply a specific range for ORANGE if the input
pixel type is 3 (32-bit floating point) and the output pixel
type is 1 (8-bit with type conversion parameters) or 2
(16-bit with type conversion parameters)).
USERNOTE
Comment specified by the user that will be written to the
log file and history.

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