ISIS 3 Application Documentation
Puts a sub-cube back into its parent cube
This program reverses the effect of crop. That is, it puts a cropped cube back
into a parent cube. The sub- or child- cube must have an AlphaCube label.
Note: The filename and size of the parent cube is not checked for correctness.
Stuart Sides 2003-04-19
Stuart Sides 2003-05-01
Changed category from Utility to Trim and Mask
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
Brendan George 2006-09-28
Sharmila Prasad 2011-01-20
Updated for changes in ProcessMosaic
Steven Lambright 2012-05-01
Updated documentation; fixes #458
JP Bonn 2017-02-24
Added example in documentation
Parent output cube
COMBINE How to combine the crop and parent pixels
The sub-cube, possibly created by crop. This cube must contain a valid
The output cube, an existing filename is required. The filename can be the original file
from which the cropped image was extracted, or it could be a new file created with
makecube based on the dimensions found in the AlphaCube label of the cropped image.
This parameter is used to select one of two ways to combine the
crop and parent pixels in areas of overlap.
CROP Input cube takes priority
When the input pixel is not NULL, the input
pixel value will be written to the output cube. Otherwise the
output is unchanged.
PARENT Parent cube takes priority
When the parent pixel is not NULL, the parent
pixel value will be left unchanged. If the parent pixel is NULL,
the cropped pixel will be written to the output cube.
Insert a sub-cube into a parent cube
Insert a cube of 200 samples by 300 lines into a parent cube.
uncrop FROM=crop.cub PARENT=pcrp.cub COMBINE=CROP
In this example, uncrop will insert a 200x300 sub-area into the parent cube.
This is a screenshot of uncrop. The GUI shows the parameters filled to insert a 200x300 pixel sub-area into the parent image.
This is the full size input image. The area (200x300)
to be "uncropped" is grey.
This is the sub-cube to be inserted into the parent image.
Parent with inserted sub-cube.
Parent with inserted sub-cube
This is the parent image with the sub-cube inserted using the "crop" combine mode.