ETS_SplitPolylineZBySlope

Split PolylineZ based on slope direction change.

Splits the polylines of PolylineZ dataset in the points of change of the direction of the slope. Several characteristics of the resulting PolylineZ features are calculated and populated in the attribute table. Optionally a point feature class that contains the turning points (Ridges and Valleys) can be created.

Inputs:

A PolylineZ feature layer
Output PolylineZ feature layer
Linear precision - the number of digits after the decimal point for linear measures
Angular precision - the number of digits after the decimal point for angular measures
NODATA value - a number that represents undefined Z values. If the Z values of a geometry are interpolated from a surface and some of the vertices of the geometry are outside of the extent of the surface, they will not have Z values. Since ArcGIS does not accept NaN (Not a Number) values in Z enabled shapes, a numeric value is assigned to these vertices. If the Features To 3D function of ET Surface is used to derive the Z values, the NODATA value is -1000000000. When calculating Z characteristics this values need to be ignored. Segments that have a vertex with NODATA Z value will be ignored in the calculations.
Units for slope calculations (percent or degrees)
Optional. Name of the output point feature class.

Outputs:

A PolylineZ feature class. Each polyline have segments with positive (upwards), negative (downwards) or Zero slope. The attribute table will contain all original attributes. The following fields will be added:
- [3D_Length] - the true 3D length of the polyline
- [2D_Length] - the 2D length of the polyline
- [Max_Z] - Maximum Z value
- [Min_Z] - Minimum Z value
- [DeltaH] - the difference in Z between the start and end point of the polyline.
- [Slope_Dir] - the direction of the slope for this polyline. The values can be Up, Down, Flat or Undefined (for segments that contain NODATA Z values)
- [Max_Slope] - the maximum slope
- [Min_Slope] - the minimum slope
- [Slope] - average slope calculated based on the Z values of the start and end points of the polyline and the 2D length.
Optional. A Point dataset that contains the turning points (Ridges and Valleys). The following fields will be included in the attribute table
- [ET_Z] - the Z value of the point
- [ET_Type] - the type of the turning point - Ridge or Valley.

Running Programmatically

(Go to TOP)

Parameters

Expression	Explanation
Function Name	SplitPolylineZ
<input polylines>	A String - full path to the Input PolylineZ dataset.
<output polylines>	A String - the full path to the output PolylineZ layer.
{linear precision}	An Integer representing the number of digits after the decimal point for linear measures.
{angular precision}	An Integer representing the number of digits after the decimal point for angular measures.
{NoData}	A Double - see explanations above.
{slope percent}	A Boolean indicating whether the slope will be calculated in percent. If False the calculations will be performed in Degrees.
{output points}	A String - full path to the output Ridge/Valley points dataset.

Running the function

ETSPath used in the table below is the full path to ETSRun.exe (E.G. "C:\Program Files\ETSpatial Techniques\ETSurface\ETSRun.exe")

Language	Syntax
Python	subprocess.call([ETSPath, "SplitPolylineZ", "input polylines", "output polylines", "linear precision", "angular precision", "NoData", "slope percent", "output points"])
.NET using ETSRun.exe	StartInfo.FileName = ETSPath StartInfo.Arguments = "SplitPolylineZ" "input polylines" "output polylines" "linear precision" "angular precision" "NoData" "slope percent" "output points"
.NET using ETSOutX.dll	SplitPolylineZ(input polylines, output polylines, linear precision, angular precision, NoData, slope percent, output points)
ArcPy	arcpy.SplitPolylineZ("input polylines", "output polylines", "linear precision", "angular precision", "NoData", "slope percent", "output points")

Notes:

<> - required parameter
{} - optional parameter
See examples for Python , .NET or ArcPy
The argument separator for StartInfo.Arguments is space. If a string might contain a space, you need to double quote it.

(Go to TOP)