Zusammenfassung
Berechnet den Volumenunterschied zwischen zwei Oberflächenmodellen, die entweder als unregelmäßige Dreiecksnetze (Triangulated Irregular Networks, TIN) oder als Terrain-Dataset gespeichert sind.
Weitere Informationen zur Funktionsweise von "Oberflächenunterschied"
Verwendung
- Die Ausgabe stellt nur die überlappenden Teile der Eingabe-Oberflä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
SurfaceDifference_3d (in_surface, in_reference_surface, out_feature_class, {pyramid_level_resolution}, {reference_pyramid_level_resolution}, {raster_cell_size}, {out_raster}, {out_tin_folder}, {out_tin_basename})| 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 Auflösung des Eingabe-Terrain-Datasets auf Pyramidenebene. Der Standardwert ist 0, also volle Auflösung. | Double |
reference_pyramid_level_resolution (optional) | Die Auflösung des Referenz-Terrain-Datasets auf Pyramidenebene. 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
SurfaceDifference - Beispiel 1 (Python-Fenster)
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")
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
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
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Erfordert 3D Analyst
- ArcGIS for Desktop Standard: Erfordert 3D Analyst
- ArcGIS for Desktop Advanced: Erfordert 3D Analyst