| Beschriftung | Erläuterung | Datentyp |
Eingabe-Raster | Das Eingabe-Oberflächen-Raster. | Raster Layer |
Ausgabe-Feature-Class | Die Ausgabe-Konturlinien-Features. | Feature Class |
Konturlinienintervall | Das Intervall bzw. der Abstand zwischen Konturlinien. Dies kann eine beliebige positive Zahl sein. | Double |
Basiskonturlinie (optional) | Der Basiskonturlinienwert. Konturlinien werden ober- und unterhalb dieses Wertes den Anforderungen entsprechend erstellt, um den gesamten Wertebereich des Eingabe-Rasters abzudecken. Die Standardeinstellung ist 0. | Double |
Z-Faktor (optional) | Der Einheit-Konvertierungsfaktor, der beim Erstellen von Konturlinien verwendet wird. Der Standardwert ist 1. Die Konturlinien werden basierend auf den Z-Werten im Eingabe-Raster erstellt, die oft in den Maßeinheiten Meter oder Fuß gemessen werden. Mit dem Standardwert 1 werden die Konturlinien in den gleichen Einheiten wie die Z-Werte im Eingabe-Raster angegeben. Um Konturlinien in einer anderen Einheit als derjenigen der Z-Werte zu erstellen, legen Sie den entsprechenden Wert für den Z-Faktor fest. Für dieses Werkzeug müssen die XY-Geländeeinheiten und die Z-Oberflächeneinheit nicht einheitlich sein. Wenn z. B. die Höhenwerte im Eingabe-Raster in Fuß angegeben sind, aber die Konturlinien basierend auf Metern erstellt werden sollen, legen Sie den Z-Faktor auf 0,3048 fest (1 Fuß = 0,3048 Meter). Ein weiteres Beispiel ist ein Eingabe-Raster in geographischen WGS84-Koordinaten und Metern als Höheneinheiten. Sie möchten alle 100 Fuß Höhenlinien erstellen, mit einer Basis von 50 Fuß (die Konturlinien sollen also bei 50 ft, 150 ft, 250 ft usw. liegen). Legen Sie hierfür das Konturlinienintervall auf 100, die Basiskonturlinie auf 50 und den Z-Faktor auf 3,2808 fest (1 Meter = 3,2808 Fuß). | Double |
Konturlinientyp (optional) | Gibt den Ausgabetyp an. In der Ausgabe können die Konturlinien als Linien oder Polygone dargestellt werden. Für Polygone gibt es verschiedene Optionen.
| String |
Maximale Stützpunkte pro Feature (optional) | Das Stützpunktlimit beim Unterteilen eines Features. Sie sollten dies nur nutzen, wenn Ausgabe-Features eine sehr große Anzahl von Stützpunkten enthalten (viele Millionen). Mit diesem Parameter können sehr große Features unterteilt werden, die später zur Problemen führen können, beispielsweise beim Speichern, Analysieren oder Zeichnen der Features. Wenn kein Wert angegeben ist, werden die Ausgabe-Polygone nicht aufgeteilt. Der Standardwert ist leer. | Long |
Zusammenfassung
Erstellt aus einer Raster-Oberfläche eine Line-Feature-Class von Konturlinien.
Weitere Informationen zur Funktionsweise des Werkzeugs "Konturlinien"
Verwendung
Konturlinien reichen nicht über die räumliche Ausdehnung des Rasters hinaus, und sie werden in Flächen mit NoData nicht generiert. Führen Sie zuerst eine Kantenanpassung benachbarter Konturlinieneingaben in ein kontinuierliches Feature-Dataset durch. Als Alternative zur Kantenanpassung können Sie angrenzende Raster auch zusammenführen, bevor Konturlinien berechnet werden.
Die Konturlinien-Polygone werden jedoch an den äußeren Rand des Rasters extrapoliert, wenn der Konturlinientyp nicht der Konturlinie entspricht.
Konturlinien können in Bereichen mit negativen Raster-Werten erstellt werden. In diesen Bereichen sind die Konturlinienwerte negativ. Negative Konturlinienintervalle sind nicht zulässig.
Glattere, aber weniger genaue Konturlinien erhalten Sie, indem Sie das Eingabe-Raster mit dem Werkzeug Focal Statistics und der Option Mittelwert oder mit dem Werkzeug Filter und der Option Wenig vorverarbeiten.
Eine Basiskonturlinie wird z. B. verwendet, um Konturlinien alle 15 Meter beginnend bei 10 Metern zu erstellen. In diesem Fall wird 10 als Basiskonturlinie verwendet und 15 als Konturlinienintervall. Die Konturlinienwerte lauten 10, 25, 40, 55 usw.
Durch das Angeben einer Basiskonturlinie wird das Erstellen von Konturlinien über oder unter diesem Wert nicht verhindert.
Mit dem Wert Konturlinientyp werden entweder Konturlinien oder Polygone erstellt. Wenn Sie zum Beispiel ein Raster mit Werten zwischen 0 und 575 haben und das Konturlinienintervall bei 250 liegt, dann werden die folgenden verschiedenen Ausgabe-Feature-Classes erstellt. Die tatsächliche Ausgabe sowie die einzelnen Komponentenpolygone werden separat dargestellt.
- CONTOUR: Linien bei 250 und 500
- CONTOUR_POLYGON: Nicht überlappende Polygone von 0–250, 250–500 und 500–575 (Abb. 1)
Abbildung 1. Die Option "Konturlinien-Polygon" erstellt drei nicht überlappende Polygone von 0–250, 250–500 und 500–575. - CONTOUR_SHELL: Überlappende Polygone von 0–575, 0–500 und 0–250 (Abb. 2)
Abbildung 2. Die Option "Konturbereich" erstellt drei überlappende Polygone von 0–575, 0–500 und 0–250. CONTOUR_SHELL_UP: Überlappende Polygone von 0–575, 250–575 und 500–575 (Abb. 3)
Abbildung 3. Die Option "Konturbereich aufsteigend" erstellt drei überlappende Polygone von 0–575, 250–575 und 500–575.
Mit dem Parameter Maximale Stützpunkte pro Feature können Sie ein Feature unterteilen. Sie sollten ihn nur nutzen, wenn Ausgabe-Features eine sehr große Anzahl von Stützpunkten enthalten würden (viele Millionen). Dieser Parameter erzeugt eine ähnliche Ausgabe, wie sie mit dem Werkzeug Stückeln erstellt wird.
Mit diesem Parameter können sehr große Features unterteilt werden, die später zur Problemen führen können, beispielsweise beim Speichern, Analysieren oder Zeichnen der Features.
Die Auswahl eines Limits hängt vom verfügbaren Speicher auf dem Computer ab, auf dem das Werkzeug ausgeführt wird, und von der Größe des Features (größere Features benötigen mehr Speicher). Die meisten modernen Computer mit 64-Bit-Software haben normalerweise keine Probleme mit einzelnen Features, die Hunderttausende oder Millionen von Stützpunkten enthalten. Bei Problemen kann das Festlegen dieses Parameters auf einen hohen Wert, z. B. 1 Million, die Probleme aufgrund der Größe eines Features verringern.
Mit dem Parameter "Stützpunktlimit" können Sie ein Feature unterteilen. Sie sollten ihn nur nutzen, wenn Ausgabe-Features eine sehr große Anzahl von Stützpunkten enthalten würden (viele Millionen).
Dieses Werkzeug verwendet standardmäßig Mehrkernprozessoren, wenn diese verfügbar sind. Es können maximal vier Kerne verwendet werden.
Wenn Sie weniger Kerne verwenden möchten, verwenden Sie die Umgebungseinstellung Faktor für parallele Verarbeitung.
Wenn die Umgebungseinstellung Ausdehnung angegeben ist und die linke untere Ecke der Ausgabeausdehnung keiner Zellenecke des Eingabe-Rasters entspricht, verschiebt sich die Zellausrichtung des Eingabe-Rasters während der Verarbeitung so, dass die angegebene Ausdehnung erreicht wird. Durch diese Verschiebung wird ein Resampling des Eingabe-Rasters unter Verwendung der bilinearen Methode ausgelöst. Folglich verschieben sich auch die Ausgabe-Features, und die daraus resultierenden Ausgabe-Features überlagern ggf. das ursprüngliche Eingabe-Raster nicht ganz. Sie können diese Verschiebung vermeiden, indem Sie das Eingabe-Raster für die Umgebungseinstellung Fang-Raster verwenden.
Parameter
Contour(in_raster, out_polyline_features, contour_interval, {base_contour}, {z_factor}, {contour_type}, {max_vertices_per_feature})| Name | Erläuterung | Datentyp |
in_raster | Das Eingabe-Oberflächen-Raster. | Raster Layer |
out_polyline_features | Die Ausgabe-Konturlinien-Features. | Feature Class |
contour_interval | Das Intervall bzw. der Abstand zwischen Konturlinien. Dies kann eine beliebige positive Zahl sein. | Double |
base_contour (optional) | Der Basiskonturlinienwert. Konturlinien werden ober- und unterhalb dieses Wertes den Anforderungen entsprechend erstellt, um den gesamten Wertebereich des Eingabe-Rasters abzudecken. Die Standardeinstellung ist 0. | Double |
z_factor (optional) | Der Einheit-Konvertierungsfaktor, der beim Erstellen von Konturlinien verwendet wird. Der Standardwert ist 1. Die Konturlinien werden basierend auf den Z-Werten im Eingabe-Raster erstellt, die oft in den Maßeinheiten Meter oder Fuß gemessen werden. Mit dem Standardwert 1 werden die Konturlinien in den gleichen Einheiten wie die Z-Werte im Eingabe-Raster angegeben. Um Konturlinien in einer anderen Einheit als derjenigen der Z-Werte zu erstellen, legen Sie den entsprechenden Wert für den Z-Faktor fest. Für dieses Werkzeug müssen die XY-Geländeeinheiten und die Z-Oberflächeneinheit nicht einheitlich sein. Wenn z. B. die Höhenwerte im Eingabe-Raster in Fuß angegeben sind, aber die Konturlinien basierend auf Metern erstellt werden sollen, legen Sie den Z-Faktor auf 0,3048 fest (1 Fuß = 0,3048 Meter). Ein weiteres Beispiel ist ein Eingabe-Raster in geographischen WGS84-Koordinaten und Metern als Höheneinheiten. Sie möchten alle 100 Fuß Höhenlinien erstellen, mit einer Basis von 50 Fuß (die Konturlinien sollen also bei 50 ft, 150 ft, 250 ft usw. liegen). Legen Sie hierfür contour_interval auf 100, base_contour auf 50 und z_factor auf 3,2808 fest (da 1 Meter = 3,2808 Fuß). | Double |
contour_type (optional) | Gibt den Ausgabetyp an. In der Ausgabe können die Konturlinien als Linien oder Polygone dargestellt werden. Für Polygone gibt es verschiedene Optionen.
| String |
max_vertices_per_feature (optional) | Das Stützpunktlimit beim Unterteilen eines Features. Sie sollten dies nur nutzen, wenn Ausgabe-Features eine sehr große Anzahl von Stützpunkten enthalten (viele Millionen). Mit diesem Parameter können sehr große Features unterteilt werden, die später zur Problemen führen können, beispielsweise beim Speichern, Analysieren oder Zeichnen der Features. Wenn kein Wert angegeben ist, werden die Ausgabe-Polygone nicht aufgeteilt. Der Standardwert ist leer. | Long |
Codebeispiel
In diesem Beispiel werden Konturlinien aus einem Esri Grid-Raster erstellt und als Shapefile ausgegeben.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
Contour("elevation", "C:/sapyexamples/output/outcontours.shp", 200, 0)In diesem Beispiel werden Konturlinien aus einem Esri Grid-Raster erstellt und als Shapefile ausgegeben.
# Name: Contour_Ex_02.py
# Description: Creates contours or isolines from a raster surface.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "elevation"
contourInterval = 200
baseContour = 0
outContours = "C:/sapyexamples/output/outcontours02.shp"
# Execute Contour
Contour(inRaster, outContours, contourInterval, baseContour)