Go to ToolBox Implementation | Go to .NET Implementation |

Calculates several characteristics of PolylineZs. The results are stored in fields in the polyline attribute
table.

The results are stored in the attribute table of the input layer or in a new
feature class

**Inputs:**

- A 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 GeoWizards is used to derive the Z values, the NODATA value is 999999. 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.

**Outputs:**

The results are stored in the attribute table of the input dataset or in a new feature class. The linear measures are in the units of the spatial reference of the input dataset. The slope is measured in decimal degrees (from -90 to +90). The following fields are added to the attribute table

- [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
- [Len_Up] - distance uphill
- [Len_Down] - distance downhill
- [H_Up] - total increase in height
- [H_Down] - total decrease in height
- [Av_S_Up] - average slope uphill
- [Max_S_Up] - maximum slope uphill
- [Av_S_Down] - average slope downhill
- [Max_S_Down] -maximum slope downhill

**ToolBox
implementation
**(Go to TOP)

**Command line syntax**

ET_GPGetZChars<input_dataset> <out_feature class> {linear_precision} {angular_precision} {nodata}

**Parameters**

Expression | Explanation |
---|---|

<input_dataset> | A Polyline or Polygon feature class or feature layer |

<out_feature class> | A String - the full name of the output feature class (A feature class with the same full name should not exist) |

{linear_precision} | A Double - the number of digits after the decimal point for linear measures. |

{angular_precision} | A Double - the number of digits after the decimal point for angular measures. |

{nodata} | A Double - represents undefined Z values. |

**Scripting syntax**

ET_GPGetZChars(input_dataset, out_feature class,linear_precision,angular_precision, nodata)

See the explanations above:

<> - required parameter

{} - optional parameter

**.NET implementation**
(Go to TOP)

GetZCharacteristics(pInFC As IFeatureClass, sOutFName As String,Optional iLinearPrecision As Short = 2, Optional iAngularPrecision As Short = 2, Optional dNodata As Double = 999999999) As IFeatureClass

Copyright © Ianko Tchoukanski |