Oberflächeninformationen hinzufügen (Spatial Analyst)

Mit der 3D Analyst-Lizenz verfügbar.

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

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

Verwendung

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

  • Ausgabe-Eigenschaft-Optionen 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-GeometrieOberflä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 Gefälle.
    • Die maximale Neigung wird von dem Segment abgerufen, das den höchsten berechneten Wert aufweist.
    • Die durchschnittliche Neigung wird ermittelt, indem die einzelnen Neigungen mit ihrer 3D-Länge gewichtet werden und dann der Durchschnitt bestimmt wird. Dies führt zu längeren Segmenten, die im Gegensatz zu kürzeren Segmenten einen größeren Einfluss auf den sich ergebenden Wert haben.
  • Wenden Sie einen Rauschfilter an, 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

BeschriftungErläuterungDatentyp
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

Die Oberflächen-Höheneigenschaft, die der Attributtabelle der Eingabe-Feature-Class hinzugefügt wird. In der folgenden Liste sind die verfügbaren Eigenschaftenschlüsselwörter und die von ihnen unterstützten Geometrietypen aufgeführt:

  • ZFür die XY-Position interpolierte Oberflächenhöhe der einzelnen Punkt-Features.
  • Z-MinimumDie niedrigste Oberflächenhöhe in dem durch das Polygon definierten Bereich, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz.
  • Z-MaximumDie höchste Oberflächenhöhe in dem durch das Polygon definierten Bereich, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz.
  • Z-MittelwertDie durchschnittliche Oberflächenhöhe des durch das Polygon definierten Bereichs, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz.
  • Oberfläche3D-Oberfläche für die durch das Polygon definierte Region.
  • Oberflächenlänge3D-Entfernung der Linie entlang der Oberfläche.
  • Minimale NeigungDer 0 am nächsten gelegene Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche.
  • Maximale NeigungDer höchste Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche.
  • Durchschnittliche NeigungDer durchschnittliche Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche.
String
Methode
(optional)

Die Interpolationsmethode, die zum Ermitteln der Informationen zur Oberfläche verwendet wird. Die verfügbaren Optionen hängen vom Datentyp der Eingabeoberfläche ab:

  • BilinearEine ausschließlich für die Raster-Oberfläche vorgesehene Interpolationsmethode zur Bestimmung der Zellenwerte aus den vier nächstgelegenen Zellen. Dies ist die einzige Option, die für eine Raster-Oberfläche verfügbar ist.
  • Linear Standardinterpolationsmethode für TIN-, Terrain- und LAS-Datasets. Ruft den Höhenwert von der Ebene ab, die durch das Dreieck definiert wird, das die XY-Position eines Abfragepunktes enthält.
  • Natürliche Nachbarn Ruft den Höhenwert durch Anwenden von flächenbasierten Gewichtungen auf die natürlichen Nachbarn eines Abfragepunktes ab.
  • Z-Minimum abrufen Ruft den Höhenwert vom kleinsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab.
  • Z-Maximum abrufen Ruft den Höhenwert vom größten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab.
  • Nächstgelegenen Z-Wert abrufen Ruft den Höhenwert vom nächsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab.
  • Am nächsten zum Mittelwert gelegenen Z-Wert abrufen Ruft den Höhenwert von dem Z-Wert ab, 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)

Schließt Teile der Oberfläche, die potenziell anhand abweichender Messungen definiert werden, von den Neigungsberechnungen aus. Linien-Features bieten einen Längenfilter, während Polygone einen Flächenfilter bereitstellen. Der Wert, der einer der Filteroptionen entspricht, wird in den linearen Einheiten des Koordinatensystems des Features ausgewertet. Dieser Parameter hat keine Auswirkungen auf nicht neigungsbezogene Eigenschaften.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Eingabe-Features

Die aktualisierten Eingabe-Features.

Feature-Layer

AddSurfaceInformation(in_feature_class, in_surface, out_property, {method}, {sample_distance}, {z_factor}, {pyramid_level_resolution}, {noise_filtering})
NameErläuterungDatentyp
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,...]

Die Oberflächen-Höheneigenschaft, die der Attributtabelle der Eingabe-Feature-Class hinzugefügt wird. In der folgenden Liste sind die verfügbaren Eigenschaftenschlüsselwörter und die von ihnen unterstützten Geometrietypen aufgeführt:

  • ZFür die XY-Position interpolierte Oberflächenhöhe der einzelnen Punkt-Features.
  • Z_MINDie niedrigste Oberflächenhöhe in dem durch das Polygon definierten Bereich, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz.
  • Z_MAXDie höchste Oberflächenhöhe in dem durch das Polygon definierten Bereich, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz.
  • Z_MEANDie durchschnittliche Oberflächenhöhe des durch das Polygon definierten Bereichs, entlang einer Linie oder zwischen den interpolierten Punktwerten in einem Multipoint-Datensatz.
  • SURFACE_AREA3D-Oberfläche für die durch das Polygon definierte Region.
  • SURFACE_LENGTH3D-Entfernung der Linie entlang der Oberfläche.
  • MIN_SLOPEDer 0 am nächsten gelegene Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche.
  • MAX_SLOPEDer höchste Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche.
  • AVG_SLOPEDer durchschnittliche Neigungswert entlang der Linie oder innerhalb der durch das Polygon definierten Fläche.
String
method
(optional)

Die Interpolationsmethode, die zum Ermitteln der Informationen zur Oberfläche verwendet wird. Die verfügbaren Optionen hängen vom Datentyp der Eingabeoberfläche ab:

  • BILINEAREine ausschließlich für die Raster-Oberfläche vorgesehene Interpolationsmethode zur Bestimmung der Zellenwerte aus den vier nächstgelegenen Zellen. Dies ist die einzige Option, die für eine Raster-Oberfläche verfügbar ist.
  • LINEAR Standardinterpolationsmethode für TIN-, Terrain- und LAS-Datasets. Ruft den Höhenwert von der Ebene ab, die durch das Dreieck definiert wird, das die XY-Position eines Abfragepunktes enthält.
  • NATURAL_NEIGHBORS Ruft den Höhenwert durch Anwenden von flächenbasierten Gewichtungen auf die natürlichen Nachbarn eines Abfragepunktes ab.
  • CONFLATE_ZMIN Ruft den Höhenwert vom kleinsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab.
  • CONFLATE_ZMAX Ruft den Höhenwert vom größten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab.
  • CONFLATE_NEAREST Ruft den Höhenwert vom nächsten Z-Wert unter den natürlichen Nachbarn eines Abfragepunktes ab.
  • CONFLATE_CLOSEST_TO_MEAN Ruft den Höhenwert von dem Z-Wert ab, 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)

Schließt Teile der Oberfläche, die potenziell anhand abweichender Messungen definiert werden, von den Neigungsberechnungen aus. Linien-Features bieten einen Längenfilter, während Polygone einen Flächenfilter bereitstellen. Der Wert, der einer der Filteroptionen entspricht, wird in den linearen Einheiten des Koordinatensystems des Features ausgewertet. Dieser Parameter hat keine Auswirkungen auf nicht neigungsbezogene Eigenschaften.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
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.

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)

Lizenzinformationen

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

Verwandte Themen