Home

Quick Links

Software Manual
GitHub
API Reference

Documentation Versions

Public Release
8.3.0
8.2.0
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0
USGS

ISIS Application Documentation


enlarge

Printer Friendly View | TOC | Home

Enlarge the pixel dimensions of an image

Overview Parameters Example 1 Example 2

Description

This program will enlarge a cube by a given scalar of the original or to specific dimensions. The user can specify to perform the enlargement by cubic convolution, nearest neighbor, or bi-linear interpolation.

Categories


History

Stuart Sides2002-12-13 Original version
Stuart Sides2003-01-28 Fixed documentation error. The application name was rotate instead of enlarge.
Kim Sides2003-05-13 Added application test
Stuart Sides2003-05-16 Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides2003-05-30 Fixed compiler error with uninitialized variable after adding -O1 flag
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Drew Davidson2005-08-17 Added example
Brendan George2005-10-31 Fixed application test
Sean Crosby2007-02-28 Program now updates output file's mapping keywords
Steven Lambright2007-06-22 Fixed typo in the user documentation
Steven Lambright2008-05-13 Removed references to CubeInfo
Steven Koechle2008-05-28 Fixed problems with the way the Alpha Cube was handled
Christopher Austin2008-12-11 Changed the parameter names smag/lmag to sscale/lscale for consistancy with reduce.
Steven Lambright2008-12-22 The "Scale" keyword in the Projection group in the labels is now being updated if this program is run on a projected cube.
Janet Barrett2009-10-22 Now uses the SubArea class to produce output cube labels with corrected Mapping, Instrument, and AlphaCube groups.
Travis Addair2009-12-10 Added functionality for enlarging to a total number of pixels.
Travis Addair2009-12-11 Updated example.
Sharmila Prasad2011-04-14 Ported the enlarge functionality to base/objs/Enlarge class
Sharmila Prasad2011-09-15 Fixed issue 0000280 - enlarge fails when run with a batchlist
Kaitlyn Lee2020-04-09 The SetOutputCube method from Process we were originally using called Application::GetUserInterface(), but this became a problem when trying to call enlarge(), or run the application, programmatically since we are no longer using Application in the application's cpp file. Changed the call to the one that takes in a CubeAttribute object. Also, removed the check to see if an invalid interpolation method was passed in since the UserInterface class checks and throws the exception and it was unreachable code.

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: 10/05/2024 02:42:31
X

Files: FROM


Description

Use this parameter to select the filename. All bands within the file will be enlarged unless a specific band is specified.

Type cube
File Mode input
Filter *.cub
Close Window
X

Files: TO


Description

This file will contain the results of the enlargement.

Type cube
File Mode output
Close Window
X

Scaling Parameters: INTERP


Description

This is the type of interpolation to be performed on the input.

Type string
Default CUBICCONVOLUTION
Option List:
Option Brief Description
CUBICCONVOLUTIONCubic Convolution interpolation Each output pixel will be set to the value calculated by a cubic convolution interpolation of the calculated input pixel.
NEARESTNEIGHBORNearest Neighbor Each output pixel will be set to the pixel nearest the calculated input pixel.
BILINEARBi-Linear interpolation Each output pixel will be set to the value calculated by a bi-linear interpolation of the calculated input pixel.
Close Window
X

Scaling Parameters: MODE


Description

Select between enlarging the image to a multiple of the original (by a scaling factor) or to specific dimensions (in terms of total number of pixels).

Type string
Default SCALE
Option List:
Option Brief Description
SCALE Enlarge by a scaling factor Enlarges the input image by a scaling factor. The scaling factor along the sample range and line range must then be specified in the SSCALE and LSCALE parameters, respectively.

Exclusions

  • ONS
  • ONL

Inclusions

  • SSCALE
  • LSCALE
TOTAL Enlarge to a total number of pixels Enlarges the input image to a total number of pixels. The number of pixels in the output image along the sample range and line range must then be specified in the ONS and ONL parameters, respectively.

Exclusions

  • SSCALE
  • LSCALE

Inclusions

  • ONS
  • ONL
Close Window
X

Scaling Parameters: SSCALE


Description

This determines new size of the cube in the sample direction only. The number of samples will be multiplied by this number.

Type double
Default 1.0
Minimum 1.0 (inclusive)
Close Window
X

Scaling Parameters: LSCALE


Description

This determines new size of the cube in the line direction only. The number of linees will be multiplied by this number.

Type double
Default 1.0
Minimum 1.0 (inclusive)
Close Window
X

Scaling Parameters: ONS


Description

The number of samples desired in the output cube. This value must be greater than or equal to the number of samples in the input image.

Type integer
Minimum 1 (inclusive)
Close Window
X

Scaling Parameters: ONL


Description

The number of lines desired in the output cube. This value must be greater than or equal to the number of lines in the input image.

Type integer
Minimum 1 (inclusive)
Close Window