Topo zu Raster (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.

Weitere Informationen zur Funktionsweise von "Topo zu Raster"

Verwendung

  • Die besten Ergebnisse werden erzielt, wenn alle Eingabedaten im selben planaren Koordinatensystem gespeichert sind und über dieselben Z-Einheiten verfügen. Nicht projizierte Daten (Längengrad-Breitengrad) können verwendet werden; allerdings sind die Ergebnisse eventuell weniger genau, insbesondere bei hohen Breitengraden.

  • Wenn mehrere Eingabepunkte in einer Ausgabezelle liegen, verwendet Topo zu Raster den durchschnittlichen Wert für die Interpolation (nur die ersten 100 Punkte in einer Zelle werden berücksichtigt, der Rest wird ignoriert). Wenn vom Algorithmus zu viele Punkte gefunden werden, kann die Fehlermeldung angezeigt werden, dass das Punkt-Dataset zu viele Punkte enthält. Die maximale Anzahl von verwendbaren Punkten ist NRows * NCols, wobei NRows die Anzahl der Zeilen im Ausgabe-Raster und NCols die Anzahl der Spalten ist.

  • Wenn als Eingabe-Feature-Datentyp Contour verwendet wird, erzeugt der Algorithmus zuerst eine generalisierte Morphologie der Oberfläche basierend auf der Krümmung der Konturlinien. Anschließend implementiert der Algorithmus die Konturlinien als Quelle für Höheninformationen. Konturlinien sind am besten für Daten im großen Maßstab geeignet, bei denen die Konturlinien und Ecken zuverlässige Indikatoren für Wasserläufe und Bergrücken sind. Bei kleineren Maßstäben ist es möglicherweise genauso effektiv und gleichzeitig preiswerter, die Eckpunkte von Konturlinien zu digitalisieren und diese als Eingabe-Point-Feature-Class zu verwenden.

  • Der Parameter Ausgabe-Zellengröße kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wird die Zellengröße nicht explizit über den Parameterwert angegeben, wird sie aus der Umgebung Zellengröße abgeleitet, falls diese angegeben wurde. Wenn die Zellengröße nicht im Parameter oder in der Umgebung angegeben ist, wohingegen die Umgebung für das Fang-Raster festgelegt ist, wird die Zellengröße des Fang-Rasters verwendet. Wenn nichts angegeben ist, wird die Zellengröße aus der Breite oder Höhe der Ausdehnung (je nachdem was kürzer ist) berechnet, indem der Wert durch 250 dividiert wird. Dabei wird für die Ausdehnung das in der Umgebung angegebene Ausgabekoordinatensystem verwendet.

  • Wenn die Zellengröße mit einem numerischen Wert angegeben ist, wird dieser direkt für das Ausgabe-Raster verwendet.

    Wenn die Zellengröße mit einem Raster-Dataset angegeben ist, wird für den Parameter anstelle des Wertes für die Zellengröße der Pfad des Raster-Datasets angezeigt. Die Zellengröße dieses Raster-Datasets wird direkt in der Analyse verwendet, sofern der Raumbezug des Datasets mit dem des Ausgabe-Raumbezugs übereinstimmt. Wenn der Raumbezug des Datasets nicht mit dem Ausgabe-Raumbezug übereinstimmt, wird er basierend auf dem für Projektionsmethode für Zellengröße angegebenen Wert projiziert.

  • Das Abbilden von aufgefächerten Flussläufen oder das Verwenden von Kreisbögen zum Abbilden von zwei Seiten eines Wasserlaufes liefert ggf. keine zuverlässigen Ergebnisse. Wasserlaufdaten haben stets Priorität vor Punkt- oder Konturliniendaten. Daher werden alle Höhendatenpunkte ignoriert, die nicht dem Gefälle der Gewässer entsprechen. Wasserlaufdaten bieten eine gute Möglichkeit, der Interpolation topographische Informationen hinzuzufügen, wodurch die Qualität des Ausgabe-DEM zusätzlich sichergestellt wird.

  • Bei Datenformaten mit Unterstützung für NULL-Werte wie beispielsweise File-Geodatabase-Feature-Classes werden als Eingabe verwendete NULL-Werte ignoriert.

  • Einige typische Werte für die Einstellungen Toleranz 1 und Toleranz 2 sind beispielsweise:

    • 5,0 und 200,0 für Punktdaten bei einem Maßstab von 1:100.000.
    • 10,0 und 400,0 für weniger dichte Punktdaten bei einem Maßstab von bis zu 1:500.000.
    • 5,0 und 100,0 für Konturliniendaten mit einem Konturlinienabstand von 10.

    Toleranz 2 sollte mindestens sechsmal größer als Toleranz 1 sein.

  • Um das Experimentieren mit den Eingaben und Parametern zu erleichtern, erstellen Sie im Dialogfeld Topo zu Raster eine Ausgabe-Parameterdatei, die in einem Texteditor bearbeitet und als Eingabe für das Werkzeug Topo zu Raster aus Datei verwendet werden kann.

  • Dieses Werkzeug ist eine speicherintensive Anwendung. Daher können keine großen Ausgabe-Raster erstellt werden. Wenn eine große Ausgabe erforderlich ist, verwenden Sie den Parameter Rand, um kleinere Ausgaben zu produzieren. Weitere Informationen hierzu finden Sie im Abschnitt Erstellung und Mosaikdarstellung angrenzender Raster in der Hilfe zur Funktionsweise des Werkzeugs "Topo zu Raster".

  • Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Feature-Daten

Die Eingabe-Features mit den Z-Werten, die in ein Oberflächen-Raster interpoliert werden.

Für jede Feature-Eingabe kann ein Feld angegeben werden, dass die Z-Werte enthält. Zudem kann einer von sechs Typen festgelegt werden.

  • Feature-Layer: Das Eingabe-Feature-Dataset.
  • Feld: Der Name des Feldes, in dem ggf. die Attribute gespeichert werden.
  • Typ: Der Typ des Eingabe-Feature-Datasets.

Es sind neun verschiedene Eingabetypen zulässig:

  • Punkthöhe: Eine Point-Feature-Class für Oberflächenhöhen. Die Höhen der Punkte werden unter "Feld" gespeichert.
  • Konturlinie: Eine Line-Feature-Class für Höhenkonturlinien. Die Höhen der Konturlinien werden unter "Feld" gespeichert.
  • Wasserlauf: Eine Line-Feature-Class für die Wasserlaufpositionen. Alle Kreisbögen müssen stromabwärts zeigen. Die Feature-Class darf nur einzelne Kreisbogen-Wasserläufe enthalten. Für diesen Eingabetyp ist keine Feldoption vorhanden.
  • Senke: Eine Point-Feature-Class für bekannte topographische Senken. Das Werkzeug versucht nicht, Punkte aus der Analyse zu entfernen, die explizit als Senken identifiziert wurden. Das verwendete Feld muss das Feld sein, in dem die Höhe der identifizierten Senke gespeichert wird. Bei Wahl von "NONE" wird nur die Position der Senke verwendet.
  • Grenze: Eine Feature-Class mit einem einzelnen Polygon, das die äußere Grenze des Ausgabe-Rasters repräsentiert. Zellen im Ausgabe-Raster außerhalb dieser Grenze erhalten den Wert "NoData". Diese Option kann zum Ausschneiden von Wasserflächen entlang von Küstenlinien verwendet werden, bevor das endgültige Ausgabe-Raster erstellt wird. Für diesen Eingabetyp ist keine Feldoption vorhanden.
  • See: Eine Polygon-Feature-Class, die die Position von Seen angibt. Allen Ausgabe-Raster-Zellen innerhalb eines Sees wird der minimale Höhenwert aller Zellen entlang der Uferlinie zugewiesen. Für diesen Eingabetyp ist keine Feldoption vorhanden.
  • Klippe: Eine Linien-Feature-Class der Klippen. Die Klippen-Linien-Features müssen so ausgerichtet sein, dass die linke Seite der Linie auf der niedrigen Seite der Klippe und die rechte Seite der Linie auf der hohen Seite der Klippe liegt. Für diesen Eingabetyp ist keine Feldoption vorhanden.
  • Ausschluss: Eine Polygon-Feature-Class der Bereiche, in denen die Eingabedaten ignoriert werden sollen. Anhand dieser Polygone können Höhendaten aus dem Interpolationsprozess entfernt werden. Dieser Vorgang dient in der Regel zum Entfernen von Höhendaten, die Dammwällen und Brücken zugeordnet sind. Dadurch wird die Interpolation des darunterliegenden Tals mit verbundener Drainagestruktur ermöglicht. Für diesen Eingabetyp ist keine Feldoption vorhanden.
  • Küste: Eine Polygon-Feature-Class, die den Umriss eines Küstengebiets enthält. Zellen im endgültigen Ausgabe-Raster, die außerhalb dieser Polygone liegen, werden auf einen Wert festgelegt, der unter der benutzerdefinierten Mindesthöhengrenze liegt. Für diesen Eingabetyp ist keine Feldoption vorhanden.
TopoInput
Ausgabe-Zellengröße
(optional)

Die Zellengröße des zu erstellenden Ausgabe-Rasters.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.

Analysis Cell Size
Ausgabeausdehnung
(optional)

Ausdehnung für das Ausgabe-Raster-Dataset.

Die Interpolation des Ausgabe-Rasters erstreckt sich bis zu den XY-Grenzen. Zellen außerhalb dieser Ausdehnung sind "NoData". Für optimale Interpolationsergebnisse entlang der Ränder des Ausgabe-Rasters müssen die XY-Grenzwerte um mindestens 10 Zellen auf jeder Seite kleiner sein als die Ausdehnung der Eingabedaten.

Die Standardausdehnung ist die größte aller Ausdehnungen der Eingabe-Feature-Daten.

  • Aktuelle Anzeigeausdehnung Kartenansicht: Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist.
  • Ausdehnung eines Layers:Layer Die Ausdehnung basiert auf einem aktiven Karten-Layer. Verwenden Sie die Dropdown-Liste, um einen verfügbaren Layer auszuwählen, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern, um die kombinierte Ausdehnung aller aktiven Karten-Layer mit Ausnahme der Grundkarte zu erhalten. Diese Option ist nur verfügbar, wenn eine aktive Karte mit Layern vorhanden ist.
  • Durchsuchen:Durchsuchen Die Ausdehnung basiert auf einem vorhandenen Dataset.
  • Ausdehnung zurücksetzen Zurücksetzen: Die Ausdehnung wird auf den Standardwert zurückgesetzt.
  • Manuell eingegebene Koordinaten: Die Koordinaten müssen numerische Werte sein und im Koordinatensystem der aktiven Karte liegen.

    Die Karte verwendet möglicherweise unterschiedliche Anzeigeeinheiten.

Extent
Rand (in Zellen)
(optional)

Entfernung in Zellen für die Interpolation über die angegebene Ausgabeausdehnung und -grenze hinaus.

Der Wert muss größer oder gleich 0 (null) sein. Der Standardwert ist 20.

Wenn die Feature-Datasets Ausgabeausdehnung und Grenze der Grenze der Eingabedaten entsprechen (Standardeinstellung), stimmen Werte, die entlang des Randes des DEM interpoliert werden, nicht gut mit angrenzenden DEM-Daten überein. Der Grund hierfür ist, dass sie mit der Hälfte der Daten interpoliert wurden wie die Punkte innerhalb des Rasters, die an allen Seiten von Eingabedaten umgeben sind. Die Option Rand (in Zellen) ermöglicht, dass Daten außerhalb dieser Grenzen für die Interpolation verwendet werden können.

Long
Kleinster Z-Wert in der Interpolation
(optional)

Der minimale, für die Interpolation verwendete Z-Wert.

Der Standardwert ist 20 % niedriger als der kleinste aller Eingabewerte.

Double
Größter Z-Wert in der Interpolation
(optional)

Der maximale, für die Interpolation verwendete Z-Wert.

Der Standardwert ist 20 % größer als der größte aller Eingabewerte.

Double
Drainage-Durchführung
(optional)

Der Typ der umzusetzenden Drainage-Durchführung.

Die Drainage-Durchführung kann so festgelegt werden, dass versucht wird, alle Senken bzw. Mulden zu entfernen, damit ein hydrologisch korrektes DEM erstellt werden kann. Wenn Senkenpunkte in den Eingabe-Feature-Daten explizit identifiziert wurden, werden diese Senken nicht aufgefüllt.

  • DrainagedurchführungDer Algorithmus versucht, alle angetroffenen ("realen" oder "unkorrekten") Senken zu entfernen. Dies ist die Standardeinstellung.
  • Nicht erzwingenSenken werden nicht aufgefüllt.
  • Mit Senke erzwingenPunkte, die in Eingabe-Feature-Daten als Senken identifiziert wurden, repräsentieren bekannte topographische Vertiefungen, die nicht geändert werden. Senken, die in Eingabe-Feature-Daten nicht identifiziert wurden, werden als "unkorrekt" betrachtet und, wenn möglich, aufgefüllt.Bei mehr als 8.000 unkorrekten Senken wird beim Ausführen des Werkzeugs ein Fehler verursacht.
String
Haupttyp der Eingabedaten
(optional)

Der vorherrschende Höhendatentyp in den Eingabe-Feature-Daten.

Das Angeben der relevanten Option optimiert die Suchmethode, die während der Erstellung von Wasserläufen und Bergrücken verwendet wird.

  • KonturlinieDer vorherrschende Eingabedatentyp sind Höhenkonturlinien. Dies ist die Standardeinstellung.
  • SpotDer vorherrschende Eingabedatentyp sind Punkte.
String
Maximale Anzahl an Iterationen
(optional)

Die maximale Anzahl von Interpolationsiterationen.

Die Anzahl an Iterationen muss größer 0 sein. Der Standardwert 20 ist normalerweise für Konturlinien- und Liniendaten ausreichend.

Bei Wahl des Wertes 30 werden weniger Senken entfernt. Gelegentlich können höhere Werte (45 bis 50) nützlich sein, um mehr Senken zu entfernen oder mehr Bergrücken und Wasserläufe zu bestimmen. Die Iteration endet für jede Raster-Auflösung, wenn die maximale Anzahl an Iterationen erreicht wurde.

Long
Rauigkeitsbeiwert
(optional)

Die integrierte quadrierte zweite Ableitung als Maß der Rauigkeit.

Der Rauigkeitsbeiwert muss größer gleich 0 sein. Wenn für den primären Eingabedatentyp Konturlinie angegeben wurde, wird der Standardwert 0 verwendet. Wenn für den primären Datentyp Spot angegeben wurde, wird der Standardwert 0,5 verwendet. Höhere Werte werden in der Regel nicht empfohlen.

Double
Diskretisierungs-Fehlerfaktor
(optional)

Dieser Faktor dient dem Anpassen des Glättungsumfangs, wenn die Eingabedaten in ein Raster konvertiert werden.

Der Wert muss größer 0 sein. Der normale Anpassungsbereich liegt zwischen 0,25 und 4. Der Standardwert ist 1. Bei einem kleineren Wert ist die Datenglättung geringer, bei höheren Werten ist sie größer.

Double
Vertikaler Standardfehler
(optional)

Die Menge an Zufallsfehlern in den Z-Werten der Eingabedaten.

Der Wert muss größer gleich 0 sein. Die Standardeinstellung ist 0.

Der vertikale Standardfehler kann auf einen kleinen positiven Wert festgelegt werden, wenn die Daten signifikante (nicht systematische) vertikale Zufallsfehler mit einheitlicher Varianz aufweisen. Legen Sie in diesem Fall den vertikalen Standardfehler auf die Standardabweichung dieser Fehler fest. Bei den meisten Höhen-Datasets wird für diesen Parameter der Wert 0 verwendet. Sie können jedoch auch einen kleinen positiven Wert angeben, um beim Rastern von Punktdaten mit Wasserlaufdaten die Konvergenz zu stabilisieren.

Double
Toleranz 1
(optional)

Diese Toleranz gibt die Genauigkeit und Dichte der Höhenpunkte in Bezug zur Oberflächendrainage an.

Legen Sie für Punkt-Datasets die Toleranz auf den Standardfehler der Höhendaten fest. Wählen Sie für Konturlinien-Datasets die Hälfte des durchschnittlichen Konturlinienintervalls.

Der Wert muss größer gleich 0 sein. Beim Datentyp Konturlinie ist der Standardwert 2,5, beim Datentyp Spot ist der Standardwert 0.

Double
Toleranz 2
(optional)

Diese Toleranz verhindert die Drainage-Durchführung aufgrund unrealistisch hoher Barrieren.

Der Wert muss größer 0 sein. Beim Datentyp Konturlinie ist der Standardwert 100, beim Datentyp Spot ist der Standardwert 200.

Double
Ausgabe-Polylinien-Features der Gewässer
(optional)

Die Ausgabe-Line-Feature-Class der Wasserlauf-Polylinien-Features und Bergrücken-Linien-Features.

Die Linien-Features werden zu Beginn des Interpolationsprozesses erstellt. Diese Feature-Class stellt die allgemeine Morphologie der Oberfläche für die Interpolation bereit. Durch Vergleiche mit bekannten Wasserlauf- und Bergrückendaten kann der Benutzer mit ihrer Hilfe prüfen, ob Drainage und Morphologie korrekt sind.

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)

Die Ausgabe-Point-Feature-Class der verbleibenden Punkt-Features für Senken.

Dies sind die Senken, die nicht in den Eingabe-Feature-Daten der Senke angegeben und die nicht während der Drainage-Durchführung entfernt wurden. Durch Anpassen der Werte für Toleranz 1 und Toleranz 2 kann die Anzahl der verbleibenden Senken reduziert werden. Verbleibende Senken sind häufig ein Hinweis auf Fehler in den Eingabedaten, die der Drainage-Durchführungsalgorithmus nicht beheben konnte. Dies ist ggf. eine effiziente Möglichkeit zum Entdecken feiner Höhenfehler.

Feature Class
Ausgabe-Diagnosedatei
(optional)

Die Ausgabe-Diagnosedatei mit allen verwendeten Eingaben und Parametern sowie der Anzahl der Senken, die bei jeder Auflösung und Iteration entfernt wurden.

File
Ausgabeparameterdatei
(optional)

Die Ausgabe-Parameterdatei mit allen verwendeten Eingaben und Parametern, die zusammen mit Topo zu Raster aus Datei für eine weitere Interpolation verwendet werden kann.

File
Rauigkeitsbeiwert für Profilkrümmung
(optional)

Der Rauigkeitsbeiwert der Vertikalkrümmung ist ein lokaler adaptiver Beiwert, der zum teilweisen Ersetzen der Gesamtkrümmung verwendet werden kann.

Er kann bei Konturliniendaten in hoher Qualität gute Ergebnisse erbringen, bei schlechten Daten aber zu Instabilität bei der Konvergenz führen. Legen Sie den Wert auf 0,0 für keine Vertikalkrümmung (Standardwert), auf 0,5 für mäßige Vertikalkrümmung und auf 0,8 für maximale Vertikalkrümmung fest. Von der Verwendung von Werten über 0,8 wird abgeraten.

Double
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

BeschriftungErläuterungDatentyp
Ausgabe-Oberflächen-Raster

Das Ausgabe-Raster für die interpolierte Oberfläche.

Es handelt sich stets um ein Gleitkomma-Raster.

Raster

TopoToRaster(in_topo_features, {cell_size}, {extent}, {Margin}, {minimum_z_value}, {maximum_z_value}, {enforce}, {data_type}, {maximum_iterations}, {roughness_penalty}, {discrete_error_factor}, {vertical_standard_error}, {tolerance_1}, {tolerance_2}, {out_stream_features}, {out_sink_features}, {out_diagnostic_file}, {out_parameter_file}, {profile_penalty}, {out_residual_feature}, {out_stream_cliff_error_feature}, {out_contour_error_feature})
NameErläuterungDatentyp
in_topo_features
topo_input

Die Topo-Klasse gibt die Eingabe-Features mit den Z-Werten an, die in ein Oberflächen-Raster interpoliert werden.

Neun verschiedene Datentypen sind als Eingabe für die Topo-Klasse zulässig: TopoPointElevation, TopoContour, TopoStream, TopoSink, TopoBoundary, TopoLake, TopoCliff, TopoExclusion und TopoCoast.

  • TopoPointElevation ([[inFeatures,{field}],...])

    Eine Point-Feature-Class für Oberflächenhöhen.

    Die Höhen der Punkte werden in field gespeichert.

  • TopoContour ([[inFeatures,{field}],...])

    Eine Line-Feature-Class für Höhenkonturlinien.

    Die Höhen der Konturlinien werden in field gespeichert.

  • TopoStream ([inFeatures,...])

    Eine Line-Feature-Class für die Wasserlaufpositionen. Alle Kreisbögen müssen stromabwärts zeigen. Die Feature-Class darf nur einzelne Kreisbogen-Wasserläufe enthalten.

  • TopoSink ([[inFeatures,{field}],...])

    Eine Point-Feature-Class für bekannte topographische Senken. Bei Topo zu Raster wird nicht versucht, Punkte aus der Analyse zu entfernen, die explizit als Senken identifiziert wurden.

    Der verwendete field-Wert muss das Feld sein, in dem die Höhe der identifizierten Senke gespeichert wird. Bei Wahl von "NONE" wird nur die Position der Senke verwendet.

  • TopoBoundary ([inFeatures,...])

    Eine Boundary-Feature-Class mit einem einzelnen Polygon, das die äußere Grenze des Ausgabe-Rasters repräsentiert. Zellen im Ausgabe-Raster außerhalb dieser Grenze erhalten den Wert "NoData". Diese Option kann zum Ausschneiden von Wasserflächen entlang von Küstenlinien verwendet werden, bevor das endgültige Ausgabe-Raster erstellt wird.

  • TopoLake ([inFeatures,...])

    Eine Polygon-Feature-Class, die die Position von Seen angibt. Allen Ausgabe-Raster-Zellen innerhalb eines Sees wird der minimale Höhenwert aller Zellen entlang der Uferlinie zugewiesen.

  • TopoCliff ([inFeatures,...])

    Eine Line-Feature-Class der Klippen. Die Klippen-Linien-Features müssen so ausgerichtet sein, dass die linke Seite der Linie auf der niedrigen Seite der Klippe und die rechte Seite der Linie auf der hohen Seite der Klippe liegt.

  • TopoExclusion ([inFeatures,...])

    Eine Polygon-Feature-Class der Bereiche, in denen die Eingabedaten ignoriert werden sollen. Anhand dieser Polygone können Höhendaten aus dem Interpolationsprozess entfernt werden. Dieser Vorgang dient in der Regel zum Entfernen von Höhendaten, die Dammwällen und Brücken zugeordnet sind. Dadurch wird die Interpolation des darunterliegenden Tals mit verbundener Drainagestruktur ermöglicht.

  • TopoCoast ([inFeatures,...])

    Eine Polygon-Feature-Class, die den Umriss eines Küstengebiets enthält. Zellen im endgültigen Ausgabe-Raster, die außerhalb dieser Polygone liegen, werden auf einen Wert festgelegt, der unter der benutzerdefinierten Mindesthöhengrenze liegt.

Für die Feature-Eingabe-Typen PointElevation, Contour und Sink kann ein Feld angegeben werden, das die Z-Werte enthält. Für die Eingabetypen Boundary, Lake, Cliff, Coast, Exclusion oder Stream ist keine Feldoption vorhanden.

TopoInput
cell_size
(optional)

Die Zellengröße des zu erstellenden Ausgabe-Rasters.

Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit über den Parameterwert angegeben wurde, wird der Wert für die Zellengröße aus der Umgebung verwendet, sofern diese angegeben wurde. Andernfalls wird die Zellengröße mithilfe zusätzlicher Regeln aus den anderen Eingaben berechnet. Weitere Details finden Sie im Abschnitt mit den Verwendungshinweisen.

Analysis Cell Size
extent
(optional)

Ausdehnung für das Ausgabe-Raster-Dataset.

Die Interpolation des Ausgabe-Rasters erstreckt sich bis zu den XY-Grenzen. Zellen außerhalb dieser Ausdehnung sind "NoData". Für optimale Interpolationsergebnisse entlang der Ränder des Ausgabe-Rasters müssen die XY-Grenzwerte um mindestens 10 Zellen auf jeder Seite kleiner sein als die Ausdehnung der Eingabedaten.

Die Standardausdehnung ist die größte aller Ausdehnungen der Eingabe-Feature-Daten.

  • MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet.
  • MINOF: Die minimale gemeinsame Fläche aller Eingaben wird verwendet.
  • DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige.
  • Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet.
  • Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet.
  • Eine durch Leerzeichen getrennte Zeichenfolge von Koordinaten: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Koordinaten werden im Format X-Min, Y-Min, X-Max, Y-Max angegeben.
Extent
Margin
margin
(optional)

Entfernung in Zellen für die Interpolation über die angegebene Ausgabeausdehnung und -grenze hinaus.

Der Wert muss größer oder gleich 0 (null) sein. Der Standardwert ist 20.

Wenn die Feature-Datasets Extent und TopoBoundary der Grenze der Eingabedaten entsprechen (Standardeinstellung), stimmen Werte, die entlang des Randes des DEM interpoliert werden, nicht gut mit angrenzenden DEM-Daten überein. Der Grund hierfür ist, dass sie mit der Hälfte der Daten interpoliert wurden wie die Punkte innerhalb des Rasters, die an allen Seiten von Eingabedaten umgeben sind. Die Option Margin ermöglicht, dass Daten außerhalb dieser Grenzen für die Interpolation verwendet werden können.

Long
minimum_z_value
(optional)

Der minimale, für die Interpolation verwendete Z-Wert.

Der Standardwert ist 20 % niedriger als der kleinste aller Eingabewerte.

Double
maximum_z_value
(optional)

Der maximale, für die Interpolation verwendete Z-Wert.

Der Standardwert ist 20 % größer als der größte aller Eingabewerte.

Double
enforce
(optional)

Der Typ der umzusetzenden Drainage-Durchführung.

Die Drainage-Durchführung kann so festgelegt werden, dass versucht wird, alle Senken bzw. Mulden zu entfernen, damit ein hydrologisch korrektes DEM erstellt werden kann. Wenn Senkenpunkte in den Eingabe-Feature-Daten explizit identifiziert wurden, werden diese Senken nicht aufgefüllt.

  • ENFORCEDer Algorithmus versucht, alle angetroffenen ("realen" oder "unkorrekten") Senken zu entfernen. Dies ist die Standardeinstellung.
  • NO_ENFORCESenken werden nicht aufgefüllt.
  • ENFORCE_WITH_SINKPunkte, die in Eingabe-Feature-Daten als Senken identifiziert wurden, repräsentieren bekannte topographische Vertiefungen, die nicht geändert werden. Senken, die in Eingabe-Feature-Daten nicht identifiziert wurden, werden als "unkorrekt" betrachtet und, wenn möglich, aufgefüllt.Bei mehr als 8.000 unkorrekten Senken wird beim Ausführen des Werkzeugs ein Fehler verursacht.
String
data_type
(optional)

Der vorherrschende Höhendatentyp in den Eingabe-Feature-Daten.

  • CONTOURDer vorherrschende Eingabedatentyp sind Höhenkonturlinien. Dies ist die Standardeinstellung.
  • SPOTDer vorherrschende Eingabedatentyp sind Punkte.

Das Angeben der relevanten Option optimiert die Suchmethode, die während der Erstellung von Wasserläufen und Bergrücken verwendet wird.

String
maximum_iterations
(optional)

Die maximale Anzahl von Interpolationsiterationen.

Die Anzahl an Iterationen muss größer 0 sein. Der Standardwert 20 ist normalerweise für Konturlinien- und Liniendaten ausreichend.

Bei Wahl des Wertes 30 werden weniger Senken entfernt. Gelegentlich können höhere Werte (45 bis 50) nützlich sein, um mehr Senken zu entfernen oder mehr Bergrücken und Wasserläufe zu bestimmen. Die Iteration endet für jede Raster-Auflösung, wenn die maximale Anzahl an Iterationen erreicht wurde.

Long
roughness_penalty
(optional)

Die integrierte quadrierte zweite Ableitung als Maß der Rauigkeit.

Der Rauigkeitsbeiwert muss größer gleich 0 sein. Wenn für den primären Eingabedatentyp CONTOUR angegeben wurde, wird der Standardwert 0 verwendet. Wenn für den primären Datentyp SPOT angegeben wurde, wird der Standardwert 0,5 verwendet. Höhere Werte werden in der Regel nicht empfohlen.

Double
discrete_error_factor
(optional)

Dieser Faktor dient dem Anpassen des Glättungsumfangs, wenn die Eingabedaten in ein Raster konvertiert werden.

Der Wert muss größer 0 sein. Der normale Anpassungsbereich liegt zwischen 0,25 und 4. Der Standardwert ist 1. Bei einem kleineren Wert ist die Datenglättung geringer, bei höheren Werten ist sie größer.

Double
vertical_standard_error
(optional)

Die Menge an Zufallsfehlern in den Z-Werten der Eingabedaten.

Der Wert muss größer gleich 0 sein. Die Standardeinstellung ist 0.

Der vertikale Standardfehler kann auf einen kleinen positiven Wert festgelegt werden, wenn die Daten signifikante (nicht systematische) vertikale Zufallsfehler mit einheitlicher Varianz aufweisen. Legen Sie in diesem Fall den vertikalen Standardfehler auf die Standardabweichung dieser Fehler fest. Bei den meisten Höhen-Datasets wird für diesen Parameter der Wert 0 verwendet. Sie können jedoch auch einen kleinen positiven Wert angeben, um beim Rastern von Punktdaten mit Wasserlaufdaten die Konvergenz zu stabilisieren.

Double
tolerance_1
(optional)

Diese Toleranz gibt die Genauigkeit und Dichte der Höhenpunkte in Bezug zur Oberflächendrainage an.

Legen Sie für Punkt-Datasets die Toleranz auf den Standardfehler der Höhendaten fest. Wählen Sie für Konturlinien-Datasets die Hälfte des durchschnittlichen Konturlinienintervalls.

Der Wert muss größer gleich 0 sein. Beim Datentyp CONTOUR ist der Standardwert 2,5, beim Datentyp SPOT ist der Standardwert 0.

Double
tolerance_2
(optional)

Diese Toleranz verhindert die Drainage-Durchführung aufgrund unrealistisch hoher Barrieren.

Der Wert muss größer 0 sein. Beim Datentyp CONTOUR ist der Standardwert 100, beim Datentyp SPOT ist der Standardwert 200.

Double
out_stream_features
(optional)

Die Ausgabe-Line-Feature-Class der Wasserlauf-Polylinien-Features und Bergrücken-Linien-Features.

Die Linien-Features werden zu Beginn des Interpolationsprozesses erstellt. Diese Feature-Class stellt die allgemeine Morphologie der Oberfläche für die Interpolation bereit. Durch Vergleiche mit bekannten Wasserlauf- und Bergrückendaten kann der Benutzer mit ihrer Hilfe prüfen, ob Drainage und Morphologie korrekt sind.

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)

Die Ausgabe-Point-Feature-Class der verbleibenden Punkt-Features für Senken.

Dies sind die Senken, die nicht in den Eingabe-Feature-Daten der Senke angegeben und die nicht während der Drainage-Durchführung entfernt wurden. Durch Anpassen der Werte für tolerance_1 und tolerance_2 kann die Anzahl der verbleibenden Senken reduziert werden. Verbleibende Senken sind häufig ein Hinweis auf Fehler in den Eingabedaten, die der Drainage-Durchführungsalgorithmus nicht beheben konnte. Dies ist ggf. eine effiziente Möglichkeit zum Entdecken feiner Höhenfehler.

Feature Class
out_diagnostic_file
(optional)

Die Ausgabe-Diagnosedatei mit allen verwendeten Eingaben und Parametern sowie der Anzahl der Senken, die bei jeder Auflösung und Iteration entfernt wurden.

File
out_parameter_file
(optional)

Die Ausgabe-Parameterdatei mit allen verwendeten Eingaben und Parametern, die zusammen mit Topo zu Raster aus Datei für eine weitere Interpolation verwendet werden kann.

File
profile_penalty
(optional)

Der Rauigkeitsbeiwert der Vertikalkrümmung ist ein lokaler adaptiver Beiwert, der zum teilweisen Ersetzen der Gesamtkrümmung verwendet werden kann.

Er kann bei Konturliniendaten in hoher Qualität gute Ergebnisse erbringen, bei schlechten Daten aber zu Instabilität bei der Konvergenz führen. Legen Sie den Wert auf 0,0 für keine Vertikalkrümmung (Standardwert), auf 0,5 für mäßige Vertikalkrümmung und auf 0,8 für maximale Vertikalkrümmung fest. Von der Verwendung von Werten über 0,8 wird abgeraten.

Double
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

NameErläuterungDatentyp
out_surface_raster

Das Ausgabe-Raster für die interpolierte Oberfläche.

Es handelt sich stets um ein Gleitkomma-Raster.

Raster

Codebeispiel

TopoToRaster: Beispiel 1 (Python-Fenster)

In diesem Beispiel wird ein hydrologisch korrektes TIFF-Oberflächen-Raster anhand von Punkt-, Linien- und Polygondaten erstellt.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTTR = TopoToRaster([TopoPointElevation([['spots', 'spot_meter']]), 
                       TopoContour([['contours', 'spot_meter']]),
                       TopoCliff(['cliff'])], 60, 
                       "#", "#", "#", "#", "NO_ENFORCE")
outTTR.save("C:/sapyexamples/output/ttrout.tif")
TopoToRaster: Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird ein hydrologisch korrektes Grid-Oberflächen-Raster anhand von Punkt-, Linien- und Polygondaten erstellt.

# Name: TopoToRaster_Ex_02.py
# Description: Interpolates a hydrologically correct surface 
#    from point, line, and polygon data.
# 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
inPointElevations = TopoPointElevation([['spots.shp', 'spot_meter'], 
                                        ['spots2.shp', 'elev']])
inBoundary = TopoBoundary(['boundary.shp'])
inContours = TopoContour([['contours.shp', 'spot_meter']])
inLake = TopoLake(['lakes.shp'])
inSinks = TopoSink([['sink1.shp', 'elevation'], ['sink2.shp', 'none']])
inStream = TopoStream(['streams.shp'])

inFeatures = ([inPointElevations, inContours, inLake, inBoundary, inSinks])

# Execute TopoToRaster
outTTR = TopoToRaster(inFeatures)

# Save the output 
outTTR.save("C:/sapyexamples/output/ttrout03")

Lizenzinformationen

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

Verwandte Themen