Surface Length (3D Analyst)
Récapitulatif
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.
Legacy :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.
Utilisation
-
Use a smaller sampling distance to increase the accuracy of the surface length calculations.
-
Use {out_length_field} to give the length field a custom name.
-
Only polyline and polygon feature classes are valid inputs for this tool.
Syntaxe
| Paramètre | Explication | Type de données |
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 (Facultatif) |
The name of the attribute field to contain the surface length. | String |
sample_distance (Facultatif) |
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 (Facultatif) |
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 (Facultatif) |
The interpolation method. For raster surfaces, the only option is BILINEAR. Select LINEAR or NATURAL_NEIGHBORS. | String |
pyramid_level_resolution (Facultatif) |
Résolution de taille de fenêtre ou de tolérance z du niveau de pyramide de MNT qui sera utilisée par cet outil. La valeur par défaut est 0 (ou résolution maximale). | Double |
Exemple de code
L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python :
import arcgisscripting
gp = arcgisscripting.create()
gp.CheckOutExtension("3D")
gp.workspace = "C:/data"
gp.SurfaceLength_3d("elevation_tin", "lines.shp", "Length3D")