Build Stereo Model (Data Management)

Summary

Builds a stereo model of a mosaic dataset based on a user-provided stereo pair.

A stereo model of a mosaic dataset is required for stereo feature collection and 3D point cloud generation. A stereo model, as one of the tables in a mosaic dataset, defines the stereo pairs. The stereo model stores the overlapping polygons, the corresponding image identifiers, and image IDs that comprise each pair. The stereo model can be accessed from the context menu of a mosaic dataset.

Usage

• The order of the stereo pair in the point cloud calculation is determined by user-defined thresholds for the overlap area, intersection angle, adjustment quality, ground sample distance (GSD) difference, and Omega and Phi quality.

• If you want a specific pair to be used for point cloud generation, set a high value for this pair in the Use field of the stereo table. To open the stereo table, right-click the mosaic layer in the Contents pane and click Open > Stereo.

Parameters

Dialog

Label	Explanation	Data Type
Input Mosaic Dataset	The mosaic dataset on which the stereo model will be built. Tip: Running the Apply Block Adjustment tool on the input mosaic dataset first will help create a more accurate stereo model.	Mosaic Dataset; Mosaic Layer
Minimum Intersection Angle (in degree) (Optional)	The value, in degrees, that defines the minimum angle the stereo pair must meet. The default is 10.	Double
Maximum Intersection Angle (in degree) (Optional)	The value, in degrees, that defines the maximum angle the stereo pair must meet. The default is 90.	Double
Minimum Area Overlap (Optional)	The percentage of the overlapping area over the whole image. The default is 0.5.	Double
Maximum Omega/Phi Difference (in degree) (Optional)	The maximum threshold for the Omega and Phi difference between the two image pairs. The Omega values and Phi values for the image pairs are compared. If the difference between either the two Omega or the two Phi values is above the threshold, the pairs will not be formatted as a stereo pair.	Double
Maximum GSD Difference (Optional)	The threshold for the maximum GSD between two images in a pair. If the resolution ratio between the two images is greater than the threshold value, the pairs will not be built as a stereo pair. The default is 2.	Double
Group by (Optional)	Builds the stereo model from raster items within the same group, defined by a mosaic dataset field such as RGB, Panchromatic, or Infrared.	Field
Only pick stereo models in the same flight line (Optional)	Specifies how the stereo models will be selected. Checked—Stereo pairs will be selected along the same flight line. Unchecked—Stereo pairs will be selected across flight lines. This is the default. Note: This parameter is not applicable to satellite-based sensors.	Boolean

Derived Output

Label	Explanation	Data Type
Updated Mosaic Dataset	The updated mosaic dataset.	Mosaic Dataset; Mosaic Layer

Python

arcpy.management.BuildStereoModel(in_mosaic_dataset, {minimum_angle}, {maximum_angle}, {minimum_overlap}, {maximum_diff_OP}, {maximum_diff_GSD}, {group_by}, {same_flight})

Name	Explanation	Data Type
in_mosaic_dataset	The mosaic dataset on which the stereo model will be built. Tip: Running the Apply Block Adjustment tool on the input mosaic dataset first will help create a more accurate stereo model.	Mosaic Dataset; Mosaic Layer
minimum_angle (Optional)	The value, in degrees, that defines the minimum angle the stereo pair must meet. The default is 10.	Double
maximum_angle (Optional)	The value, in degrees, that defines the maximum angle the stereo pair must meet. The default is 90.	Double
minimum_overlap (Optional)	The percentage of the overlapping area over the whole image. The default is 0.5.	Double
maximum_diff_OP (Optional)	The maximum threshold for the Omega and Phi difference between the two image pairs. The Omega values and Phi values for the image pairs are compared. If the difference between either the two Omega or the two Phi values is above the threshold, the pairs will not be formatted as a stereo pair.	Double
maximum_diff_GSD (Optional)	The threshold for the maximum GSD between two images in a pair. If the resolution ratio between the two images is greater than the threshold value, the pairs will not be built as a stereo pair. The default is 2.	Double
group_by (Optional)	Builds the stereo model from raster items within the same group, defined by a mosaic dataset field such as RGB, Panchromatic, or Infrared.	Field
same_flight (Optional)	Specifies how the stereo models will be selected. SAMEFLIGHT—Stereo pairs will be selected along the same flight line. NO_SAMEFLIGHT—Stereo pairs will be selected across flight lines. Note: This parameter is not applicable to satellite-based sensors.	Boolean

Derived Output

Name	Explanation	Data Type
out_mosaic_dataset	The updated mosaic dataset.	Mosaic Dataset; Mosaic Layer

Code sample

BuildStereoModel example 1 (Python window)

This is a Python sample for the BuildStereoModel function.

import arcpy
arcpy.management.BuildStereoModel("c:/data/fgdb.gdb/md", 10, 70, 0.6, None, 2, None, "SAMEFLIGHT")

Environments

This tool does not use any geoprocessing environments.