Topo zu Raster aus Datei (Spatial Analyst)
Zusammenfassung
Interpoliert eine hydrologisch korrekte Raster-Oberfläche anhand von Punkt-, Linien- und Polygondaten unter Verwendung von in einer Datei angegebenen Parametern.
Weitere Informationen zur Funktionsweise von "Topo zu Raster"
Verwendung
-
In der Parameterdatei sind zuerst die Eingabe-Datasets, dann die Parametereinstellungen und schließlich die Ausgabeoptionen angegeben.
Die Eingabedaten bestimmen die Eingabe-Datasets und, falls zutreffend, -Felder. Es gibt sechs Eingabetypen: Konturlinien, Punkte, Senken, Wasserläufe, Seen und Grenzen. Die Zahl der Eingaben ist unbegrenzt, sollte jedoch auf ein vernünftiges Maß beschränkt werden. Die Reihenfolge der Eingaben hat keine Auswirkung auf das Ergebnis. <Path> ist der Pfad zu einem Dataset, <Item> ist ein Feldname und <#> ist der einzugebende Wert.
In der folgenden Tabelle sind alle Parameter, die einzelnen Definitionen und die Syntax aufgeführt.
Parameter
Definition
Syntax
Eingabe-Datasets: Konturlinien
Das Konturlinien-Dataset mit einem Feld, das Höhenwerte enthält.
Contour <Path> <Item> Punkte
Das Punkt-Dataset mit einem Feld, das Höhenwerte enthält.
Point <Path> <Item> Senken
Das Punkt-Dataset mit den Positionen der Senken. Wenn das Dataset Höhenwerte für die Senken enthält, geben Sie diesen Feldnamen als <Item> an. Sollen nur die Positionen der Senken verwendet werden, wählen Sie für <Item> den Wert NONE.
Sink <Path> <Item> Wasserläufe
Ein Linien-Dataset für Wasserläufe. Höhenwerte sind nicht erforderlich.
Stream <Path> Seen
Ein Polygon-Dataset für Seen. Höhenwerte sind nicht erforderlich.
Lake <Path> Grenze
Ein Polygon-Dataset für Grenzen. Höhenwerte sind nicht erforderlich.
Boundary <Path> Parametereinstellungen:
Drainagedurchführung
Legt fest, ob eine Drainagedurchführung angewendet wird.
ENFORCE <ON | OFF | ON_WITH_SINK> Datentyp
Haupttyp der Eingabedaten.
DATATYPE <CONTOUR | SPOT> Iterationen
Die maximale Anzahl der vom Algorithmus durchgeführten Iterationen.
ITERATIONS <#> Rauigkeitsbeiwert
Das Maß für die Oberflächenrauigkeit.
ROUGHNESS_PENALTY <#> Diskretisierungsfehlerfaktor
Der Umfang, mit dem die Datenglättung der Eingabedaten in einem Raster angepasst wird.
DISCRETE_ERROR_FACTOR <#> Vertikaler Standardfehler
Die Menge an Zufallsfehlern in den Z-Werten der Eingabedaten.
VERTICAL_STANDARD_ERROR <#> Toleranzen
Die erste Toleranz ist die Genauigkeit von Höhendaten in Bezug auf die Oberflächendrainage, die zweite verhindert die Drainage-Durchführung aufgrund unrealistisch hoher Barrieren.
TOLERANCES <#> <#> Z-Beschränkungen
Untere und obere Höhengrenzen.
ZLIMITS <#> <#> Ausdehnung
Die minimalen und maximalen XY-Koordinatengrenzen.
EXTENT <#> <#> <#> <#> Zellengröße
Die Auflösung des endgültigen Ausgabe-Rasters.
CELL_SIZE <#> Rand
Entfernung in Zellen für die Interpolation über die angegebene Ausgabeausdehnung und -grenze hinaus.
MARGIN <#> Ausgaben:
Ausgabe-Gewässer-Features
Die Ausgabe-Line-Feature-Class der Wasserlauf-Polylinien-Features und Bergrücken-Linien-Features.
OUT_STREAM Ausgabe-Senken-Features
Die Ausgabe-Point-Feature-Class der verbleibenden Punkt-Features für Senken.
OUT_SINK Ausgabe-Diagnosedatei
Der Name und Speicherort der Diagnosedatei.
OUT_DIAGNOSTICS <Path> -
Geben Sie in der Parameterdatei keine Pfade für die optionalen Ausgabe-Feature-Datasets an. Verwenden Sie die Optionen Ausgabe-Polylinien-Features der Gewässer und Verbleibende Ausgabe-Punkt-Features für Senken im Werkzeugdialogfeld, um diese Ausgaben festzulegen.
-
Es folgt ein Beispiel für den Inhalt einer Parameterdatei.
Contour D:\data\contours2\arc HEIGHT Point D:\data\points2\point SPOTS Sink D:\data\sinks_200.shp Stream D:\data\streams\arc Lake D:\data\lakes\polygon Boundary D:\data\clipcov\polygon ENFORCE ON DATATYPE CONTOUR ITERATIONS 40 ROUGHNESS_PENALTY 0.00000000000 DISCRETE_ERROR_FACTOR 1.00000000000 VERTICAL_STANDARD_ERROR 0.00000000000 TOLERANCES 2.50000000000 100.00000000000 ZLIMITS -2000.00000000000 13000.00000000000 EXTENT -810480.62500000000 8321785.00000000000 810480.62500000000 10140379.00000000000 CELL_SIZE 1800.00000000000 MARGIN 20 OUT_STREAM OUT_SINK OUT_DIAGNOSTICS D:\data\ttr_diag.txt
Syntax
| Parameter | Erläuterung | Datentyp |
in_parameter_file |
Die Eingabe-ASCII-Textdatei mit den Eingaben und Parametern für die Interpolation. Diese Datei wird normalerweise durch eine frühere Ausführung der Funktion Topo zu Raster erstellt, wobei die optionale Ausgabe-Parameterdatei angegeben wird. Sie können das Ergebnis der Änderung von Parametern leichter testen, indem Sie diese Datei bearbeiten und die Interpolation erneut ausführen, anstatt jedes Mal das Werkzeug Topo zu Raster ordnungsgemäß zu nutzen. | File |
out_stream_features (optional) |
Ausgabe-Feature-Class der Wasserlauf-Polylinien-Features. | Feature Class |
out_sink_features (optional) |
Ausgabe-Feature-Class der verbleibenden Punkt-Features für Senken. | Feature Class |
Rückgabewert
| Name | Erläuterung | Datentyp |
| out_surface_raster |
Das Ausgabe-Raster für die interpolierte Oberfläche. | Raster |
Codebeispiel
In diesem Beispiel wird ein hydrologisch korrektes TIFF-Oberflächen-Raster anhand einer Parameterdatei erstellt, in der die Punkt-, Linien- und Polygondaten definiert sind.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTTRByFile = TopoToRasterByFile("topotorasterbyfile.txt",
"C:/sapyexamples/output/out_streams.shp")
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout.tif")
In diesem Beispiel wird ein hydrologisch korrektes Grid-Oberflächen-Raster anhand einer Parameterdatei erstellt, in der die Punkt-, Linien- und Polygondaten definiert sind.
# Name: TopoToRasterByFile_Ex_02.py
# Description: Interpolates a hydrologically correct
# surface from point, line, and polygon data using
# parameters specified in a file.
# 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
inParameterFile = "topotorasterbyfile.txt"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute TopoToRasterByFile
outTTRByFile = TopoToRasterByFile(inParameterFile)
# Save the output
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")