This task performs RPC orthorectification using a Digital Surface Model (DSM) generated from a dense image matching method. The DSM is generated from two or more images taken from different view points, and it is used as the terrain source to orthorectify the first raster in the input rasters. For best results, put the raster closest to nadir view first.

Example

This example creates a DSM from an IKONOS stereo dataset. The files used in this example are available from our ENVI Tutorials web page in the IKONOS Stereo directory. Download the files Hobart*.* to your local drive, then update the code example to point to the correct path.

; Start the application
e = ENVI()
 
; Open  input files
File1 = 'HobartIKONOS1.dat'
File2 = 'HobartIKONOS2.dat'
 
Raster1 = e.OpenRaster(File1)
Raster2 = e.OpenRaster(File2)
 
; Get the task from the catalog of ENVITasks
Task = ENVITask('RPCOrthorectificationUsingDSMFromDenseImageMatching')
 
; Define inputs
Task.INPUT_RASTERS = [Raster1, Raster2]
 
; Run the task
Task.Execute
 
; Get the data collection
DataColl = e.Data
 
; Add the output to the data collection
DataColl.Add, Task.OUTPUT_RASTER
 
; Display the result
View = e.GetView()
Layer = View.CreateLayer(Task.OUTPUT_RASTER)
View.Zoom, /FULL_EXTENT

Syntax

Result = ENVITask('RPCOrthorectificationUsingDSMFromDenseImageMatching')

Input properties (Set, Get):DO_BLOCK_ADJUSTMENT, EDGE_THRESHOLD, GRID_SPACING, INPUT_RASTERS, MATCHING_THRESHOLD, MINIMUM_OVERLAP, OUTPUT_COORDINATE_SYSTEM, OUTPUT_DSM_RASTER_URI, OUTPUT_PIXEL_SIZE, OUTPUT_RASTER_URI, QUALITY_THRESHOLD, RESAMPLING

Output properties (Get only):OUTPUT_DSM_RASTER, OUTPUT_RASTER

Properties marked as "Set" are those that you can set to specific values. You can also retrieve their current values any time. Properties marked as "Get" are those whose values you can retrieve but not set.

Methods

This task inherits the following methods from ENVITask:

AddParameter

Execute

Parameter

ParameterNames

RemoveParameter

Properties

This task inherits the following properties from ENVITask:

COMMUTE_ON_DOWNSAMPLE

COMMUTE_ON_SUBSET

DESCRIPTION

DISPLAY_NAME

NAME

REVISION

TAGS

This task also contains the following properties:

DO_BLOCK_ADJUSTMENT (optional)

Set this property to specify whether block adjustment will be applied before generating the DSM. The options are true (default) or false. A block, or bundle, adjustment is used to refine the 3D coordinates that describe the scene geometry. It finds a set of parameters that most accurately predict the locations of the observed points in a set of images, thus minimizing the reprojection error between image locations of observed and predicted image points. Applying a block adjustment for satellite images refines the image geometry to improve the quality of the DSM. If the the images have already been adjusted, set this property to false.

EDGE_THRESHOLD (optional)

Specify a value between 0 and 100. Set a lower value to include more mismatches in areas with poor contrast. Set a higher value to force rich texture and edge information in accepted matches. The default value is 5.

GRID_SPACING (optional)

Specify the grid spacing (in pixels) to use for orthorectification.

INPUT_RASTERS (required)

Specify an array of rasters from which to generate the DSM. The first raster will be orthorectified using the DSM. For best results, put the raster closest to nadir view first. The following rules apply to input stereo images:

  • They should have enough parallax, for example, stereo and tri-stereo images collected by sensors from different view points.
  • They must overlap by at least the percentage specified in the MINIMUM_OVERLAP parameter. The default value is 55 percent.
  • They must contain rational polynomial coefficients (RPCs) or physical sensor models. For satellite images, RPCs are preferred over physical models.
  • They must have the same number of bands. Select two or more panchromatic datasets, or select two or more multispectral datasets that have the same number of bands.
  • For other sensors not listed in the introduction of this topic, open the individual image files (TIFF, JPEG2000, or NITF) if available.

MATCHING_THRESHOLD (optional)

The match threshold sets a limit to the difference between matching windows. A value of 0 means no difference (a perfect match). Set this property to a lower value to increase confidence and to decrease mismatches. Set it to a higher value to capture finer details at the possible cost of more mismatches. The default value is 15.

MINIMUM_OVERLAP (optional)

Set this property to a percentage (0 to 100) indicating the minimum overlap area between two images, for matching to occur. Image pairs with a smaller overlap than the specified value are ignored.

The default value is 55.0000.

OUTPUT_COORDINATE_SYSTEM (optional)

Set this property to a valid ENVICoordSys object indicating the coordinate system to use for the orthorectified result. The default value is a UTM projection.

OUTPUT_DSM_RASTER

This is a reference to the output DSM raster of filetype TIFF.

OUTPUT_DSM_RASTER_URI (optional)

Specify a string with the fully-qualified path and filename for OUTPUT_DSM_RASTER.

OUTPUT_PIXEL_SIZE (optional)

Set this property to a two-element array indicating the output X and Y pixel size for the orthorectified result, in the units defined by OUTPUT_COORDINATE_SYSTEM. The default value is the pixel size of the input image.

OUTPUT_RASTER

This is a reference to the output raster of filetype ENVI.

OUTPUT_RASTER_URI (optional)

Specify a string with the fully qualified filename and path of the associated OUTPUT_RASTER. If you do not specify this property, or set it to an exclamation symbol (!), a temporary file will be created.

QUALITY_THRESHOLD (optional)

Specify a value between 0 and 100. Each pixel is assigned a quality measure, which is based on the similarity between windows around the pixel in the stereo images at the matched position. Setting this threshold to 0 will export all matched points for DSM generation. Increasing the threshold exports fewer matching points, but the quality of the DSM is potentially better.

RESAMPLING (optional)

Specify the output resampling method:

  • Nearest Neighbor: uses the nearest pixel without any interpolation.
  • Bilinear (default): performs a linear interpolation using four pixels to resample.
  • Cubic Convolution: uses 16 pixels to approximate the sinc function using cubic polynomials to resample the image.

Version History

ENVI 5.4

Introduced

ENVI 5.5.1

Added the OUTPUT_COORDINATE_SYSTEM property

API Version

4.2