Oberflächeninformationen hinzufügen (3D Analyst)
Zusammenfassung
Interpoliert Höheneigenschaften für Punkt-, Multipoint- und Polylinien-Features.
Verwendung
Z-Werte von 3D-Feature-Classes werden ignoriert. Alle Features werden als zweidimensionale Features behandelt.
-
Optionen für Ausgabeeigenschaften werden in die Attributtabelle der Eingabe-Feature-Class geschrieben und sind von der Geometrie des Features abhängig. In der folgenden Liste sind die Optionen aufgeführt, die für die einzelnen unterstützten Geometrietypen verfügbar sind:
- Punkt: Z
- Multipoint: Z-Minimum, Z-Maximum, Z-Mittelwert
- Polylinie: Z-Minimum, Z-Maximum, Z-Mitte, Oberflächenlänge, minimale Neigung, maximale Neigung, durchschnittliche Neigung
-
Neigungswerte für Linien-Features werden als Prozent oder Grad für die einzelnen Liniensegmente berechnet.
- Die Mindestneigung wird von dem Segment abgerufen, dessen Wert 0 am nächsten ist bzw. dem horizontalen Grad.
- Die Maximalneigung wird von dem Segment abgerufen, das den höchsten berechneten Wert aufweist.
- Die durchschnittliche Neigung wird abgerufen, indem die durchschnittliche Neigung aller Liniensegmente ermittelt wird, nachdem die einzelnen Segmente nach ihrer 3D-Länge gewichtet wurden. Dies führt zu längeren Segmenten, die im Gegensatz zu kürzeren Segmenten einen größeren Einfluss auf den sich ergebenden Wert haben.
Syntax
| Parameter | Erläuterung | Datentyp |
in_feature_class |
Die Input-Point-, Multipoint- oder Polyline-Feature-Class. | Feature Layer |
in_surface |
The raster, TIN, or terrain surface used for interpolating z-values. | Raster Layer; Terrain Layer; TIN Layer |
out_property | Die Oberflächen-Höheneigenschaft, die der Attributtabelle der Eingabe-Feature-Class hinzugefügt wird. In der folgenden Liste sind die verfügbaren Eigenschaftsschlüsselwörter und die von ihnen unterstützten Geometrietypen aufgeführt:
| String |
method (optional) |
Die Interpolationsmethode, die zum Ermitteln der Z-Werte für Eingabe-Features verwendet wird. Verfügbare Optionen:
| String |
sample_distance (optional) |
Der Abstand, bei dem Z-Werte interpoliert werden. Standardmäßig wird die Raster-Zellengröße verwendet, wenn die Eingabeoberfläche ein Raster ist. Die natürliche Verdichtung der triangulierten Oberfläche wird verwendet, wenn die Eingabe ein Terrain oder ein TIN-Dataset ist. | Double |
z_factor (optional) |
The factor by which elevation values will be multiplied. This is typically used to convert Z linear units that match those of the XY linear units. The default is 1, which leaves elevation values unchanged. | Double |
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 |
Codebeispiel
The following sample demonstrates the use of this tool in the Python window:
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.AddSurfaceInformation_3d("points.shp", "my_tin", "Z", "LINEAR")
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''*********************************************************************
Name: AddSurfaceInformation Example
Description: This script demonstrates how to use AddSurfaceInformation
on all 2D feature classes in a target workspace.
*********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
arcpy.CheckOutExtension("3D")
# Set Local Variables
env.workspace = 'c:/data'
inSurface = 'fgdb.gdb/municipal/terrain'
pyramid = 5
method = "BILINEAR"
# Create list of feature classes
fcList = arcpy.ListFeatureClasses()
if fcList:
for fc in fcList:
desc = arcpy.Describe(fc)
# Determine if the feature is 2D
if not desc.hasZ:
if desc.shapeType == "Polygon":
# Desired properties separated by semi-colons
Prop = "Z_MIN;Z_MAX"
elif desc.shapeType == "Point":
Prop = "Z"
elif desc.shapeType == "Multipoint":
Prop = "Z_MIN;Z_MAX;Z_MEAN"
elif desc.shapeType == "Polyline":
Prop = "LENGTH_3D"
# Execute AddSurfaceInformation
arcpy.ddd.AddSurfaceInformation(fc, inSurface, Prop,
method, 15, 1, pyramid)
print "Completed adding surface information."
arcpy.CheckInExtension('3D')
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)