- URL:https://<orthomappingtools-url>/GenerateDEM
- Version Introduced:10.6.1
Description
The GenerateDEM operation is a service tool that allows you to generate DEM products from a previously adjusted image collection. It creates point clouds using adjusted image collections and interpolates the point clouds to create DEM surface products using the designated method.
License:
As of ArcGIS 10.5, you must license your ArcGIS Server as an ArcGIS Image Server to use this resource.
Request parameters
Parameter | Details |
---|---|
imageCollection | The image collection (mosaic dataset) name or URL. The image service must exist before calling the service to generate a DEM. Syntax: A JSON object supports three keys: itemId, url, and uri. These keys are case sensitive. Example: |
outputDEM (Required) | This is the output digital elevation model image URL or name. As with Raster Analysis services, the service can be an existing multitenant service URL, or this service tool can create it. Syntax: A JSON object describes the output image collection name or URL.
|
cellSize (Required) | The cell size of the output digital elevation model image. This is a single numeric input. The cell size unit will be the unit used by the image collection's spatial reference. Only square cell sizes are supported. |
surfaceType (Required) | The output surface type of the digital elevation model. The following are the available choices:
|
matchingMethod (Optional) | The method used to generate 3D points. The following are the available options:
|
context (Optional) | Additional settings, such as the allowed point cloud generation parameter and DEM interpolation parameter, can be assigned here. Additional settings include:
Note:Both the applyToOrtho and fillDEM flag can be added to the initial request. applyToOrtho applies the generated DEM back into the mosaic dataset's geometric function to achieve more accurate orthorectification results. The fillDEM flag allows you to specify an elevation service url as background elevation to fill the area when elevation model pixels cannot be interpolated from the point cloud.
|
f | The response format. The default response format is html. Values: html | json |
Response
When you submit a request, the task assigns a unique job ID for the transaction.
Syntax:{
"jobId": "<unique job identifier>",
"jobStatus": "<job status>"
}
After the initial request is submitted, you can use jobId to periodically review the status of the job and messages as described in Checking job status. Once the job has successfully completed, use jobId to retrieve the results. To track the status, you can make a request of the following form:
https://<orthomapping service url>/GenerateDEM/jobs/<jobId>
When the status of the job request is esriJobSucceeded, you can access the results of the analysis by making a request of the following form:
https://<orthomapping service url>/GenerateDEM/jobs/<jobId>/results/result?token=<your token>&f=json
The result will be the image service URL and itemId of the DEM.
Example usage
Below is a sample URL for GenerateDEM.
https://services.myserver.com/arcgis/rest/services/System/OrthomappingTools/GPServer/GenerateDEM
JSON Request example
imageCollection={"itemId": "1780d648db3545bba8661ad98df824a4"}&
outputDEM={"serviceProperties": {"name":"dronedtm"}}&
cellSize=5&
surfaceType=DTM&
matchingMethod=SGM&
context={
"maxObjectSize": 50,
"groundSpacing": None,
"minAngle": 10,
"maxAngle": 70,
"minOverlap": 0.6,
"maxOmegaPhiDf": 8,
"maxGSDDif": 2,
"numImagePairs": 2,
"adjQualityThreshold": 0.2,
"method": "TRIANGULATION",
"smoothingMethod": "GAUSS5x5",
"applyToOrtho": True
}
References
Heiko Hirschmuller et al., "Memory Efficient Semi-Global Matching," ISPRS Annals of the Photogrammetry, Remote Sensing and Spatial Information Sciences, Volume 1-3, (2012): 371-376.