Topo zu Raster aus Datei (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der 3D Analyst-Lizenz verfügbar.

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 neun Eingabetypen: Konturlinien, Punkte, Senken, Wasserläufe, Seen, Grenzen, Klippen, Ausschluss und Küsten-Polygone. 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, ihre Definitionen und die Syntax aufgeführt.

  Parameter	Definition	Syntax
  Eingabe-Datasets:
  Konturlinien	Das Konturlinien-Dataset mit einem Feld, das Höhenwerte enthält.	Contour <Pfad> <Element>
  Punkte	Das Punkt-Dataset mit einem Feld, das Höhenwerte enthält.	Point <Pfad> <Element>
  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 <Element> an. Sollen nur die Positionen der Senken verwendet werden, wählen Sie für <Element> den Wert <NONE>.	Sink <Pfad> <Element>
  Wasserläufe	Ein Linien-Dataset für Wasserläufe. Höhenwerte sind nicht erforderlich.	Wasserlauf <Pfad>
  Seen	Ein Polygon-Dataset für Seen. Höhenwerte sind nicht erforderlich.	See <Pfad>
  Grenze	Ein Polygon-Dataset für Grenzen. Höhenwerte sind nicht erforderlich.	Grenze <Pfad>
  Klippe	Linien-Dataset der Klippen. Für "Klippe" gibt es nicht die Option "Field".	Klippe <Pfad>
  Ausschluss	Ausschluss-Polygon-Dataset der Gebiete, in denen die Eingabedaten ignoriert werden sollten. Für "Ausschluss" gibt es nicht die Option "Field".	Ausschluss <Pfad>
  Küste	Küsten-Polygon-Dataset mit dem Umriss eines Küstengebiets. Für "Küste" gibt es nicht die Option "Field".	Grenze <Pfad>
  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 <Zahl>
  Rauigkeitsbeiwert	Das Maß für die Oberflächenrauigkeit.	ROUGHNESS_PENALTY <Zahl>
  Rauigkeitsbeiwert für Profilkrümmung	Der Rauigkeitsbeiwert der Vertikalkrümmung ist ein lokaler adaptiver Beiwert, der zum teilweisen Ersetzen der Gesamtkrümmung verwendet werden kann.	PROFILE_PENALTY <Zahl>
  Diskretisierungs-Fehlerfaktor	Der Umfang, mit dem die Datenglättung der Eingabedaten in einem Raster angepasst wird.	DISCRETE_ERROR_FACTOR <Zahl>
  Vertikaler Standardfehler	Die Menge an Zufallsfehlern in den Z-Werten der Eingabedaten.	VERTICAL_STANDARD_ERROR <Zahl>
  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 <Zahl> <Zahl>
  Z-Beschränkungen	Untere und obere Höhengrenzen.	ZLIMITS <Zahl> <Zahl>
  Ausdehnung	Die minimalen und maximalen XY-Koordinatengrenzen.	EXTENT <Zahl> <Zahl> <Zahl> <Zahl>
  Zellengröße	Die Auflösung des endgültigen Ausgabe-Rasters.	CELL_SIZE <Zahl>
  Rand	Entfernung in Zellen für die Interpolation über die angegebene Ausgabeausdehnung und -grenze hinaus.	MARGIN <Zahl>
  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>
  Ausgabe-Punkt-Features für Residuen	Die Ausgabe-Punkt-Feature-Class aller großen Höhenresiduen, wie sie vom lokalen Diskretisierungsfehler skaliert werden.	OUT_RESIDUALS
  Ausgabe-Gewässer- und Klippen-Punkt-Features	Die Ausgabe-Point-Feature-Class von Positionen, an denen Gewässer- und Klippenfehler auftreten können.	OUT_STREAM_CLIFF_ERRORS
  Ausgabe-Punkt-Features für Konturlinienfehler	Die Ausgabe-Punkt-Feature-Class möglicher Fehler, die zu den Eingabe-Konturliniendaten gehören.	OUT_CONTOUR_ERRORS

• In Datenformaten, die NULL-Werte unterstützen (z. B. Feature-Classes in File-Geodatabases), wird ein als Eingabe verwendeter NULL-Wert ignoriert.

• 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
       Cliff D:\data\cliffs.shp 
       ENFORCE ON
       DATATYPE CONTOUR
       ITERATIONS 40
       ROUGHNESS_PENALTY 0.0
       PROFILE_PENALTY 0.5
       DISCRETE_ERROR_FACTOR 1.0
       VERTICAL_STANDARD_ERROR 0.0
       TOLERANCES 2.5 100.0
       ZLIMITS -2000.0 13000.0
       EXTENT -810480.625 8321785.0 810480.625 10140379.0
       CELL_SIZE 1800.00000000000
       MARGIN 20
       OUT_DIAGNOSTICS D:\data\ttr_diag.txt

• Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabeparameterdatei	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
Ausgabe-Polylinien-Features der Gewässer (optional)	Ausgabe-Feature-Class der Wasserlauf-Polylinien-Features. Die Polylinien-Features werden wie folgt codiert: 1. Eingabe-Wasserlauf nicht über Klippe. 2. Eingabe-Wasserlauf über Klippe (Wasserfall). 3. Drainage-Durchführung entfernt eine unkorrekte Senke. 4. Aus Kontureckpunkt bestimmter Wasserlauf. 5. Aus Kontureckpunkt bestimmter Bergkamm. 6. Code nicht verwendet. 7. Nebenbedingungen für Wasserlaufdaten. 8. Code nicht verwendet. 9. Linie mit großem Höhendatenabstand.	Feature Class
Verbleibende Ausgabe-Punkt-Features für Senken (optional)	Ausgabe-Feature-Class der verbleibenden Punkt-Features für Senken.	Feature Class
Ausgabe-Punkt-Features für Residuen (optional)	Die Ausgabe-Punkt-Feature-Class aller großen Höhenresiduen, wie sie vom lokalen Diskretisierungsfehler skaliert werden. Alle skalierten Residuen größer 10 sollten auf mögliche Fehler in den Eingabehöhendaten und Wasserlaufdaten untersucht werden. Große skalierte Residuen deuten auf Konflikte zwischen den Eingabehöhendaten und den Wasserlaufdaten hin. Das Problem kann auch mit schlechten automatischen Drainage-Durchführungen zusammenhängen. Diese Konflikte können behoben werden, indem Sie zusätzliche Wasserlauf- bzw. Punkthöhendaten angeben, nachdem Sie Fehler in den vorhandenen Eingabedaten geprüft und behoben haben. Große nichtskalierte Residuen weisen in der Regel auf Eingabehöhenfehler hin.	Feature Class
Ausgabe-Punkt-Features für Gewässer und Klippenfehler (optional)	Die Ausgabe-Point-Feature-Class von Positionen, an denen Gewässer- und Klippenfehler auftreten können. Die Positionen, an denen die Gewässer geschlossene Schleifen, Verzweigungen und Wasserläufe über Klippen aufweisen, können aus der Point-Feature-Class identifiziert werden. Klippen mit benachbarten Zellen, die mit der hohen und niedrigen Seite der Klippe inkonsistent sind, werden ebenfalls angezeigt. Dies kann ein guter Hinweis auf Klippen mit falscher Richtung sein. Punkte werden wie folgt codiert: 1. Echter Kreislauf in Daten-Wasserlaufnetz. 2. Kreislauf in Wasserlaufnetz, wie im Ausgabe-Raster codiert. 3. Kreislauf in Wasserlaufnetz über verbindende Seen. 4. Verzweigungspunkt. 5. Wasserlauf über Klippe (Wasserfall). 6. Punkte, die mehrere Wasserlaufabflüsse aus Seen anzeigen. 7. Code nicht verwendet. 8. Punkte neben Klippen mit Höhenwerten, die mit der Klippenrichtung inkonsistent sind. 9. Code nicht verwendet. 10. Kreisförmiger Nebenarm entfernt. 11. Nebenarm ohne hereinfließenden Wasserlauf. 12. Gerasterter Nebenarm in Ausgabezelle unterschiedlich zu der Stelle, an der der Daten-Wasserlaufnebenarm auftritt. 13. Fehler beim Verarbeiten von Nebenbedingungen – ein Hinweis auf sehr komplexe Wasserlaufdaten.	Feature Class
Ausgabe-Punkt-Features für Konturlinienfehler (optional)	Die Ausgabe-Punkt-Feature-Class möglicher Fehler, die zu den Eingabe-Konturliniendaten gehören. Konturlinien mit Höhenabweichungen, die die fünffache Standardabweichung der im Ausgabe-Raster dargestellten Konturlinienwerte überschreiten, werden in dieser Feature-Class gemeldet. Konturlinien, die andere Konturlinien mit einer anderen Höhe verbinden, werden in dieser Feature-Class mit dem Code 1 gekennzeichnet. Dies ist ein sicheres Anzeichen für einen Konturlinienbeschriftungsfehler.	Feature Class

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Oberflächen-Raster	Das Ausgabe-Raster für die interpolierte Oberfläche. Es handelt sich stets um ein Gleitkomma-Raster.	Raster

Python

TopoToRasterByFile(in_parameter_file, {out_stream_features}, {out_sink_features}, {out_residual_feature}, {out_stream_cliff_error_feature}, {out_contour_error_feature})

Name	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. Die Polylinien-Features werden wie folgt codiert: 1. Eingabe-Wasserlauf nicht über Klippe. 2. Eingabe-Wasserlauf über Klippe (Wasserfall). 3. Drainage-Durchführung entfernt eine unkorrekte Senke. 4. Aus Kontureckpunkt bestimmter Wasserlauf. 5. Aus Kontureckpunkt bestimmter Bergkamm. 6. Code nicht verwendet. 7. Nebenbedingungen für Wasserlaufdaten. 8. Code nicht verwendet. 9. Linie mit großem Höhendatenabstand.	Feature Class
out_sink_features (optional)	Ausgabe-Feature-Class der verbleibenden Punkt-Features für Senken.	Feature Class
out_residual_feature (optional)	Die Ausgabe-Punkt-Feature-Class aller großen Höhenresiduen, wie sie vom lokalen Diskretisierungsfehler skaliert werden. Alle skalierten Residuen größer 10 sollten auf mögliche Fehler in den Eingabehöhendaten und Wasserlaufdaten untersucht werden. Große skalierte Residuen deuten auf Konflikte zwischen den Eingabehöhendaten und den Wasserlaufdaten hin. Das Problem kann auch mit schlechten automatischen Drainage-Durchführungen zusammenhängen. Diese Konflikte können behoben werden, indem Sie zusätzliche Wasserlauf- bzw. Punkthöhendaten angeben, nachdem Sie Fehler in den vorhandenen Eingabedaten geprüft und behoben haben. Große nichtskalierte Residuen weisen in der Regel auf Eingabehöhenfehler hin.	Feature Class
out_stream_cliff_error_feature (optional)	Die Ausgabe-Point-Feature-Class von Positionen, an denen Gewässer- und Klippenfehler auftreten können. Die Positionen, an denen die Gewässer geschlossene Schleifen, Verzweigungen und Wasserläufe über Klippen aufweisen, können aus der Point-Feature-Class identifiziert werden. Klippen mit benachbarten Zellen, die mit der hohen und niedrigen Seite der Klippe inkonsistent sind, werden ebenfalls angezeigt. Dies kann ein guter Hinweis auf Klippen mit falscher Richtung sein. Punkte werden wie folgt codiert: 1. Echter Kreislauf in Daten-Wasserlaufnetz. 2. Kreislauf in Wasserlaufnetz, wie im Ausgabe-Raster codiert. 3. Kreislauf in Wasserlaufnetz über verbindende Seen. 4. Verzweigungspunkt. 5. Wasserlauf über Klippe (Wasserfall). 6. Punkte, die mehrere Wasserlaufabflüsse aus Seen anzeigen. 7. Code nicht verwendet. 8. Punkte neben Klippen mit Höhenwerten, die mit der Klippenrichtung inkonsistent sind. 9. Code nicht verwendet. 10. Kreisförmiger Nebenarm entfernt. 11. Nebenarm ohne hereinfließenden Wasserlauf. 12. Gerasterter Nebenarm in Ausgabezelle unterschiedlich zu der Stelle, an der der Daten-Wasserlaufnebenarm auftritt. 13. Fehler beim Verarbeiten von Nebenbedingungen – ein Hinweis auf sehr komplexe Wasserlaufdaten.	Feature Class
out_contour_error_feature (optional)	Die Ausgabe-Punkt-Feature-Class möglicher Fehler, die zu den Eingabe-Konturliniendaten gehören. Konturlinien mit Höhenabweichungen, die die fünffache Standardabweichung der im Ausgabe-Raster dargestellten Konturlinienwerte überschreiten, werden in dieser Feature-Class gemeldet. Konturlinien, die andere Konturlinien mit einer anderen Höhe verbinden, werden in dieser Feature-Class mit dem Code 1 gekennzeichnet. Dies ist ein sicheres Anzeichen für einen Konturlinienbeschriftungsfehler.	Feature Class

Rückgabewert

Name	Erläuterung	Datentyp
out_surface_raster	Das Ausgabe-Raster für die interpolierte Oberfläche. Es handelt sich stets um ein Gleitkomma-Raster.	Raster

Codebeispiel

TopoToRasterByFile – Beispiel 1 (Python-Fenster)

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", "#",
                   "C:/sapyexamples/output/out_resids.shp")
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout.tif")

TopoToRasterByFile – Beispiel 2 (eigenständiges Skript)

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"

# Execute TopoToRasterByFile
outTTRByFile = TopoToRasterByFile(inParameterFile)

# Save the output 
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")

Umgebungen

Auto-Commit, Aktueller Workspace, Standard-Ausgabe-Z-Wert, Ausdehnung, Geographische Transformationen, Maske, M-Auflösung, M-Toleranz, Räumlichen Index beibehalten, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Ausgabe hat M-Werte, Ausgabe hat Z-Werte, Ausgabe-M-Domäne, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Scratch-Workspace, Fang-Raster, Kachelgröße, Felddomänen-Beschreibungen übertragen, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz

Sonderfälle

Lizenzinformationen

• Basic: Erfordert Spatial Analyst oder 3D Analyst
• Standard: Erfordert Spatial Analyst oder 3D Analyst
• Advanced: Erfordert Spatial Analyst oder 3D Analyst