Oberflächeninformationen hinzufügen (3D Analyst)

Zusammenfassung

Ordnet Features räumliche Daten zu, die von einer Oberfläche abgeleitet wurden.

Verwendung

• Die Z-Werte von 3D-Features werden ignoriert. Jedes Feature fasst Z-Eigenschaften von Oberflächen zusammen, die dessen Geometrie überschneiden. Punkte leiten Z-Werte von der XY-Position auf der Oberfläche ab, Linien rufen Z-Eigenschaften ab, indem sie Messwerte entlang der Oberfläche interpolieren, und Polygone fassen die Z-Eigenschaften der Oberfläche in ihrer Fläche zusammen.

• Die Optionen des Parameters Ausgabe-Eigenschaft werden in die Attributtabelle des Eingabe-Features geschrieben. Jedes Feature definiert die Position der bewerteten Oberflächeneigenschaften, und welche Eigenschaften gemeldet werden können, hängt von der Geometrie des Features ab.

  Feature-Geometrie	Oberflächeneigenschaften
  Punkt	Aus der XY-Koordinate des Punktes auf der Oberfläche interpolierte SPOT-Höhe
  Multipoint	Minimum, Maximum und Mittelwert der SPOT-Höhe für alle Punkte im Multipoint-Datensatz
  Polylinie	3D-Entfernung der Linie entlang der Oberfläche Minimum, Maximum und Mittelwert der Höhe und Neigung der Linie entlang der Oberfläche
  Polygon	3D-Fläche der Oberfläche, die das Polygon überlappt Minimum, Maximum und Mittelwert der Höhe und Neigung aus der Oberfläche

• Neigungswerte werden in Prozenteinheiten (Grad) gemessen und bei Linien-Features für jedes Segment der Linie berechnet.

  • Die minimale Neigung wird aus dem Segment ermittelt, dessen Wert 0 am nächsten ist bzw. dem horizontalen Grad.
  • Die maximale Neigung wird von dem Segment abgerufen, das den höchsten berechneten Wert aufweist.
  • Die durchschnittliche Neigung einer Polylinie wird abgerufen, indem ein gewichteter Durchschnitt der Neigung jedes Liniensegments gebildet wird. Die Gewichtung basiert auf der 3D-Länge der einzelnen Segmente. Dies führt dazu, dass längere Segmente im Gegensatz zu kürzeren Segmenten einen größeren Einfluss auf die resultierende Berechnung haben.

• Verwenden Sie den Parameter Rauschfilter, um Teile der Oberfläche, die anhand abweichender Messungen definiert werden, von den Neigungsberechnungen auszuschließen. Linien-Features werden durch Stützpunkte segmentiert, die das Profil der Oberfläche erfassen, und durch die Filterung dieser Segmente nach Länge wird der Einfluss kurzer Segmente, die möglicherweise durch unerwünschte Oberflächenmessungen verursacht werden, beseitigt. Entsprechend schließt der Bereichsfilter für Polygon-Features Splitterdreiecke in triangulierten Oberflächen von den Neigungsberechnungen aus. Für Raster-Oberflächen wird eine Teilmenge von Zellenschwerpunkten zum Erstellen einer triangulierten Oberfläche verwendet, auf die der Bereichsfilter angewendet wird.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Punkt-, Multipoint-, Polylinien- oder Polygon-Features, die die Positionen für die Bestimmung einer oder mehrerer Oberflächeneigenschaften definieren.	Feature Layer
Eingabe-Oberfläche	Die LAS-Dataset-, Mosaik-, Raster-, Terrain- oder TIN-Oberfläche zum Interpolieren von Z-Werten.	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Ausgabe-Eigenschaft	Gibt die Oberflächen-Höheneigenschaft an, die der Attributtabelle der Eingabe-Feature-Class hinzugefügt wird. Z—Die für die XY-Position interpolierte Oberflächenhöhe der einzelnen Punkt-Features wird hinzugefügt. Z-Minimum—Die niedrigste Oberflächenhöhe in dem durch das Polygon definierten Bereich, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz wird hinzugefügt. Z-Maximum—Die höchste Oberflächenhöhe in dem durch das Polygon definierten Bereich, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz wird hinzugefügt. Z-Mittelwert—Die durchschnittliche Oberflächenhöhe des durch das Polygon definierten Bereichs, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz wird hinzugefügt. Oberfläche—Die 3D-Oberfläche für die durch das Polygon definierte Region wird hinzugefügt. Oberflächenlänge—Die 3D-Entfernung der Linie entlang der Oberfläche wird hinzugefügt. Minimale Neigung—Der 0 am nächsten gelegene Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche wird hinzugefügt. Maximale Neigung—Der höchste Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche wird hinzugefügt. Durchschnittliche Neigung—Der durchschnittliche Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche wird hinzugefügt.	String
Methode (optional)	Gibt die Interpolationsmethode an, die zum Ermitteln der Informationen zur Oberfläche verwendet wird. Bilinear—Eine ausschließlich für die Raster-Oberfläche vorgesehene Interpolationsmethode zur Bestimmung der Zellenwerte aus den vier nächstgelegenen Zellen wird verwendet. Dies ist die einzige Option, die für eine Raster-Oberfläche verfügbar ist. Linear—Der Höhenwert wird von der Ebene abgerufen, die durch das Dreieck definiert wird, das die XY-Position eines Abfragepunktes enthält. Dies ist die Standard-Interpolationsmethode für TINs, Terrains und LAS-Datasets. Natürliche Nachbarn—Der Höhenwert wird durch Anwenden von flächenbasierten Gewichtungen auf die natürlichen Nachbarn eines Abfragepunktes abgerufen. Z-Minimum abrufen—Der Höhenwert wird vom kleinsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. Z-Maximum abrufen—Der Höhenwert wird vom größten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. Nächstgelegenen Z-Wert abrufen—Der Höhenwert wird vom nächsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. Am nächsten zum Mittelwert gelegenen Z-Wert abrufen—Der Höhenwert wird von dem Z-Wert aberufen, der dem Durchschnitt aller natürlichen Nachbarn eines Abfragepunktes am nächsten liegt.	String
Abtastschrittweite (optional)	Der Abstand, bei dem Z-Werte interpoliert werden. Standardmäßig wird die Raster-Zellengröße verwendet, wenn die Eingabe-Oberflä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-Faktor (optional)	Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Der Parameter ist deaktiviert, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt.	Double
Auflösung der Pyramidenebene (optional)	Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0, also volle Auflösung.	Double
Rauschfilterung (optional)	Gibt an, ob Teile der Oberfläche, die potenziell anhand abweichender Messungen definiert werden, von den Neigungsberechnungen ausgeschlossen werden. Dieser Parameter hat keine Auswirkungen auf andere Eigenschaften. Linien-Features bieten einen Längenfilter, mit dem Liniensegmente, deren 3D-Längenwerte den angegebenen Wert unterschreiten, aus Neigungsberechnungen ausgeschlossen werden. Polygon-Features bieten einen Flächenfilter, mit dem Polygone, deren Oberfläche den angegebenen Wert unterschreitet, ausgeschlossen werden.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabe-Features	Die aktualisierten Eingabe-Features.	Feature Layer

Python

arcpy.ddd.AddSurfaceInformation(in_feature_class, in_surface, out_property, {method}, {sample_distance}, {z_factor}, {pyramid_level_resolution}, {noise_filtering})

Name	Erläuterung	Datentyp
in_feature_class	Die Punkt-, Multipoint-, Polylinien- oder Polygon-Features, die die Positionen für die Bestimmung einer oder mehrerer Oberflächeneigenschaften definieren.	Feature Layer
in_surface	Die LAS-Dataset-, Mosaik-, Raster-, Terrain- oder TIN-Oberfläche zum Interpolieren von Z-Werten.	LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_property [out_property,...]	Gibt die Oberflächen-Höheneigenschaft an, die der Attributtabelle der Eingabe-Feature-Class hinzugefügt wird. Z—Die für die XY-Position interpolierte Oberflächenhöhe der einzelnen Punkt-Features wird hinzugefügt. Z_MIN—Die niedrigste Oberflächenhöhe in dem durch das Polygon definierten Bereich, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz wird hinzugefügt. Z_MAX—Die höchste Oberflächenhöhe in dem durch das Polygon definierten Bereich, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz wird hinzugefügt. Z_MEAN—Die durchschnittliche Oberflächenhöhe des durch das Polygon definierten Bereichs, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz wird hinzugefügt. SURFACE_AREA—Die 3D-Oberfläche für die durch das Polygon definierte Region wird hinzugefügt. SURFACE_LENGTH—Die 3D-Entfernung der Linie entlang der Oberfläche wird hinzugefügt. MIN_SLOPE—Der 0 am nächsten gelegene Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche wird hinzugefügt. MAX_SLOPE—Der höchste Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche wird hinzugefügt. AVG_SLOPE—Der durchschnittliche Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche wird hinzugefügt.	String
method (optional)	Gibt die Interpolationsmethode an, die zum Ermitteln der Informationen zur Oberfläche verwendet wird. BILINEAR—Eine ausschließlich für die Raster-Oberfläche vorgesehene Interpolationsmethode zur Bestimmung der Zellenwerte aus den vier nächstgelegenen Zellen wird verwendet. Dies ist die einzige Option, die für eine Raster-Oberfläche verfügbar ist. LINEAR—Der Höhenwert wird von der Ebene abgerufen, die durch das Dreieck definiert wird, das die XY-Position eines Abfragepunktes enthält. Dies ist die Standard-Interpolationsmethode für TINs, Terrains und LAS-Datasets. NATURAL_NEIGHBORS—Der Höhenwert wird durch Anwenden von flächenbasierten Gewichtungen auf die natürlichen Nachbarn eines Abfragepunktes abgerufen. CONFLATE_ZMIN—Der Höhenwert wird vom kleinsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. CONFLATE_ZMAX—Der Höhenwert wird vom größten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. CONFLATE_NEAREST—Der Höhenwert wird vom nächsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes abgerufen. CONFLATE_CLOSEST_TO_MEAN—Der Höhenwert wird von dem Z-Wert aberufen, der dem Durchschnitt aller natürlichen Nachbarn eines Abfragepunktes am nächsten liegt.	String
sample_distance (optional)	Der Abstand, bei dem Z-Werte interpoliert werden. Standardmäßig wird die Raster-Zellengröße verwendet, wenn die Eingabe-Oberflä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)	Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Der Parameter ist deaktiviert, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt.	Double
pyramid_level_resolution (optional)	Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0, also volle Auflösung.	Double
noise_filtering (optional)	Gibt an, ob Teile der Oberfläche, die potenziell anhand abweichender Messungen definiert werden, von den Neigungsberechnungen ausgeschlossen werden. Dieser Parameter hat keine Auswirkungen auf andere Eigenschaften. Linien-Features bieten einen Längenfilter, mit dem Liniensegmente, deren 3D-Längenwerte den angegebenen Wert unterschreiten, aus Neigungsberechnungen ausgeschlossen werden. Polygon-Features bieten einen Flächenfilter, mit dem Polygone, deren Oberfläche den angegebenen Wert unterschreitet, ausgeschlossen werden.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
output_feature_class	Die aktualisierten Eingabe-Features.	Feature Layer

Codebeispiel

AddSurfaceInformation – Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

arcpy.env.workspace = "C:/data"
arcpy.AddSurfaceInformation_3d("points.shp", "my_tin", "Z", "LINEAR")

AddSurfaceInformation – Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht.

'''*********************************************************************
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

# Set Local Variables
arcpy.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.")

Umgebungen

Aktueller Workspace, Ausdehnung, Geographische Transformationen, Auto-Commit

Lizenzinformationen

• Basic: Erfordert 3D Analyst
• Standard: Erfordert 3D Analyst
• Advanced: Erfordert 3D Analyst