ISIS Application Documentation

uncrop

Puts a sub-cube back into its parent cube

Overview

Parameters

Example 1

Description

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.

History

Stuart Sides	2003-04-19	Original version
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	Documentation fixes
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

U.S. Department of the Interior | U.S. Geological Survey
ISIS | Privacy & Disclaimers | Astrogeology Research Program
To contact us, please post comments and questions on the USGS Astrogeology Discussion Board
To report a bug, or suggest a feature go to: ISIS Github
File Modified: 02/21/2025 19:28:14

Parameter Groups

Files

Name	Description
FROM	Child cube
PARENT	Parent output cube

Combine options

Name	Description
COMBINE	How to combine the crop and parent pixels

Files: FROM

Description

The sub-cube, possibly created by crop. This cube must contain a valid AlphaCube label.

Type	cube
File Mode	input
Filter	*.cub

Close Window

Files: PARENT

Description

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.

Type	cube
File Mode	output
Filter	*.cub

Close Window

Combine options: COMBINE

Description

This parameter is used to select one of two ways to combine the crop and parent pixels in areas of overlap.

Type

string

Default

CROP

Option List:

Option	Brief	Description
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.

Close Window

Example 1

Insert a sub-cube into a parent cube

Description

Insert a cube of 200 samples by 300 lines into a parent cube.

Command Line

uncrop FROM=crop.cub PARENT=pcrp.cub COMBINE=CROP

In this example, uncrop will insert a 200x300 sub-area into the parent cube.

GUI Screenshot

Uncrop GUI

Example GUI

This is a screenshot of uncrop. The GUI shows the parameters filled to insert a 200x300 pixel sub-area into the parent image.

Input Images

Input image

Parent image

Parameter Name: PARENT

This is the full size input image. The area (200x300) to be "uncropped" is grey.

Sub-cube image

Parameter Name: FROM

This is the sub-cube to be inserted into the parent image.

Output Image

Parent with inserted sub-cube.

Parent with inserted sub-cube

Parameter Name: PARENT

This is the parent image with the sub-cube inserted using the "crop" combine mode.

Quick Links

Documentation Versions

uncrop

Description

Categories

History

Parameter Groups

Files

Combine options

Files: FROM

Description

Files: PARENT

Description

Combine options: COMBINE

Description

Example 1

Description

Command Line

GUI Screenshot

Input Images

Output Image