Oberflächeninformationen hinzufügen (Spatial Analyst)

Zusammenfassung

Ordnet Eingabe-Features mit höhenbasierten statistischen Informationen zu, die von den überlappenden Teilen einer Oberfläche abgeleitet wurden.

Verwendung

• Die Statistik der Oberfläche wird für jede unterstützte Geometrie wie folgt bestimmt:

  • Für Punkte werden Z-Werte von den XY-Koordinaten auf der Oberfläche abgeleitet.
  • Für Linien werden Z-Eigenschaften abgerufen, indem die Oberflächenmesswerte entlang ihrer Länge interpoliert werden.
  • Für Polygone werden Z-Eigenschaften der triangulierten Oberfläche zusammengefasst, die aus der Oberfläche, die das Polygon schneidet, erstellt wurde.

  Kurven in Eingabe-Linien-Features werden unter Verwendung des Parameterwertes Abtastschrittweite in Liniensegmente verdichtet. Wenn keine Abtastschrittweite definiert ist, wird dieser Wert von der Eingabe-Oberfläche abgeleitet. Bei einem Raster entspricht die standardmäßige Abtastschrittweite der Zellengröße des Rasters. Bei einem TIN-, Terrain- oder LAS-Dataset basiert die Standardabtastung auf den Kanten, die von der triangulierten Oberfläche erzeugt werden. Durch das Verdichten von Kurven werden nicht alle Teile einer Kurve genau von den Ausgabewerten erfasst. Wenn die Kurve kürzer als die Abtastschrittweite ist, wird sie mithilfe ihrer Anfangs- und Endpunkte in eine 2-Punkt-Linie vereinfacht.

• 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.

• Alle Attribute werden auf Basis einer TIN-Oberfläche berechnet, die zum Interpolieren der Z-Informationen für die Eingabe-Features verwendet wird. Oberflächen, die keine TIN-Oberflächen sind, werden in ein temporäres TIN-Dataset konvertiert. Die Features werden auf die Grenze dieser TIN-Oberfläche zugeschnitten, und nur der gemeinsame Bereich von Features und Oberfläche wird evaluiert. Die Erstellung dieses TIN kann viel Zeit in Anspruch nehmen, wenn die Eingabe ein dichtes LAS-Dataset oder ein Raster mit hoher Auflösung ist. Wenn zu Analysezwecken eine niedrigere Auflösung für das TIN akzeptabel ist, kann entweder das Werkzeug Raster in TIN oder das Werkzeug LAS-Dataset in TIN verwendet werden, um eine ausgedünnte TIN-Oberfläche zur Verwendung mit diesem Werkzeug zu erstellen.

• Der Z-Mittelwert für ein Polygon wird berechnet, indem das TIN anhand des Polygons zugeschnitten und die Ergebnisse aus dem zugeschnittenen TIN abgeleitet werden. Für jedes Dreieck in diesem TIN wird der Z-Wert seines Mittelpunkts mit der 3D-Fläche des Dreiecks multipliziert. Die Ergebnisse dieser Berechnung für alle Dreiecke werden addiert, und anschließend wird die Summe durch die kumulative 3D-Fläche dieser Dreiecke dividiert, um das Endergebnis zu erhalten. Wenn ein großes Polygon-Feature zusammen mit einer Raster-Oberfläche angegeben wird, die eine große Anzahl an überlappenden Zellen aufweist, kann der Prozess wegen unzureichender Speicherressourcen, die für die Erstellung der temporären TIN-Oberfläche benötigt werden, fehlschlagen. In diesem Fall müssen Sie ein TIN mit einer niedrigeren Auflösung erstellen oder einen rasterbasierten Ansatz verwenden, um die erwarteten Ausgabeeigenschaften zu erhalten. Das Toolset "Zonale Statistiken" enthält mehrere Werkzeuge, mit denen Eigenschaften wie Gebiets-, Minimal-, Maximal- und Mittelwerte schneller abgeleitet werden können. Die Werkzeuge Flächentabellen erstellen und Zonale Statistiken als Tabelle liefern eine Ausgabetabelle, die mit dem Polygon-Feature verbunden werden kann. Um Neigungseigenschaften zu erhalten, können Sie ein Neigungsraster erstellen und eines dieser Werkzeuge ausführen. Wenn Sie nicht über die Spatial Analyst-Erweiterung verfügen, aber den Oberflächenbereich und das Oberflächenvolumen berechnen möchten, können Sie das Eingabe-Raster mit dem Polygon zuschneiden und das Werkzeug Oberflächenvolumen verwenden, das sowohl den Oberflächenbereich als auch das Oberflächenvolumen ausgibt.

• Linien-Features werden verarbeitet, indem die Linien auf die TIN-Oberfläche drapiert werden und an jeder Stelle, an der die Linie eine TIN-Kante kreuzt, ein Stützpunkt eingefügt wird. Linien mit Kurvensegmenten werden vor der Verarbeitung in kürzere gerade Segmente verdichtet. Der Z-Mittelwert für eine bestimmte Linie wird berechnet, indem der Mittelpunkt des Segments mit der 3D-Länge des Segments multipliziert wird. Anschließend werden die Ergebnisse dieser Berechnung für alle Liniensegmente addiert, und die Summe wird durch die kumulative 3D-Länge der Liniensegmente dividiert.

• 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 wahrscheinlich durch unerwartete Oberflächenmesswerte 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. Polygone werden intern in Multipatches (Sammlungen von Dreiecken) umgewandelt. Jedes dieser Dreiecke wird beim Drapieren auf die Oberfläche in der Regel in kleinere Dreiecke aufgeteilt, damit das gesamte Polygon mit der Oberfläche übereinstimmt. Der Z-Wert am Mittelpunkt jedes Dreiecks wird mit der 3D-Fläche des Dreiecks multipliziert. Die berechneten Produkte werden addiert, und anschließend wird die Summe durch die kumulative 3D-Fläche der Dreiecke dividiert, wodurch sich der gewichtete Mittelwert der Z-Werte an den Dreiecksmittelpunkten ergibt.

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öheneigenschaften an, die der Attributtabelle der Eingabe-Feature-Class hinzugefügt werden. 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—Es wird eine ausschließlich für die Raster-Oberfläche vorgesehene Interpolationsmethode zur Bestimmung der Zellenwerte aus den vier nächstgelegenen Zellen 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 nicht verfügbar, 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)	Definiert, 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, der Liniensegmente mit 3D-Längen, die den angegebenen Wert unterschreiten, aus den Neigungsberechnungen ausschließt. Polygon-Features bieten einen Flächenfilter, der Polygone, deren abgedeckter Oberflächenbereich den angegebenen Wert unterschreitet, ausschließt.	String

Abgeleitete Ausgabe

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

Python

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öheneigenschaften an, die der Attributtabelle der Eingabe-Feature-Class hinzugefügt werden. 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—Es wird eine ausschließlich für die Raster-Oberfläche vorgesehene Interpolationsmethode zur Bestimmung der Zellenwerte aus den vier nächstgelegenen Zellen 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 nicht verfügbar, 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)	Definiert, 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, der Liniensegmente mit 3D-Längen, die den angegebenen Wert unterschreiten, aus den Neigungsberechnungen ausschließt. Polygon-Features bieten einen Flächenfilter, der Polygone, deren abgedeckter Oberflächenbereich den angegebenen Wert unterschreitet, ausschließt.	String

Abgeleitete Ausgabe

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

Codebeispiel

AddSurfaceInformation: Beispiel 1 (Python-Fenster)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

from arcpy.sa import *
AddSurfaceInformation("point.shp", "dtm_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_Ex_02.py
# Description: This script demonstrates how to use AddSurfaceInformation 
# on a 2D point feature class in a target workspace.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set the local variables
inFeatureClass = "point.shp"
inSurface = "dtm_tin"
Prop = "Z"
method = "LINEAR"
pyramid = 5

# Execute the tool
AddSurfaceInformation(inFeatureClass, inSurface, Prop, method, 15, 1, pyramid)

Umgebungen

Aktueller Workspace, Ausdehnung, Geographische Transformationen, Auto-Commit

Lizenzinformationen

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