| Back to top |
| Back to top |
| Name | Caption |
|---|---|
| Input Scenes | Input scenes folder |
| Output Folder | Output folder |
| Output DEM Base Name | Output DEM base name |
| Save Intermediate Files | Save intermediate files |
| Overwrite Results | Overwrite existing results |
| Send Email | Email notification settings |
| Output Pixel Size | Output pixel size |
| Custom Size | Custom size of output pixel |
| Output Map Units | Output projection |
| Extraction Interval | Pixel sampling interval |
| Elevation Reference/Datum | Elevation model |
| Elevation Unit | Elevation unit |
| Failed Pixel Value | Failed pixel value |
| Background Elevation | DEM background elevation value |
| Look Directions | Look directions to use |
| Bit Depth | Bit depth of pair |
| Cost Function | Cost function for SGM extraction method |
| Penalties | Penalty values for cost function |
| Segment Size | Threshold at which to eliminate segments |
| Semi-global Filter | Level of SGM filtering |
| Pattern Suppression | Suppress pattern blunders |
| Track Epipolar Lines | Whether to track epipolar lines |
| NCC Extraction Interval | Extraction interval for DSM |
| Clip Amount | DEM clipping |
| Clip Units | Clipping units |
| SGM Extraction Interval | Extraction interval for SGM |
| Create DTM from DSM | Create DTM from DSM |
| Output DTM Pixel Size | Size of pixel in output DTM |
| Filter Type | Filter to apply during conversion |
| Terrain Type | Type of terrain |
| Create DEM Mosaic | Create DEM mosaic |
| DEM-Mosaic Method | Method to create the DEM mosaic |
| Tile Specification | Mosaic tile specification |
| Height | Height of the mosaic tile, in pixels |
| Width | Width of the mosaic tile, in pixels |
| Vertical Overlap | Vertical overlap between tiles |
| Horizontal Overlap | Horizontal overlap between tiles |
| Delete Empty Tiles | Whether to delete empty tiles |
| Clean Up Building Edges | Straighten building edges |
| Edge-Cleaning Filter Size | Size of edge-cleaning filter |
| Cutline Method | Cutline method |
| Cutline Method Extra Options | Cutline options |
| Auto Constrain | Constrain cutlines to image centers |
| Factor | Auto Constrain Factor value |
| Blend Width | Cutline blend width |
| Back to top |
Input Scenes
The name of the folder that contains a valid CATALYST Professional OrthoEngine project file (oe.prj), valid GDB-supported images, or a text file of images to be processed.
When only a folder name is specified, the module processes all recognized .tif and .pix image files in that folder.
Output Folder
The path and name of the folder to which to write the output files.
Output DEM Base Name
The base name of the output digital surface model (DSM) and digital terrain model (DTM) files. This name is prepended to all of the output DSM and DTM files.
If no value is specified for this parameter, the default digital elevation model (DEM) base name is dem.
Save Intermediate Files
Select this check box to save any supporting files created during processing.
By keeping the files, you can use them to analyze intermediate results and, if necessary, fix any minor issues. You can then restart the job without having to regenerate all the supporting data, thereby reducing processing time.
Overwrite Results
Select this check box to overwrite the existing output files, if any exist. If this check box is left clear, and an output file exists in the relevant folder, the status of the job displays a message informing you of the existence and name of the output file. The message is also written to the event log of the job.
Send Email
If necessary, you can set up CATALYST Enterprise to send an email notification on job start and job completion.
With this check box selected, an email message is sent to each address specified in the Email Addresses box after the job starts and on completion.
You can specify one or more addresses, and each must be separated by a comma or a semi-colon. The email address of the user currently logged in displays by default.
Output Pixel Size
The size of the output pixel in the DSM being created and, if applicable, the DTM. The size of the output pixel can be created either as a multiple of the ground sample distance (GSD) or you can specify a custom size.
Custom Size
Available when you select Custom for Output Pixel Size, the custom pixel size of the output DSM, DTM, or both.
For example, when Output Map Units is UTM, the output pixel size must be in meters. With Long/Lat, the output pixel size must be in decimal degrees.
Output Map Units
The projection of the output imagery.
The value of this parameter must be in the PCI Projection String format.
UTM: Universal Transverse Mercator
The value specified can be the UTM grid zone number and row, and Earth model, as follows:
UTM [mm] [r] [Ennn]
SPCS: State Plane Coordinate System
The SPCS zone number and Earth model can be specified as follows:
SPCS [mmmm] [Ennn]
LONG/LAT: Longitude and latitude
The Earth model can be specified for LONG/LAT (and other units except PIXEL), as follows:
LONG/LAT [Ennn]
If the Earth model is not specified, it is assumed to be E000 (Clarke 1866).
EPSG: European Petroleum Survey Group code
You can specify the projection by entering an EPSG code defined by the Open Geospatial Consortium (OGC). For information on the code definitions, visit epsg.org and spatialreference.org.
The EPSG code is specified using the EPSG keyword followed by an integer and separated by a colon; for example:
EPSG:4326
Most common EPSG codes are supported.
METER: Image along-row and along-column meters
FEET: Image along-row and along-column feet
LCC D350 | 0 0 3.0 46.5 44.0 49.0 700000 6600000 0 0 0 0 0 0 0 0 0 -1
If you do not specify a value for Output Map Units, the map unit of the input image is used for the output image. If the input data is a variety of map units, the map unit of each output image is that of its corresponding input image. In such a case, it is recommended that you specify the output map units.
You can also specify the label of a projection defined in the userproj.txt file.
Extraction Interval
The number of image pixels between the image locations at which an elevation value is computed, in both the along-row and along-column dimensions. The digital elevation model (DEM) cell dimension will approximate to the ground-projected pixel dimension of the image data multiplied by this value.
The available options are an Automatic option and values 1 through 32.
Although a higher value for this parameter causes the DEM to have a larger cell dimension and a lower level of detail, this also allows the DEM to be computed more quickly. The Automatic option determines the extraction interval based on the average resolution of the input imagery and the specified output DEM resolution.
Elevation Reference/Datum
The vertical reference for the elevation values in the source digital elevation model (DEM), or for the constant value of the Elevation Offset and Elevation Scale parameters, when available, and specified.
Available values are as follows:
Elevation Unit
The unit for the elevation values in the source digital elevation model (DEM).
Available values are as follows:
Failed Pixel Value
The value attributed to pixels containing distortion or incorrect elevation values.
If no value is specified, a default value of -500 is applied.
Background Elevation
The pixel value representing background elevation (pixels where no elevation value is present) in the input digital elevation model (DEM).
If no value is specified for this parameter, the module checks for ELEVATION_BACKGROUND or NO_DATA_VALUE metadata tags, first at the channel level, and then at the file level. If a value is neither specified nor found in the metadata, the default value of -32768 is used for 16S and 32R data, 65535 for 16U, and 0 for 8U.
Look Directions
The look directions to use for extraction of the DEM.
Available options are:
Bit Depth
The bit depth of the images of the selected look directions. Only images of a matching bit depth are used to create the DSM and DTM.
Cost Function
Available when Semi-global Matching is selected for Extraction Method, the cost function to use for SGM.
Penalties
Available when Semi-global Matching is selected for Extraction Method, the penalty value based on that selected for Cost Function.
Segment Size
Available when Semi-global Matching is selected for Extraction Method, the threshold at which to eliminate segments and interpolate values of the digital elevation model (DEM) from the surrounding data. A segment is a small, isolated group of matching pixels.
Typically, values ranging from 16 through 128 provide satisfactory results in most cases. The default value is 64. A value of zero (0) switches off the operation.
Semi-global Filter
The level of SGM filtering to apply to the output DSM.
Pattern Suppression
The level of pattern suppression to apply.
This option typically removes most smaller blunders without affecting other nonrelated features.
This option typically removes most blunders without affecting other nonrelated features.
This option typically removes almost all blunders and likely affects other nonrelated features. It can be effective when the required output is a digital terrain model (DTM) rather than a DSM.
Pattern suppression helps to reduce or eliminate blunders in the output digital surface model (DSM) with imagery that contains repeating patterns, such as rows of crops in an agricultural field or tiles on building roofs.
The higher the level of suppression, the greater the likelihood that degradation of other features occurs, such as loss of high building tops or small trees. If such features are important, consider selecting Low or doing no pattern suppression whatsoever. You may also want to consider manually removing the blunders or using pattern suppression only on problem images.
Track Epipolar Lines
Available only when you select a semi-global filter, select this check box to automatically track errors in epipolar lines. Tracking may increase quality, but may also increase computing time.
NCC Extraction Interval
The extraction interval for the DSM.
You can specify a value ranging from 1 through 32. Typically, a value of 1 (full-resolution) or 2 (half-resolution) is used for high detail. You can use a higher value, such as 8, to generate a quick preview, which you can use to check quality before generating the higher-resolution DSM.
Clip Amount
The amount of data to clip from the epipolar digital elevation models (DEM) before merging and geocoding.
This parameter specifies the amount of the actual image data that is clipped, either as a number of pixels or as a percentage of the image size.
You can select between Pixels or Percent using the Clip Units parameter.
For example:
The default is blank, which means no clipping occurs. The maximum percentage value is 49 percent.
Clip Units
The unit to use for the value of the Clip Amount parameter.
When you specify a value for the Clip Amount parameter, this parameter is mandatory; otherwise, it is not required.
SGM Extraction Interval
The extraction interval for the DSM.
You can specify a value of 1, 2, 4, 8, 16, or 32. Typically, a value of 1 (full-resolution) or 2 (half-resolution) is used for high detail. You can use a higher value, such as 8, to generate a quick preview, which you can use to check quality before generating the higher-resolution DSM.
Create DTM from DSM
Allows you to select whether to convert the output digital surface model (DSM) to a bare-Earth digital terrain model (DTM).
A DSM can have elevation values that reflect the top of canopy or top of buildings. However, for many processes, such as orthorectification, it is necessary to have a DTM that reflects the height of the bare Earth.
If you need more control over how the output DSM is converted to a DTM, then leave this parameter unchecked and use the DEM Convert (DSM to DTM) module after this job has completed.
Output DTM Pixel Size
The size of a pixel in the output digital terrain model (DTM).
The size is a multiple of the input DSM pixel size. The DSM is resampled accordingly.
If you need more control over how the output DSM is converted to a DTM, then uncheck Create DTM from DSM and use the DEM Convert (DSM to DTM) module after this job has completed.
Filter Type
The type of filter to apply when converting to the digital terrain model (DTM).
If you need more control over how the output DSM is converted to a DTM, then uncheck Create DTM from DSM and use the DEM Convert (DSM to DTM) module after this job has completed.
Terrain Type
The types of terrain in the scenes.
Create DEM Mosaic
With this check box selected, each extracted DSM pair is mosaicked into one or more DSMs. With check box cleared, a DSM file is created for each extracted DSM pair.
DEM-Mosaic Method
Select the method to use to create the DEM mosaic.
Tile Specification
The mosaic tiling scheme to use for the output DEM.
Height
The height of the mosaic tile, in pixels.The union of the extents of all of the source images is divided into a series of evenly sized and abutting rectangular tiles with the specified dimension.
Only tiles that actually intersect at least one of the source images is present in the output. The tiles at the far right and on the far bottom may overhang the extents of the source images. This is done to ensure that all tiles have the same dimensions.
TileID values are generated using the convention <column_number>_<row_number>. For example, the upper-left tile always has a TileID of "1_1", while the one immediately below it is "1_2", and so on.
For example:
10000
Width
The width of the mosaic tile, in pixels.The union of the extents of all of the source images is divided into a series of evenly sized and abutting rectangular tiles with the specified dimension.
Only tiles that actually intersect at least one of the source images is present in the output. The tiles at the far right and on the far bottom may overhang the extents of the source images. This is done to ensure that all tiles have the same dimensions.
TileID values are generated using the convention <column_number>_<row_number>. For example, the upper-left tile always has a TileID of "1_1", while the one immediately below it is "1_2", and so on.
For example:
10000
Vertical Overlap
The vertical overlap of each tile, in pixels.
Horizontal Overlap
The horizontal overlap of each tile, in pixels.
Delete Empty Tiles
Select whether to delete empty tiles. A tile is considered to be empty if all pixels in it have the value defined as NoData.
Clean Up Building Edges
With this check box selected, the filter straightens building edges in the DSM. When selected, you can use the default of 13 for Edge-Cleaning Filter Size, or select a new size.
While building edges are the intended target, the filter also affects trees and cliff edges. If the DSMs do not contain buildings, it is recommended that you clear the check box.
Edge-Cleaning Filter Size
The window size of the Clean Up Building Edges filter.
You can use the default of 13, or you can select a new size. Available sizes are odd integers ranging from 5 through 31. Larger sizes are well suited to buildings with long, straight edges, but may have an adverse affect on buildings with curved or complex edges. If the DSMs do not contain buildings, and you still want to use the filter, make sure the Clean Up Building Edges check box is selected, and then select a small-to-very-small window size.
Cutline Method
The cutline method used to generate polygons that enclose all the data from an image to be included in the output mosaic.
Cutline Method Extra Options
Additional options for Cutline Method.
You can specify options related to constraining polygons, which define regions where cutlines are allowed for each image, so that the generated cutlines do not cross the specified boundaries.
Values you specify for this parameter take precedence over Auto Constrain and Factor.
[<vector_file>], [<field_name>], [<segment_number>]
If the field_name is not specified, MOSPREP searches the vector-segment attributes for a field named ImageSource. If the specified field name or ImageSource does not exist, an error occurs.
If the segment number is not specified, the algorithm uses the last segment from the vector file you specified. If the constraining polygon is larger than the image being processed, cutline generation is not constrained.
Auto Constrain
Select whether and how to automatically generate and apply constraint polygons when creating cutlines. Constraint polygons define regions where cutlines are allowed for each image, so that the generated cutlines do not cross the specified boundaries. You can opt to have them generated automatically based on the layout and arrangement of the images being mosaicked.
You can adjust the effect of Auto Constrain by specifying an appropriate percentage value for Factor.
When a constraining layer is specified for Cutline Method Extra Options, do not use Auto Constrain; that is, select No.
Factor
The Factor is a percentage by which to adjust effect of the Auto Constrain option.
This is a value between 1 and 100, with larger values causing more overlap between the generated constraint polygons; that is, the cutlines is less constrained.
Blend Width
The perpendicular distance from the cutlines over which image blending occurs.
Image blending is to average the gray value of each pixel in the blending strip along a cutline from both overlapping input images. If no value is specified for this parameter, no blending is performed.
| Back to top |
Preprocessing requirements
Before running this module, the following requirements must be met to ensure the job processes successfully and produces accurate results:
Module details
The DEM Extraction ADS module searches for valid tri-stereo images to use to generate qualified stereo pairs. Images are accepted or reject according to the value of the Look Directions parameter and the Bit Depth parameter. Qualified stereo pairs are then processed as a series of child jobs.
If the Create DTM from DSM check box is selected, the module also creates DTMs from the DSMs. When and how the DTMs are created depends on various other parameters.
Job results
Where the TILE_ID values are generated using the convention <column_number>_<row_number>. The upper-left tile always has a TILE_ID of 1_1, the one immediately below has the TILE_ID of 1_2, and so on.
Given the base name ottawa, the following tiles could be created:
ottawa_dsm_1_1.pix, ottawa_dsm_2_1.pix, ottawa_dsm_3_1.pix
ottawa_dsm_1_2.pix, ottawa_dsm_2_2.pix, ottawa_dsm_3_2.pix
ottawa_dsm_1_3.pix, ottawa_dsm_2_3.pix, ottawa_dsm_3_3.pix
© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.