Profile (Ready To Use)

Summary

Returns elevation profiles for the input line features.

Usage

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

  • The output from this tool is polyline features with elevation values extracted along the input line features for each vertex. The elevation values are stored as z-values in the shape geometry. The distance values are stored as m-values in the shape geometry. The input polyline vertices can be densified to different degrees using the Maximum Sample Distance parameter.

  • The maximum number of input lines is 1,000 for the asynchronous profile service. For the synchronous profile service, the maximum number of input lines is 100. If more than the allowed number of input lines are provided, the service will return an error and will not execute.

  • The returned line features are in the same coordinate system as the input line features. The z- and m-values of the vertices are in meters.

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

  • When the Maximum Sample Distance parameter is not supplied, a default sampling distance is calculated based on the number of available vertices on the input line feature. If the input line feature contains less than 50 vertices, the default sampling distance is the length of the input line feature divided by 49. If the input line feature contains more than 50 but less than 200 vertices, the default sampling distance is the length of the input line feature divided by 199. If the input line feature contains more than 200 vertices but less than or equal to 1,024 vertices, the input line feature will not be densified if the Maximum Sample Distance parameter is not specified.

  • The maximum number of elevation values returned from the service is 2,000 times the number of input lines. The service will return an error message and will not execute if a request results in more than this maximum number of elevation values. If this occurs, specify a larger sampling distance, input a line feature with fewer vertices, or both.

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

  • The Length Meters output field contains the length of the profile line calculated as a geodesic distance, which is the correct length regardless of the coordinate system of the data. This length will be different from the shape_length attribute due to the effects of map projection distortion. The DEMResolution output field records the source DEM resolution used by the tool.

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

Syntax

arcpy.agolservices.Profile(InputLineFeatures, {ProfileIDField}, {DEMResolution}, {MaximumSampleDistance}, {MaximumSampleDistanceUnits})
ParameterExplanationData Type
InputLineFeatures

The line features that will be profiled over the surface inputs.

Feature Set
ProfileIDField
(Optional)

A unique identifier to associate profiles with their corresponding input line 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.
  • 1000mThe elevation source resolution is 30 arc seconds or approximately 1000 meters.
  • 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
MaximumSampleDistance
(Optional)

The maximum sample distance along the line used to sample elevation values.

Double
MaximumSampleDistanceUnits
(Optional)

Specifies the units for the Maximum Sample Distance parameter.

  • MetersThe units are meters. This is the default.
  • KilometersThe units are kilometers.
  • FeetThe units are feet.
  • YardsThe units are yards.
  • MilesThe units are miles.
String

Derived Output

NameExplanationData Type
OutputProfile

The output elevation profiles for the input line features.

Feature Set

Environments

This tool does not use any geoprocessing environments.

Related topics