USGS

Isis 2 Documentation


trim Documentation

trim - NULL the edges of a cube

"trim" will change the DN values on the edges of a cube.
The user supplies the TOP, BOTTOM, LEFT, and RIGHT line and sample
values that will determine the edges of the data for the cube.
TOP and BOTTOM determine the number of lines at the top and bottom
of each band that will be set to NULL values.  LEFT and RIGHT
are the number of samples that will be set to NULL on the left and
right sides of each band.

The user can also NULL the backplane edges by setting BPLANES to YES.

PROGRAMMER: Jim Mathews, U.S.G.S., Flagstaff, AZ

ParmDescriptionDefault
FROM
Input cube file name
  (default extension is .cub)
NONE
SFROM
Input subcube specifier
--
TO
Output cube file name
  (default extension is .cub)
NONE
TOP
Number of lines to NULL at
the top of the image
above
1
BOTTOM
Number of lines to NULL at
the bottom of the image
1
LEFT
Number of samples to NULL
on the left of the image
1
RIGHT
Number of samples to NULL
on the right of the image
1
BPLANES
Null backplanes - YES or NO
"NO"
USERNOTE
User comment
" "

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:bands".
If a dimension is left blank, all the data for that
dimension is selected.  The default value of NULL for SFROM
selects the entire cube.

Any application below can be used for any dimension.
To select specific data from any dimension:
  "10-100(3):11,12,15-20:1-10(2)" =  This example will
select every third sample starting with sample 10 thru 100.
It selects lines 11 and 12, and 15-20. It selects every
other band, starting with band 1 thru 10.
	
There are special characters that can be used for
selecting a subcube efficiently, such as "*","#", and "~".
For examples type "help sfrom" in TAE.
		
**NOTE** For more examples and explanation of the many
features of the SFROM parameter, tutor the sfrom.pdf or
refer to Introduction To ISIS, Section 6, of the ISIS
User's Manual **
TO
Output cube file name.  If the file extension is omitted,
then ".cub" will be assumed.
TOP
Number of lines to NULL at the top of the image.
BOTTOM
Number of lines to NULL at the bottom of the image.
LEFT
Number of samples to NULL on the left side of the image.
RIGHT
Number of samples to NULL on the right side of the image.
BPLANES
Decision to NULL the backplanes.  Enter YES
or NO.
USERNOTE
Comment from the user.  This will be recorded in the ISIS
session log file and also in the History entry that is put
into the History object of the output file.

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