RPCOrthorectificationUsingDSMFromDenseImageMatching Task

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:

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:

Version History

ENVI 5.4

Introduced

ENVI 5.5.1

Added the OUTPUT_COORDINATE_SYSTEM property

API Version

4.2