This program can be used to crop or select a sub-area from a cube.
The
crop parameter selection requires that the area of interest be contiguous.
That is, the program will not allow non-continuous cropping such as lines
1-5, 10-30, and 80-100.
The contiguous area can however be sub-sampled by specifing pixel
increments (or skips). For example every third line (1, 4, 7, 10, ...)
can be written to the output cube using a line increment (LINC) of three.
This application replaces the following
applications existing in previous versions of Isis, which have been deprecated
from the current version of Isis:
dsk2dsk
sfrom
History
Jim Mathews
1994-04-20
Original version
Jeff Anderson
2002-08-05
Converted to Isis 3.0
K Teal Thompson
2002-11-18
Added examples
Jeff Anderson
2003-01-28
Removed crop from the Utility category
K Teal Thompson
2003-02-03
Make images smaller
K Teal Thompson
2003-02-04
Added red rectangle to input image of example to illustrate crop area.
K Teal Thompson
2003-03-19
Moved images to /assets/image directory and thumbnails to /assets/thumb directory.
Stuart Sides
2003-04-04
Fixed problem with isiscvs not checking in the thumb and image directories.
Stuart Sides
2003-04-25
Added extraction labels
Stuart Sides
2003-05-16
Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides
2003-07-29
Modified filename parameters to be cube parameters where necessary
Jeff Anderson
2004-02-16
Replaced extraction group with AlphaCube group and propagated other
labels.
Jeff Anderson
2004-02-16
Added LINC and SINC parameters and set defaults for all parameters
Brendan George
2006-12-29
Fixed to allow input band selection
Elizabeth Miller
2007-02-01
Modified to adjust the upper left corner x and y values in the mapping group
of the output cube if the input cube is projected
Steven Lambright
2008-05-13
Removed references to CubeInfo
Steven Lambright
2008-08-04
Added spice propagation option PROPSPICE. Fixed description of NLINES, NSAMPLES
and now line associated and sample associated tables are modified when crop is run.
Steven Lambright
2008-08-06
Changed default of PROPSPICE to true. Sample/Line associated tables are no longer modified
due to conflicts with other programs, such as pad, which doesn't know what data values
to add to the tables.
Steven Lambright
2009-06-30
When an invalid projection exists the proper error should now be thrown.
Janet Barrett
2009-10-21
Now uses the SubArea class to produce output cube labels
with corrected Mapping, Instrument, and AlphaCube groups.
This defines how many samples will be taken from the input cube,
if SINC is 1. The number of samples actually taken from the input
cube is NSAMPLES/SINC.
A sample increment to use when extracting from the input cube.
This effectively skips samples. For example if SINC=2 and SAMPLE=1
the output cube would contain samples 1,3,5,7, and so on. Note that
this reduces the size of the output cube as specified by NSAMPLES.
That is, if NSAMPLES=200 and SINC=2, the output cube will have 100
samples.
A line increment to use when extracting from the input cube.
This effectively skips lines. For example if LINC=2 and LINE=5
the output cube would contain lines 5,7,9,11 and so on. Note that
this reduces the size of the output cube as specified by NLINES.
That is, if NLINES=200 and LINC=2, the output cube will have 100
lines.
