Surface Length (3D Analyst)

License Level:BasicStandardAdvanced

Summary

Calculates the surface length for each polyline or polygon feature based on a raster, triangulated irregular network (TIN), or terrain dataset surface.

The surface length information is stored as an attribute of the input feature class.

LegacyLegacy:

This is a deprecated tool. To learn more about how this tool works click here to view archived documentation. This functionality has been added to the Add Surface Information tool.

Usage

Syntax

SurfaceLength_3d (in_surface, in_feature_class, {out_length_field}, {sample_distance}, {z_factor}, {method}, {pyramid_level_resolution})
ParameterExplanationData Type
in_surface

The input raster, TIN, or terrain dataset whose values will be used for interpolation.

TIN layer; raster layer; terrain lLayer
in_feature_class

The input polygon or polyline feature class.

Feature layer
out_length_field
(Optional)

The name of the attribute field to contain the surface length.

String
sample_distance
(Optional)

The surface spacing at which the length is calculated. By default, the sampling distance is the natural densification of a TIN or the cell size of a raster.

Double
z_factor
(Optional)

The factor multiplied by input surface values to store new values in the length field. The Z factor is used to convert z-units to match x,y units.

Double
method
(Optional)

The interpolation method. For raster surfaces, the only option is BILINEAR. Select LINEAR or NATURAL_NEIGHBORS.

String
pyramid_level_resolution
(Optional)

The z-tolerance or window-size resolution of the terrain pyramid level that will be used by this tool. The default is 0, or full resolution.

Double

Code Sample

SurfaceLength example 1 (Python window)

The following sample demonstrates the use of this tool in the Python window:

import arcgisscripting
gp = arcgisscripting.create()

gp.CheckOutExtension("3D")
gp.workspace = "C:/data"
gp.SurfaceLength_3d("elevation_tin", "lines.shp", "Length3D")

Environments

Licensing Information

ArcGIS for Desktop Basic: Requires 3D Analyst
ArcGIS for Desktop Standard: Requires 3D Analyst
ArcGIS for Desktop Advanced: Requires 3D Analyst
3/7/2014