Oberflächenunterschied (3D Analyst)

Zusammenfassung

Berechnen Sie den Versatz zwischen zwei Oberflächen, um zu ermitteln, ob er sich über oder unter der anderen Oberfläche befindet oder mit ihr identisch ist.

Weitere Informationen zur Funktionsweise von "Oberflächenunterschied"

Verwendung

• Die Ausgabe stellt nur die überlappenden Teile der Eingabe-Oberflächen dar.

• Sie können ein Ausgabe-Raster oder TIN erstellen, um den Z-Unterschied zwischen der Eingabe- und der Bezugsfläche auszuwerten.

• Die horizontalen und vertikalen Koordinatensysteme der Eingabe-Oberflächen sollten übereinstimmen.

• Die Ausgabe-Feature-Class verfügt über Polygon-Features, die Regionen der Eingabe-Oberfläche danach trennen, ob sie sich über oder unter der Bezugsebene befinden oder identisch mit ihr sind. Die Attributtabelle enthält die folgenden Attributfelder:

  • Volume: Das Raumvolumen zwischen der Eingabe- und der Bezugsoberfläche, die durch das Polygon begrenzt ist. Das Volumen beträgt für Flächen, bei denen die beiden Oberflächen identisch sind, immer 0.
  • SArea: Die Oberfläche der Eingabeoberfläche, die durch das Polygon begrenzt ist.
  • Code: Ein numerischer Wert, der den Raumbezug der Oberfläche zur Bezugsebene beschreibt. -1 gibt an, dass sich die Oberfläche unter der Bezugsebene befindet, 0 gibt an, dass die Oberfläche mit der Bezugsebene identisch ist, und 1 gibt an, dass sich die Oberfläche über der Bezugsebene befindet.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Oberfläche	Die triangulierte Oberfläche, deren relativer Versatz über die Bezugsoberfläche ausgewertet wird.	LAS Dataset Layer; Terrain Layer; TIN Layer
Bezugsoberfläche	Die triangulierte Oberfläche, die als Basislinie zur Bestimmung des relativen Versatzes der Eingabeoberfläche verwendet wird.	LAS Dataset Layer; Terrain Layer; TIN Layer
Ausgabe-Feature-Class	Die Ausgabe-Feature-Class mit kontinuierlichen Dreiecken und Dreieckteilen mit derselben Klassifizierung gruppiert in Polygonen. Das von jedem abweichenden Bereich umschlossene Volumen ist in der Attributtabelle aufgeführt.	Feature Class
Analyseauflösung (optional)	Die Auflösung, die zum Erstellen der Eingabe-Oberfläche verwendet wird. Bei einem Terrain-Dataset entspricht dieser Wert den Definitionen auf Pyramidenebene, bei denen der Standard 0 die volle Auflösung darstellt. Bei einem LAS-Dataset entspricht dieser Wert der Länge der einzelnen Seiten der Quadratfläche, die zum Ausdünnen der LAS-Punktrückgaben verwendet wird.	Double
Bezugsanalyseauflösung (optional)	Die Auflösung, die zum Erstellen der Bezugsoberfläche verwendet wird. Bei einem Terrain-Dataset entspricht dieser Wert den Definitionen auf Pyramidenebene, bei denen der Standard 0 die volle Auflösung darstellt. Bei einem LAS-Dataset entspricht dieser Wert der Länge der einzelnen Seiten der Quadratfläche, die zum Ausdünnen der LAS-Punktrückgaben verwendet wird.	Double
Ausgabe-Raster (optional)	Die Ausgabe-Raster-Oberfläche, deren Werte die Eingabe-Oberfläche darstellen, die im Vergleich zur Bezugsfläche normalisiert wurde. Positive Werte geben die Bereiche an, in denen die Eingabeoberfläche über der zweiten Bezugsfläche liegt, wohingegen negative Werte die Bereiche angeben, in denen die Eingabeoberfläche unter der Bezugsfläche liegt. Die Werte des Rasters werden mittels linearer Interpolation von einem TIN abgeleitet.	Raster Dataset
Raster-Zellengröße (optional)	Die Zellengröße des Ausgabe-Rasters.	Double
Ausgabe-TIN-Ordner (optional)	Der Speicherort einer oder mehrerer TIN-Oberflächen, deren Werte den Unterschied zwischen der Eingabe-Oberfläche und der Bezugsfläche darstellen.	Folder
Ausgabe-TIN-Basisname (optional)	Der Basisname, der jeder Ausgabe-TIN-Oberfläche zugewiesen wird. Wenn ein TIN-Dataset nicht ausreicht, um die Daten darzustellen, werden mehrere TINs mit dem gleichen Basisnamen erstellt.	String
LAS-Ausdünnungsmethode	Die Methode, die beim Anwenden einer Analyseauflösung zum Ausdünnen der Eingabe-LAS-Dataset-Oberfläche für die Auswahl eines LAS-Punktes in einem Analysefenster verwendet wird. Die resultierenden Punkte werden zur Konstruktion einer triangulierten Oberfläche verwendet. Am nächsten zum Mittelwert gelegen—Verwendet wird der LAS-Punkt, dessen Wert dem Mittelwert aller LAS-Punkte im Analysefenster am nächsten ist. Dies ist die Standardeinstellung. Minimum—Der LAS-Punkt mit dem niedrigsten Z-Wert aller LAS-Punkte im Analysefenster. Maximum—Der LAS-Punkt mit dem höchsten Z-Wert aller LAS-Punkte im Analysefenster.	String
Bezugs-LAS-Ausdünnungsmethode	Die Methode, die beim Anwenden einer Analyseauflösung zum Ausdünnen der Eingabe-LAS-Dataset-Oberfläche für die Auswahl eines LAS-Punktes in einem Analysefenster verwendet wird. Die resultierenden Punkte werden zur Konstruktion einer triangulierten Oberfläche verwendet. Am nächsten zum Mittelwert gelegen—Verwendet wird der LAS-Punkt, dessen Wert dem Mittelwert aller LAS-Punkte im Analysefenster am nächsten ist. Dies ist die Standardeinstellung. Minimum—Der LAS-Punkt mit dem niedrigsten Z-Wert aller LAS-Punkte im Analysefenster. Maximum—Der LAS-Punkt mit dem höchsten Z-Wert aller LAS-Punkte im Analysefenster.	String
Verarbeitungsausdehnung (optional)	Die Ausdehnung der Daten, die von diesem Werkzeug ausgewertet werden. Aktuelle Anzeigeausdehnung : Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist. Ausdehnung darstellen : Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Bei dieser Option wird eine Feature-Class in der Projekt-Geodatabase erstellt und ein Layer zur Karte hinzugefügt. Das Koordinatensystem der Feature-Class stimmt mit dem der Karte überein. Hinweis: Diese Option ist im Dialogfeld Umgebungen nicht verfügbar. Sie ist nur über einen Werkzeugparameter mit dem Datentyp "Ausdehnung" oder über die Registerkarte Umgebungen eines Werkzeugdialogfeldes verfügbar. Hinweis: Wenn die Bearbeitungsoption Bearbeitung über die Registerkarte "Bearbeiten" aktivieren und deaktivieren aktiviert ist, dann müssen Sie auf der Registerkarte Bearbeiten des Menübands die Bearbeitung aktivieren, um die Ausdehnung darzustellen. Ausdehnung eines Layers: Die Ausdehnung basiert auf einem aktiven Karten-Layer. Verwenden Sie die Dropdown-Liste, um einen verfügbaren Layer auszuwählen, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern, um die kombinierte Ausdehnung aller aktiven Karten-Layer mit Ausnahme der Grundkarte zu erhalten. Diese Option ist nur verfügbar, wenn eine aktive Karte mit Layern vorhanden ist. Jeder Karten-Layer bietet die folgenden Optionen: Alle Features : Die Ausdehnung aller Features im Layer. Ausgewählte Features: Die Ausdehnung der ausgewählten Features im Layer. Sichtbare Features : Die Ausdehnung sichtbarer Features im Layer. Hinweis: Die Ausdehnungen der Optionen Ausgewählte Features und Sichtbare Features sind nur für Feature-Layer verfügbar. Durchsuchen: Die Ausdehnung basiert auf einem vorhandenen Dataset. Schnittmenge der Eingaben : Die Ausdehnung basiert auf der kleinsten oder überschneidenden Ausdehnung aller Eingaben. Wenn sich keine Eingaben überschneiden, entsteht eine Nullausdehnung. Vereinigungsmenge der Eingaben: Die Ausdehnung basiert auf der maximalen oder kombinierten Ausdehnung aller Eingaben. Zwischenablage : Die Ausdehnung kann in die und aus der Zwischenablage kopiert werden. Ausdehnung kopieren : Kopiert die Ausdehnungskoordinaten und das Ausdehnungskoordinatensystem in die Zwischenablage. Ausdehnung einfügen : Fügt die Ausdehnungskoordinaten und optional das Koordinatensystem aus der Zwischenablage ein. Wenn die Werte in der Zwischenablage kein Koordinatensystem beinhalten, wird für die Ausdehnung das Koordinatensystem der Karte verwendet. Hinweis: Beim Kopieren der Ausdehnungskoordinaten in die und Einfügen aus der Zwischenablage wird dieselbe Formatierung und Reihenfolge wie beim ArcPy-Objekt Extent verwendet: X-Min, Y-Min, X-Max, Y-Max und der Raumbezug. Ausdehnung zurücksetzen: Die Ausdehnung wird auf den Standardwert zurückgesetzt. Manuell eingegebene Koordinaten: Die Koordinaten müssen numerische Werte sein und im Koordinatensystem der aktiven Karte liegen. Vorsicht: Die Karte kann statt der eingegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Die Verwendung einer Kardinalrichtung (N, S, O, W) wird nicht unterstützt. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.	Extent
Verarbeitungsbegrenzung	Ein Polygon-Feature, das den Interessenbereich definiert, der verarbeitet werden soll.	Feature Layer

Python

arcpy.ddd.SurfaceDifference(in_surface, in_reference_surface, out_feature_class, {pyramid_level_resolution}, {reference_pyramid_level_resolution}, {out_raster}, {raster_cell_size}, {out_tin_folder}, {out_tin_basename}, method, reference_method, {extent}, boundary)

Name	Erläuterung	Datentyp
in_surface	Die triangulierte Oberfläche, deren relativer Versatz über die Bezugsoberfläche ausgewertet wird.	LAS Dataset Layer; Terrain Layer; TIN Layer
in_reference_surface	Die triangulierte Oberfläche, die als Basislinie zur Bestimmung des relativen Versatzes der Eingabeoberfläche verwendet wird.	LAS Dataset Layer; Terrain Layer; TIN Layer
out_feature_class	Die Ausgabe-Feature-Class mit kontinuierlichen Dreiecken und Dreieckteilen mit derselben Klassifizierung gruppiert in Polygonen. Das von jedem abweichenden Bereich umschlossene Volumen ist in der Attributtabelle aufgeführt.	Feature Class
pyramid_level_resolution (optional)	Die Auflösung, die zum Erstellen der Eingabe-Oberfläche verwendet wird. Bei einem Terrain-Dataset entspricht dieser Wert den Definitionen auf Pyramidenebene, bei denen der Standard 0 die volle Auflösung darstellt. Bei einem LAS-Dataset entspricht dieser Wert der Länge der einzelnen Seiten der Quadratfläche, die zum Ausdünnen der LAS-Punktrückgaben verwendet wird.	Double
reference_pyramid_level_resolution (optional)	Die Auflösung, die zum Erstellen der Bezugsoberfläche verwendet wird. Bei einem Terrain-Dataset entspricht dieser Wert den Definitionen auf Pyramidenebene, bei denen der Standard 0 die volle Auflösung darstellt. Bei einem LAS-Dataset entspricht dieser Wert der Länge der einzelnen Seiten der Quadratfläche, die zum Ausdünnen der LAS-Punktrückgaben verwendet wird.	Double
out_raster (optional)	Die Ausgabe-Raster-Oberfläche, deren Werte die Eingabe-Oberfläche darstellen, die im Vergleich zur Bezugsfläche normalisiert wurde. Positive Werte geben die Bereiche an, in denen die Eingabeoberfläche über der zweiten Bezugsfläche liegt, wohingegen negative Werte die Bereiche angeben, in denen die Eingabeoberfläche unter der Bezugsfläche liegt. Die Werte des Rasters werden mittels linearer Interpolation von einem TIN abgeleitet.	Raster Dataset
raster_cell_size (optional)	Die Zellengröße des Ausgabe-Rasters.	Double
out_tin_folder (optional)	Der Speicherort einer oder mehrerer TIN-Oberflächen, deren Werte den Unterschied zwischen der Eingabe-Oberfläche und der Bezugsfläche darstellen.	Folder
out_tin_basename (optional)	Der Basisname, der jeder Ausgabe-TIN-Oberfläche zugewiesen wird. Wenn ein TIN-Dataset nicht ausreicht, um die Daten darzustellen, werden mehrere TINs mit dem gleichen Basisnamen erstellt.	String
method	Die Methode, die beim Anwenden einer Analyseauflösung zum Ausdünnen der Eingabe-LAS-Dataset-Oberfläche für die Auswahl eines LAS-Punktes in einem Analysefenster verwendet wird. Die resultierenden Punkte werden zur Konstruktion einer triangulierten Oberfläche verwendet. CLOSEST_TO_MEAN—Verwendet wird der LAS-Punkt, dessen Wert dem Mittelwert aller LAS-Punkte im Analysefenster am nächsten ist. Dies ist die Standardeinstellung. MIN—Der LAS-Punkt mit dem niedrigsten Z-Wert aller LAS-Punkte im Analysefenster. MAX—Der LAS-Punkt mit dem höchsten Z-Wert aller LAS-Punkte im Analysefenster.	String
reference_method	Die Methode, die beim Anwenden einer Analyseauflösung zum Ausdünnen der Eingabe-LAS-Dataset-Oberfläche für die Auswahl eines LAS-Punktes in einem Analysefenster verwendet wird. Die resultierenden Punkte werden zur Konstruktion einer triangulierten Oberfläche verwendet. CLOSEST_TO_MEAN—Verwendet wird der LAS-Punkt, dessen Wert dem Mittelwert aller LAS-Punkte im Analysefenster am nächsten ist. Dies ist die Standardeinstellung. MIN—Der LAS-Punkt mit dem niedrigsten Z-Wert aller LAS-Punkte im Analysefenster. MAX—Der LAS-Punkt mit dem höchsten Z-Wert aller LAS-Punkte im Analysefenster.	String
extent (optional)	Die Ausdehnung der Daten, die von diesem Werkzeug ausgewertet werden. MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet. MINOF: Die minimale gemeinsame Fläche aller Eingaben wird verwendet. DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige. Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet. Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet. Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.	Extent
boundary	Ein Polygon-Feature, das den Interessenbereich definiert, der verarbeitet werden soll.	Feature Layer

Codebeispiel

SurfaceDifference - Beispiel 1 (Python-Fenster)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceDifference("sample.gdb/lidar/terrain", "flood_tin", "surface_diff.shp")

SurfaceDifference - Beispiel 2 (eigenständiges Skript)

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

'''****************************************************************************
Name: SurfaceDifference Example
Description: This script demonstrates how to use the
             SurfaceDifference tool.
****************************************************************************'''

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set Local Variables
inSurface = "flood_tin"
inReference = "elev_tin"

# Ensure output name is unique
outPoly = arcpy.CreateUniqueName("difference.shp")

# Execute SurfaceDifference
arcpy.ddd.SurfaceDifference(inSurface, inReference, outPoly)

Umgebungen

Aktueller Workspace, Ausdehnung, Ausgabe-Koordinatensystem, Geographische Transformationen, XY-Auflösung, XY-Toleranz, Ausgabe-XY-Domäne, Ausgabe-CONFIG-Schlüsselwort, Auto-Commit, Terrain-Speicherauslastung

Lizenzinformationen

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