Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search
USGS

Isis 3 Application Documentation

warp

Printer Friendly View | TOC | Home

Warp an image to another using control points

Overview Parameters Example 1 Example 2

Description

This program warps images using a control net.

Categories

Related Applications in Previous Versions of Isis

This application replaces the following applications existing in previous versions of Isis, which have been deprecated from the current version of Isis:
  • random
  • warp2

History

Kay Edwards1987-06-08 Original version
Jeff Anderson2004-06-18 Converted to Isis 3.0
Elizabeth Miller2005-10-11 Finished documentation and code
Elizabeth Miler2005-11-03 Added appTest
Jacob Danton2006-04-05 Added error checking for control networks
Steven Lambright2007-06-22 Fixed typo in user documentation
Steven Lambright2008-05-13 Removed references to CubeInfo
Stacy Alley2008-12-19 Updating documentation and adding examples

Parameter Groups

Files

Name Description
FROM Input cube to warp
TO Output cube
CONTROL Control Net file

Warp parameters

Name Description
DEGREEOrder of polynomial
WEIGHTEDWeight the control points using distance
OSIZEOutput cube size
CUBEMatch Output cube to this Cube's Size
ONLOutput Lines
ONSOutput Samples

Interpolation

Name Description
INTERPType of interpolation
X

Files: FROM

Description

Use this parameter to select the filename. All bands within the file will be warped 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 warping.

Type cube
File Mode output
Close Window
X

Files: CONTROL

Description

This file will contain the control net used to find the translation.

Type filename
File Mode input
Filter *.net
Close Window
X

Warp parameters: DEGREE

Description

The order of the polynomial to be used in the linear regression fit.

Type integer
Default 1
Minimum 1 (inclusive)
Close Window
X

Warp parameters: WEIGHTED

Description

The control points will be weighted based on distance if this option is selected. If it is not selected, all control points will have a weight of 1, reguardless of distance.

Type boolean
Default true
Close Window
X

Warp parameters: OSIZE

Description

This option determines how the size of the output cube is found. The choices are MATCH, COMPUTE, and USER. The MATCH option matches the output cube size to the size of the cube entered in the CUBE parameter. The COMPUTE option calculates the output cube size from the control net file. The USER parameter allows the user to set the output cube size by entering the sample and line values in the ONS and ONL parameters. The MATCH option is the default.

Type string
Default MATCH
Option List:
Option Brief Description
MATCHMatch size of cube This option will match the output cube to the size of the cube entered in the CUBE box.

Exclusions

  • ONL
  • ONS
COMPUTECompute size using control points Computes the size of the output file using the control net file.

Exclusions

  • ONL
  • ONS
  • CUBE
USERUser specific output cube size The output cube will be the size that the user enters for the ONS and ONL parameters.

Exclusions

  • CUBE

Inclusions

  • ONL
  • ONS
Close Window
X

Warp parameters: CUBE

Description

The output cube will have the same dimensions as the cube entered here.

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

Warp parameters: ONL

Description

The number of lines in the output cube.

Type integer
Minimum 1 (inclusive)
Close Window
X

Warp parameters: ONS

Description

The number of samples in the output cube.

Type integer
Minimum 1 (inclusive)
Close Window
X

Interpolation: INTERP

Description

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

Type string
Default CUBICCONVOLUTION
Option List:
Option Brief Description
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.
CUBICCONVOLUTIONCubic Convolution interpolation Each output pixel will be set to the value calculated by a cubic convolution interpolation of the calculated input pixel.
Close Window

Example 1

Warp Example 1

Description

Warp Example 1

Command Line

warp warp from=warp_from.cub to=warp_example1.cub control=warp_example1.net osize=user onl=1000 ons=1000
This warp command will warp the from cube (warp_from.cub) which is a 100Sx1000L image, to a 1000Sx1000L image and match the points from the control points in warp_example1.net. See the control net input file for more details.

Input Image

Input image

Input image for warp

Parameter Name: FROM

This is the input image for the warp examples.

Data File

Links open in a new window.
Control net input file. This is the require input for the CONTROL parameter. User can edit this file to fit individual needs. In each control point there are two measures. Measure 1 is the point on the from file you would like to map to measure 2.

Output Image

Output image showing results of the warp application.

Output image for warp

Parameter Name: TO

This is the output image for this example of warp. The control net file link below contains the points required to create this kind of a warp output.

Example 2

Warp Example 2

Description

Warp Example 2

Command Line

warp warp from=warp_from.cub to=warp_example2.cub control=warp_example2.net osize=user onl=1000 ons=1000
This warp command will warp the from cube (warp_from.cub) which is a 100Sx1000L image, to a 1000Sx1000L image and match the points from the control points in warp_example1.net. See the control net input file for more details.

Input Image

Input image

Input image for warp

Parameter Name: FROM

This is the input image for the warp examples.

Data File

Links open in a new window.
Control net input file. This is the require input for the CONTROL parameter. User can edit this file to fit individual needs. In each control point there are two measures. Measure 1 is the point on the from file you would like to map to measure 2.

Output Image

Output image showing results of the warp application.

Output image for warp

Parameter Name: TO

This is the output image for this example of warp. The control net file link below contains the points required to create this kind of a warp output.