Oberflächenunterschied (ArcGIS 3D Analyst)
Zusammenfassung
Berechnet den Volumenunterschied zwischen zwei Oberflächenmodellen, die entweder als triangulierte unregelmäßige Netzwerke (TIN) oder als Terrain-Dataset gespeichert sind.
Weitere Informationen zur Funktionsweise von "Oberflächenunterschied"
Verwendung
- Die Ausgabe stellt nur die überlappenden Teile der Eingabeoberflächen dar.
Die Dreiecke von der ersten Oberfläche werden als vollständig oberhalb oder vollständig unterhalb der zweiten Oberfläche (Referenzoberfläche) oder als die Oberfläche schneidend klassifiziert.
- Optional können ein Ausgabe-Raster oder ein oder mehrere TIN-Datasets generiert werden, um das Ergebnis anzuzeigen.
Wenn ein Ausgabe-Raster angefordert wird, konvertiert das Werkzeug das integrierte Differenz-TIN, das während des geometrischen Vergleichs berechnet wurde, mit linearer Interpolation in ein Raster.
- Die horizontalen und vertikalen Koordinatensysteme der Eingabe-Oberflächen sollten übereinstimmen.
Syntax
| Parameter | Erläuterung | Datentyp |
in_surface |
Das Eingabe-Terrain oder TIN-Dataset. | Terrain Layer; TIN Layer |
in_reference_surface |
Das Referenz-Terrain-Dataset oder Referenz-TIN-Dataset. | 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 Pyramidenebene Auflösung des Eingabe-Terrain-Datasets. Der Standardwert ist 0, also volle Auflösung. | Double |
reference_pyramid_level_resolution (optional) |
Die Pyramidenebene Auflösung des Referenz-Terrain-Datasets. Der Standardwert ist 0, also volle Auflösung. | Double |
raster_cell_size (optional) |
Die Zellengröße des Ausgabe-Raster-Datasets. | Double |
out_raster (optional) |
Das Ausgabe-Raster-Dataset mit den Unterschieden. Dieses Raster wird mit linearer Interpolation aus dem integrierten Differenz-TIN konvertiert. | Raster Dataset |
out_tin_folder (optional) |
Der Speicherort, in den das TIN oder die TINs geschrieben werden. | 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 |
Codebeispiel
Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SurfaceDifference_3d("sample.gdb/featuredataset/terrain", "sample.gdb/featuredataset/terrain2", "surface_diff.shp")
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
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
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.SurfaceDifference_3d(inSurface, inReference, outPoly)
del arcpy, inSurface, inReference, outPoly