Summarize Elevation (Ready To Use)

Summary

Calculates summary statistics of elevation for each input feature.

Usage

  • Tools in the Ready To Use toolbox are ArcGIS Online geoprocessing services that use hosted data and analysis capabilities in ArcGIS Online.

  • This tool summarizes the elevation, slope, and aspect information for the input features. The returned elevation values are in meters. The slope and aspect values are calculated and returned in degrees.

    Three additional fields are returned that identify the DEM data source used in the calculation. Those fields are Product Name, Source, and Source URL.

  • There are several elevation sources available that have different spatial resolution and cover different areas. Not all resolutions are available for all areas. The tool will return an error message if the specified resolution is not available at any of the input feature locations.

  • The maximum number of input features is 1,000. If more than 1,000 input features are provided, the tool will return an error and will not execute.

  • If the DEM Resolution parameter is not supplied, 90 meter resolution SRTM data will be used. If Finest is specified, the tool will use the smallest resolution available at the input feature locations.

  • The tool uses a single resolution elevation source for the input features. The highest resolution elevation source that covers the extent all of the input features will be used.

  • The results are appended to the returned feature attribute table as fields. The MinElevation, MeanElevation, and MaxElevation fields summarize elevation. The MinSlope, MeanSlope, and MaxSlope fields summarize slope. The MeanAspect field summarizes aspect.

  • The returned features are in the same shape type as the input features. For example, if the input features are points, the returned features are also points.

  • Oceans and other major water bodies are ignored in the calculations and do not affect the summary values.

Parameters

LabelExplanationData Type
Input Features

The input point, line, or area features for which the elevation will be summarized.

Feature Set
Feature ID Field
(Optional)

The unique ID field to use for the input features.

String
DEM Resolution
(Optional)

Specifies the approximate spatial resolution (cell size) of the source elevation data used for the calculation.

The resolution keyword is an approximation of the spatial resolution of the digital elevation model. Many elevation sources are distributed in units of arc seconds; the keyword is an approximation in meters for easier understanding.

  • FinestThe finest units available for the extent are used.
  • 10 metersThe elevation source resolution is 1/3 arc second or approximately 10 meters.
  • 24 metersThe elevation source is the Airbus WorldDEM4Ortho dataset at 24 meters resolution.
  • 30 metersThe elevation source resolution is 1 arc second or approximately 30 meters.
  • 90 metersThe elevation source resolution is 3 arc seconds or approximately 90 meters. This is the default.
String
Include Slope and Aspect
(Optional)

Specifies whether slope and aspect values for the input features will be included in the output in addition to the elevation values.

  • Checked—Slope and aspect values will be included in the output.
  • Unchecked—Slope and aspect values will not be included in the output. This is the default.
Boolean

Derived Output

LabelExplanationData Type
Output Summary

The output summary statistics of elevation for each input feature.

Feature Set

arcpy.agolservices.SummarizeElevation(InputFeatures, {FeatureIDField}, {DEMResolution}, {IncludeSlopeAspect})
NameExplanationData Type
InputFeatures

The input point, line, or area features for which the elevation will be summarized.

Feature Set
FeatureIDField
(Optional)

The unique ID field to use for the input features.

String
DEMResolution
(Optional)

Specifies the approximate spatial resolution (cell size) of the source elevation data used for the calculation.

The resolution keyword is an approximation of the spatial resolution of the digital elevation model. Many elevation sources are distributed in units of arc seconds; the keyword is an approximation in meters for easier understanding.

  • FINESTThe finest units available for the extent are used.
  • 10mThe elevation source resolution is 1/3 arc second or approximately 10 meters.
  • 24mThe elevation source is the Airbus WorldDEM4Ortho dataset at 24 meters resolution.
  • 30mThe elevation source resolution is 1 arc second or approximately 30 meters.
  • 90mThe elevation source resolution is 3 arc seconds or approximately 90 meters. This is the default.
String
IncludeSlopeAspect
(Optional)

Specifies whether slope and aspect values for the input features will be included in the output in addition to the elevation values.

  • SLOPE_ASPECTSlope and aspect values will be included in the output.
  • NO_SLOPE_ASPECTSlope and aspect values will not be included in the output. This is the default.
Boolean

Derived Output

NameExplanationData Type
OutputSummary

The output summary statistics of elevation for each input feature.

Feature Set

Environments

This tool does not use any geoprocessing environments.

Related topics