Zusammenfassung
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.
Verwendung
Use a smaller sampling distance to increase the accuracy of the surface length calculations.
Use Surface Length Field parameter to give the length field a custom name.
Only polyline and polygon feature classes are valid inputs for this tool.
Syntax
arcpy.ddd.SurfaceLength(in_surface, in_feature_class, {out_length_field}, {sample_distance}, {z_factor}, {method}, {pyramid_level_resolution})| Parameter | Erklärung | Datentyp |
in_surface | The input raster, TIN, or terrain dataset whose values will be used for interpolation. | TIN Layer; Raster Layer; Terrain Layer |
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) | Die Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene, die von diesem Werkzeug verwendet wird. Der Standardwert ist 0, also volle Auflösung. | Double |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| output_feature_class |
Codebeispiel
SurfaceLength example 1 (Python window)
Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.
import arcgisscripting
gp = arcgisscripting.create()
gp.CheckOutExtension("3D")
gp.workspace = "C:/data"
gp.SurfaceLength_3d("elevation_tin", "lines.shp", "Length3D")
Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst
- Standard: Erfordert 3D Analyst
- Advanced: Erfordert 3D Analyst