Oberflächenkonturlinie (ArcGIS 3D Analyst)
Zusammenfassung
Erstellt Konturlinien, die mithilfe eines Terrains oder einer TIN-Oberfläche abgeleitet werden.
Weitere Informationen zur Funktionsweise von "Oberflächenkonturlinie"
Bild
Verwendung
Die Ausgabe-Feature-Class ist 2D und enthält ein Attribut mit Konturlinienwerten.
-
Passen Sie mithilfe der Optionen "Konturlinienintervall" und "Basiskonturlinie" die Ausdehnung und Auflösung der Ausgabe-Feature-Class an.
-
Konvertieren Sie mithilfe der Ausgabe-Konturlinienfelddaten die Feature-Class in 3D.
-
In bestimmten Fällen kann die letzte gültige Konturlinie erzeugt werden, wenn Konturen mit TIN-Oberflächen erstellt werden. Dies ist eine häufige Algorithmusbeschränkung bei Computersoftware für Konturen. Um sicherzustellen, dass alle gültigen Konturen erstellt werden, fügen Sie dem Feld Basiskonturlinie einen sehr kleinen negativen Wert hinzu, sodass die Daten leicht verschoben werden.
Der Parameter Z-Faktor hat nur eine Auswirkung auf Ergebnisse für Raster und TINs, nicht Terrain-Datasets. Wenn Sie mit Terrain-Datasets arbeiten, können Sie ein Konturlinienintervall mit integriertem Z-Faktor angeben. Wenn Sie z. B. ein Konturlinienintervall von einem Fuß Länge erstellen möchten und die Terrain-Dataset-Oberfläche in Meter angegeben ist, geben Sie ein Konturlinienintervall von 0,3048 an. Mit den Geoverarbeitungswerkzeugen Terrain zu Raster oder Terrain zu TIN können Sie auch das Terrain-Dataset in ein Raster oder TIN konvertieren.
Syntax
Parameter | Erläuterung | Datentyp |
in_surface |
Das Eingabe-Terrain oder TIN-Dataset. | Terrain Layer; TIN Layer |
out_feature_class |
Die Ausgabe-Feature-Class. | Feature Class |
interval |
Das Intervall zwischen den Konturlinien. | Double |
base_contour (optional) |
Die Basishöhe wird zusammen mit dem Indexintervall verwendet, um zu bestimmen, welche Konturlinien erzeugt werden. Die Basishöhe ist ein Ausgangspunkt, zu bzw. von dem das Indexintervall entweder addiert bzw. subtrahiert wird. Der Standardwert der Basiskonturlinie ist 0,0. | Double |
contour_field (optional) |
Das Feld, das den mit jeder Linie in der Ausgabe-Feature-Class verknüpften Konturlinienwert speichert. | String |
contour_field_precision (optional) |
Die Genauigkeit des Konturlinienfeldes. Der Wert 0 (Null) gibt eine Ganzzahl an, und die Ziffern 1 bis 9 bestimmen die Anzahl der Dezimalstellen des Feldes. Standardmäßig ist dieses Feld ganzzahlig (0). | Long |
index_interval (optional) |
Ein optionaler Wert, der den Höhenunterschied zwischen Indexkonturlinien angibt. Dieser Wert ist in der Regel fünfmal größer als das Konturlinienintervall. Wenn Sie diesen Parameter verwenden, wird der Ausgabe-Tabelle der Ausgabe-Feature-Class durch Indexintervallfeld ein Ganzzahlfeld hinzugefügt, in dem ein Wert von 1 die Indexkonturlinien definiert. | Double |
index_interval_field (optional) |
Der Name des Feldes, das angibt, ob eine Isolinie eine Indexkonturlinie ist. Dieses Feld wird nur verwendet, wenn das Indexintervall definiert wird. Der Feldname lautet standardmäßig Index. | String |
z_factor (optional) |
Gibt einen Faktor an, mit dem die Oberflächenhöhen multipliziert werden, um so Z-Einheiten in XY-Einheiten umzurechnen. Der Parameter Z-Faktor hat nur Auswirkung auf Ergebnisse für Raster und TINs, nicht Terrain-Datasets. | Double |
pyramid_level_resolution (optional) |
Der Z-Toleranzwert oder die Kachelungsauflösung der Terrain-Pyramidenebene, der bzw. die von diesem Werkzeug verwendet wird. Der Standardwert ist 0, also volle Auflösung. | Double |
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.SurfaceContour_3d("sample.gdb/featuredataset/terrain", "contour.shp", 10)
Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht:
'''****************************************************************************
Name: SurfaceContour Example
Description: This script demonstrates how to use the
SurfaceContour 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 = "sample.gdb/featuredataset/terrain"
outContour = arcpy.CreateUniqueName("contour.shp")
#Execute SurfaceContour
arcpy.SurfaceContour_3d(inSurface, outContour, 10)
del inSurface, outContour, arcpy