Geodätisches Sichtfeld (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der 3D Analyst-Lizenz verfügbar.

Zusammenfassung

Bestimmt anhand geodätischer Methoden die Raster-Oberflächenpositionen, die für eine Reihe von Beobachter-Features sichtbar sind.

Weitere Informationen zur Funktionsweise von "Geodätisches Sichtfeld"

Abbildung

Abbildung: Geodätisches Sichtfeld mit der Option "Häufigkeit"
Ausgabe von "Geodätisches Sichtfeld" mit der Option "Häufigkeit" auf einer Höhenoberfläche mit Schummerung
Abbildung: Geodätisches Sichtfeld mit der Option "Beobachter"
Ausgabe von "Geodätisches Sichtfeld" mit der Option "Beobachter" auf einer Höhenoberfläche mit Schummerung

Verwendung

  • Mit diesem Werkzeug werden zwei Sichtbarkeitsanalysetypen durchgeführt, "Häufigkeit" und "Beobachter". Diese können mit dem Parameter Analysetyp festgelegt werden.

  • Um die Genauigkeit der Ausgabe sicherzustellen, weisen Sie dem Eingabe-Raster ein vertikales Koordinatensystem zu, wenn es noch über keines verfügt.

  • Für dieses Werkzeug ist kein Parameter "Z-Faktor" erforderlich. Der Z-Faktor wird intern anhand der vertikalen Einheit (Z) und den Karteneinheiten (XY) aus dem Raumbezug des Eingabe-Rasters berechnet.

  • Bei Eingabe-Rastern, in denen Rauschen auftritt (am häufigsten in Daten mit hoher Auflösung), kann es zu unerwarteten Ergebnissen kommen. Vor der Ausführung dieses Werkzeugs können Sie entweder die Daten in einem Vorverarbeitungsschritt korrigieren oder den Effekt des Fehlers verringern, indem Sie zuerst das Werkzeug Focal Statistics oder Filtern ausführen und danach den Vorgang "Sichtfeld" auswählen.

  • Wenn das Eingabe-Raster neu berechnet werden muss, wird die bilineare Technik verwendet. Ein Eingabe-Raster muss beispielsweise dann neu berechnet werden, wenn das Ausgabe-Koordinatensystem, die Ausdehnung oder die Zellengröße sich von dem entsprechenden Wert der Eingabe unterscheidet.

  • Zur Verbesserung der Performance können Sie für den Parameter Äußerer Radius explizit einen Wert festlegen, mit dem die maximale Betrachtungsentfernung dargestellt wird, die für die Analyse von Interesse ist.

  • Standardmäßig verwendet der Parameter Analysemethode die Option Alle Sichtlinien, mit der die genaueste Ausgabe erzeugt wird. Verwenden Sie zur Steigerung der Performance in puncto Verarbeitungszeit die Option Sichtlinien aus Umfang.

  • Die Beobachterparameter im Zusammenhang mit der Höhe, z. B. Oberflächenversatz, Beobachterhöhe und Beobachterversatz, können als lineare Einheit oder als Feld angegeben werden. Während der Berechnung wird der Wert der linearen Einheit intern in die Z-Einheit des Eingabe-Rasters konvertiert. Wenn die lineare Einheit jedoch unbekannt ist oder ein numerisches Feld angegeben wurde, wird davon ausgegangen, dass der Wert sich in der Z-Einheit des Eingabe-Rasters befindet.

  • Die Beobachterparameter im Zusammenhang mit der Betrachtungsentfernung, z. B. Innerer Radius und Äußerer Radius, können als lineare Einheit oder als Feld angegeben werden. Während der Berechnung wird der Wert der linearen Einheit intern in die XY-Einheiten des Eingabe-Rasters konvertiert. Wenn die lineare Einheit jedoch unbekannt ist oder ein numerisches Feld angegeben wurde, wird davon ausgegangen, dass der Wert sich in der XY-Einheit des Eingabe-Rasters befindet.

  • Für einen Beobachterparameter angegebene Felder, z. B. Oberflächenversatz oder Beobachterversatz, können Zeichenfolgenfelder mit einem numerischen Wert und einer numerischen Einheit sein. Beispiel: Wenn für Versatz der Beobachterposition das Feld obs_height angegeben ist, kann es Werte wie "6 Meter" enthalten.

    Bei der Skripterstellung können die Beobachterparameter wie observer_offset in verschiedenen Formen von Zeichenfolgen angegeben werden. In jeder Form werden ein Wert und eine lineare Einheit aus der Zeichenfolge gelesen. In der folgenden Tabelle werden einige Beispieleingabezeichenfolgen aufgeführt, und es wird angegeben, wie die jeweilige lineare Einheit ermittelt wird. Bei anderen Parametern können Sie demselben Muster folgen.

    Beispiel einer Eingabezeichenfolge für den BeobachterversatzVerwendete lineare Einheit

    ' ' oder '#'

    Standardwert und -einheit werden verwendet, in diesem Fall 1 Meter.

    '6'

    Der Beobachterversatz ist 6, und da keine Einheit angegeben ist, wird die Standardeinheit Meter verwendet.

    '6 Feet'

    Der Versatz der Beobachterposition ist 6 Fuß.

    '6 Unknown'

    Der Beobachterversatz ist 6, und da keine Einheit angegeben ist, wird die Standardeinheit Meter verwendet.

    Beispiele für Eingabezeichenfolgen und lineare Einheiten
  • Dieses Werkzeug lässt sich mit GPU beschleunigen, d. h. wenn ein kompatibler Grafikprozessor (GPU) in Ihrem System verfügbar ist, lässt sich damit die Leistung des Werkzeugs verbessern. Verwenden Sie den Parameter Zielgerät für Analyse (analysis_target_device in Python), um zu steuern, ob das Werkzeug mit der GPU oder der CPU ausgeführt wird.

    Weitere Details zu kompatiblen GPUs, zum Konfigurieren von und Arbeiten mit GPU-Geräten sowie Tipps zur Problembehandlung finden Sie unter GPU-Verarbeitung mit Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Eingabe-Oberflächen-Raster. Das Raster kann ein ganzzahliges oder ein Gleitkomma-Raster sein.

Das Eingabe-Raster wird im Zuge der Sichtbarkeitsberechnung in ein geozentrisches 3D-Koordinatensystem umgewandelt. Die Bestimmung der Sichtbarkeit wird durch NoData-Zellen im Eingabe-Raster nicht versperrt.

Raster Layer
Eingabe-Punkt- oder Polylinien-Features für Beobachter

Die Eingabe-Feature-Class, die die Beobachterpositionen identifiziert. Dabei kann es sich um Punkt-, Multipoint- oder Polylinien-Features handeln.

Im Zuge der Sichtbarkeitsberechnung wird die Eingabe-Feature-Class in ein geozentrisches 3D-Koordinatensystem umgewandelt. Beobachter, die sich außerhalb der Ausdehnung des Oberflächen-Rasters oder auf NoData-Zellen befinden, werden bei der Berechnung ignoriert.

Feature Layer
Ausgabe-Raster der Ebene über Bodenoberfläche
(optional)

Das Ausgabe-Raster der Ebene über Bodenoberfläche (AGL).

Das AGL-Ergebnis ist ein Raster, bei dem jeder Zellenwert der Mindesthöhe entspricht, die einer ansonsten nicht sichtbaren Zelle hinzugefügt werden muss, um sie zumindest durch einen Beobachter sichtbar zu machen. Zellen, die bereits sichtbar waren, wird in diesem Ausgabe-Raster der Wert 0 zugewiesen.

Wenn der Parameter für den vertikalen Fehler 0 beträgt, ist das AGL-Ausgabe-Raster ein Einband-Raster. Wenn der vertikale Fehler größer als 0 ist, wird das AGL-Ausgabe-Raster unter Berücksichtigung der Zufallseffekte aus dem Eingabe-Raster als Dreiband-Raster erstellt. Das erste Band stellt die mittleren, das zweite Band die minimalen und das dritte Band die maximalen AGL-Werte dar.

Raster Dataset
Analysetyp
(optional)

Gibt an, welcher Typ von Sichtbarkeitsanalyse durchgeführt werden soll, indem Sie festlegen, wie sichtbar jede Zelle für die Beobachter ist, oder indem Sie für jede Oberflächenposition ermitteln, welche Beobachter sichtbar sind.

  • HäufigkeitDie Ausgabe erfasst die Häufigkeit, mit der jede Zellenposition im Eingabe-Oberflächen-Raster für die Eingabe-Beobachterpositionen (z. B. Punkte oder Stützpunkte für Polylinien-Beobachter-Features) sichtbar ist. Dies ist die Standardeinstellung.
  • BeobachterDie Ausgabe bestimmt die exakten Beobachterpunkte, die von jeder Position auf der Raster-Oberfläche sichtbar sind. Die für diesen Analysetyp maximal zulässige Anzahl der Eingabe-Beobachter beträgt 32.
String
Vertikaler Fehler
(optional)

Der Unsicherheitsfaktor (Root-Mean-Square Error oder RMSE) in den Oberflächenhöhenwerten. Der erwartete Fehler der Eingabe-Höhenwerte wird durch einen Gleitkommawert dargestellt. Wird diesem Parameter ein Wert größer 0 zugewiesen, ist das Ausgabe-Sichtbarkeitsraster ein Gleitkommawert. In diesem Fall stellt jeder Zellenwert des Ausgabe-Sichtbarkeitsrasters die Summe der Wahrscheinlichkeiten dar, mit der die Zelle für einen der Beobachter sichtbar ist.

Lautet der Analysetyp Beobachter oder die Analysemethode Sichtlinien aus Umfang, wird dieser Parameter deaktiviert.

Linear Unit
Ausgabe-Beziehungstabelle Beobachter-Bereich
(optional)

Gibt die für den jeweiligen Beobachter sichtbaren Regionen in Tabellenform aus. Diese Tabelle kann mit der Eingabe-Beobachter-Feature-Class und dem Ausgabe-Sichtbarkeitsraster in Beziehung gebracht werden, um die für die Beobachter sichtbaren Regionen zu identifizieren.

Diese Ausgabe wird nur dann erstellt, wenn der Analysetyp Beobachter lautet.

Table
Brechungskoeffizient
(optional)

Der Koeffizient der Brechung sichtbaren Lichts in der Atmosphäre.

Der Standardwert ist 0,13.

Double
Oberflächenversatz
(optional)

Eine vertikale Entfernung, die zum Z-Wert jeder Zelle hinzugefügt werden soll, um die Sichtbarkeit anzuzeigen. Er muss als positive Ganzzahl oder als Gleitkommawert vorliegen.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Wenn das zu beobachtende Objekt beispielsweise ein Fahrzeug ist, sollte hier die Höhe des Fahrzeugs angegeben werden.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert von allen Beobachtern verwendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist 0.

Linear Unit; Field
Beobachterhöhe
(optional)

Die Oberflächenhöhen der Beobachterpunkte oder Stützpunkte.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Wird für den Parameter kein Wert angegeben, wird die Beobachterhöhe mittels bilinearer Interpolation dem Oberflächen-Raster entnommen. Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Linear Unit; Field
Beobachterversatz
(optional)

Eine vertikale Entfernung, die der Beobachterhöhe hinzugefügt werden soll. Er muss als positive Ganzzahl oder als Gleitkommawert vorliegen.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Wenn ein Beobachter beispielsweise von einem Turm schaut, sollte hier die Höhe dieses Turms angegeben werden.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist 1 Meter.

Linear Unit; Field
Innerer Radius
(optional)

Die Anfangsentfernung, von der aus die Sichtbarkeit bestimmt wird. Zellen mit einem Wert unter dieser Entfernung sind für die Ausgabe nicht sichtbar, können aber dennoch die Sichtbarkeit der Zellen zwischen innerem und äußerem Radius behindern.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist 0.

Linear Unit; Field
Innerer Radius ist 3D-Entfernung.
(optional)

Gibt den Entfernungstyp für den Parameter "Innerer Radius" an.

  • Deaktiviert: Der innere Radius ist als 2D-Entfernung zu interpretieren. Dies ist die Standardeinstellung.
  • Aktiviert: Der innere Radius ist als 3D-Entfernung zu interpretieren.
Boolean
Äußerer Radius
(optional)

Die maximale Entfernung, von der aus die Sichtbarkeit bestimmt wird. Zellen außerhalb dieser Entfernung werden von der Analyse ausgeschlossen.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Linear Unit; Field
Äußerer Radius ist 3D-Entfernung.
(optional)

Gibt den Entfernungstyp für den Parameter "Äußerer Radius" an.

  • Deaktiviert: Der äußere Radius ist als 2D-Entfernung zu interpretieren. Dies ist die Standardeinstellung.
  • Aktiviert: Der äußere Radius ist als 3D-Entfernung zu interpretieren.
Boolean
Horizontaler Anfangswinkel
(optional)

Der Anfangswinkel des horizontalen Abtastbereichs. Geben Sie den Wert in Grad von 0 bis 360 als ganze Zahl oder als Gleitkommawert an (0 = Norden). Der Standardwert ist 0.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Double; Field
Horizontaler Endwinkel
(optional)

Der Endwinkel des horizontalen Abtastbereichs. Geben Sie den Wert in Grad von 0 bis 360 als ganze Zahl oder als Gleitkommawert an (0 = Norden). Der Standardwert ist 360.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Double; Field
Vertikaler oberer Winkel
(optional)

Die Grenze für den vertikalen oberen Winkel des Scanbereichs im Verhältnis zur horizontalen Ebene. Der Wert wird in Grad als Ganzzahl- oder Gleitkommawert angegeben. Der zulässige Bereich liegt zwischen -90 und 90 (einschließlich).

Dieser Parameterwert muss größer als der Wert des Parameters Vertikaler unterer Winkel sein.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist 90 (senkrecht nach oben).

Double; Field
Vertikaler unterer Winkel
(optional)

Die Grenze für den vertikalen unteren Winkel des Scanbereichs im Verhältnis zur horizontalen Ebene. Der Wert wird in Grad als Ganzzahl- oder Gleitkommawert angegeben. Der zulässige Bereich liegt zwischen -90 und 90 (ausschließlich).

Dieser Parameterwert muss kleiner als der Wert des Parameters Vertikaler oberer Winkel sein.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist -90 (senkrecht nach unten).

Double; Field
Analysemethode
(optional)

Gibt an, mit welcher Methode die Sichtbarkeit berechnet wird. Mit dieser Option tauschen Sie ein wenig Genauigkeit gegen eine erhöhte Performance ein.

  • Alle SichtlinienEine Sichtlinie wird für jede Zelle im Raster ausgeführt, um sichtbare Bereiche zu erstellen. Dies ist das Standardverfahren.
  • Sichtlinien aus UmfangSichtlinien werden nur für die Zellen des Umfangs der sichtbaren Bereiche ausgeführt, um sichtbare Bereiche zu erstellen. Diese Methode zeichnet sich im Vergleich zu der Methode Alle Sichtlinien durch eine bessere Performance aus, da weniger Sichtlinien in der Berechnung enthalten sind.
String
Zielgerät für Analyse
(optional)

Gibt das Gerät an, das für die Berechnung verwendet wird.

  • GPU dann CPUWenn eine kompatible GPU gefunden wird, wird sie für die Berechnung verwendet. Andernfalls wird die CPU verwendet. Dies ist die Standardeinstellung.
  • Nur CPUDie Berechnung wird nur auf der CPU durchgeführt.
  • Nur GPUDie Berechnung wird nur auf der GPU durchgeführt.
String

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster.

Beim Analysetyp FREQUENCY, bei dem der Parameter für einen vertikalen Fehler 0 (Null) beträgt oder nicht angegeben ist, erfasst das Ausgabe-Raster die Häufigkeit, mit der jede Zellenposition im Eingabe-Oberflächen-Raster für die Eingabe-Beobachterpositionen sichtbar ist. Ist der Parameter für den vertikalen Fehler größer als 0 (Null), wird in jeder Zelle des Ausgabe-Rasters die Summe der Wahrscheinlichkeiten erfasst, mit der die Zelle für einen der Betrachter sichtbar ist. Beim Analysetyp OBSERVERS erfasst das Ausgabe-Raster die eindeutigen Regionen-IDs für die sichtbaren Flächen, die anhand der Ausgabetabelle für Beobachter-Regionen-Beziehungen mit den Beobachter-Features in Bezug gesetzt werden können.

Raster

Viewshed2(in_raster, in_observer_features, {out_agl_raster}, {analysis_type}, {vertical_error}, {out_observer_region_relationship_table}, {refractivity_coefficient}, {surface_offset}, {observer_elevation}, {observer_offset}, {inner_radius}, {inner_radius_is_3d}, {outer_radius}, {outer_radius_is_3d}, {horizontal_start_angle}, {horizontal_end_angle}, {vertical_upper_angle}, {vertical_lower_angle}, {analysis_method}, {analysis_target_device})
NameErläuterungDatentyp
in_raster

Das Eingabe-Oberflächen-Raster. Das Raster kann ein ganzzahliges oder ein Gleitkomma-Raster sein.

Das Eingabe-Raster wird im Zuge der Sichtbarkeitsberechnung in ein geozentrisches 3D-Koordinatensystem umgewandelt. Die Bestimmung der Sichtbarkeit wird durch NoData-Zellen im Eingabe-Raster nicht versperrt.

Raster Layer
in_observer_features

Die Eingabe-Feature-Class, die die Beobachterpositionen identifiziert. Dabei kann es sich um Punkt-, Multipoint- oder Polylinien-Features handeln.

Im Zuge der Sichtbarkeitsberechnung wird die Eingabe-Feature-Class in ein geozentrisches 3D-Koordinatensystem umgewandelt. Beobachter, die sich außerhalb der Ausdehnung des Oberflächen-Rasters oder auf NoData-Zellen befinden, werden bei der Berechnung ignoriert.

Feature Layer
out_agl_raster
(optional)

Das Ausgabe-Raster der Ebene über Bodenoberfläche (AGL).

Das AGL-Ergebnis ist ein Raster, bei dem jeder Zellenwert der Mindesthöhe entspricht, die einer ansonsten nicht sichtbaren Zelle hinzugefügt werden muss, um sie zumindest durch einen Beobachter sichtbar zu machen. Zellen, die bereits sichtbar waren, wird in diesem Ausgabe-Raster der Wert 0 zugewiesen.

Wenn der Parameter für den vertikalen Fehler 0 beträgt, ist das AGL-Ausgabe-Raster ein Einband-Raster. Wenn der vertikale Fehler größer als 0 ist, wird das AGL-Ausgabe-Raster unter Berücksichtigung der Zufallseffekte aus dem Eingabe-Raster als Dreiband-Raster erstellt. Das erste Band stellt die mittleren, das zweite Band die minimalen und das dritte Band die maximalen AGL-Werte dar.

Raster Dataset
analysis_type
(optional)

Gibt an, welcher Typ von Sichtbarkeitsanalyse durchgeführt werden soll, indem Sie festlegen, wie sichtbar jede Zelle für die Beobachter ist, oder indem Sie für jede Oberflächenposition ermitteln, welche Beobachter sichtbar sind.

  • FREQUENCYDie Ausgabe erfasst die Häufigkeit, mit der jede Zellenposition im Eingabe-Oberflächen-Raster für die Eingabe-Beobachterpositionen (z. B. Punkte oder Stützpunkte für Polylinien-Beobachter-Features) sichtbar ist. Dies ist die Standardeinstellung.
  • OBSERVERSDie Ausgabe bestimmt die exakten Beobachterpunkte, die von jeder Position auf der Raster-Oberfläche sichtbar sind. Die für diesen Analysetyp maximal zulässige Anzahl der Eingabe-Beobachter beträgt 32.
String
vertical_error
(optional)

Der Unsicherheitsfaktor (Root-Mean-Square Error oder RMSE) in den Oberflächenhöhenwerten. Der erwartete Fehler der Eingabe-Höhenwerte wird durch einen Gleitkommawert dargestellt. Wird diesem Parameter ein Wert größer 0 zugewiesen, ist das Ausgabe-Sichtbarkeitsraster ein Gleitkommawert. In diesem Fall stellt jeder Zellenwert des Ausgabe-Sichtbarkeitsrasters die Summe der Wahrscheinlichkeiten dar, mit der die Zelle für einen der Beobachter sichtbar ist.

Lautet der Analysetyp Beobachter oder die Analysemethode Sichtlinien aus Umfang, wird dieser Parameter deaktiviert.

Linear Unit
out_observer_region_relationship_table
(optional)

Gibt die für den jeweiligen Beobachter sichtbaren Regionen in Tabellenform aus. Diese Tabelle kann mit der Eingabe-Beobachter-Feature-Class und dem Ausgabe-Sichtbarkeitsraster in Beziehung gebracht werden, um die für die Beobachter sichtbaren Regionen zu identifizieren.

Die Erstellung dieser Ausgabe erfolgt nur bei dem Analysetyp OBSERVERS.

Table
refractivity_coefficient
(optional)

Der Koeffizient der Brechung sichtbaren Lichts in der Atmosphäre.

Der Standardwert ist 0,13.

Double
surface_offset
(optional)

Eine vertikale Entfernung, die zum Z-Wert jeder Zelle hinzugefügt werden soll, um die Sichtbarkeit anzuzeigen. Er muss als positive Ganzzahl oder als Gleitkommawert vorliegen.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Wenn das zu beobachtende Objekt beispielsweise ein Fahrzeug ist, sollte hier die Höhe des Fahrzeugs angegeben werden.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert von allen Beobachtern verwendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist 0.

Linear Unit; Field
observer_elevation
(optional)

Die Oberflächenhöhen der Beobachterpunkte oder Stützpunkte.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Wird für den Parameter kein Wert angegeben, wird die Beobachterhöhe mittels bilinearer Interpolation dem Oberflächen-Raster entnommen. Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Linear Unit; Field
observer_offset
(optional)

Eine vertikale Entfernung, die der Beobachterhöhe hinzugefügt werden soll. Er muss als positive Ganzzahl oder als Gleitkommawert vorliegen.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Wenn ein Beobachter beispielsweise von einem Turm schaut, sollte hier die Höhe dieses Turms angegeben werden.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist 1 Meter.

Linear Unit; Field
inner_radius
(optional)

Die Anfangsentfernung, von der aus die Sichtbarkeit bestimmt wird. Zellen mit einem Wert unter dieser Entfernung sind für die Ausgabe nicht sichtbar, können aber dennoch die Sichtbarkeit der Zellen zwischen innerem und äußerem Radius behindern.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist 0.

Linear Unit; Field
inner_radius_is_3d
(optional)

Gibt den Entfernungstyp für den Parameter "Innerer Radius" an.

  • GROUNDDer innere Radius ist als 2D-Entfernung zu interpretieren. Dies ist die Standardeinstellung.
  • 3DDer innere Radius ist als 3D-Entfernung zu interpretieren.
Boolean
outer_radius
(optional)

Die maximale Entfernung, von der aus die Sichtbarkeit bestimmt wird. Zellen außerhalb dieser Entfernung werden von der Analyse ausgeschlossen.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Linear Unit; Field
outer_radius_is_3d
(optional)

Gibt den Entfernungstyp für den Parameter "Äußerer Radius" an.

  • GROUNDDer äußere Radius ist als 2D-Entfernung zu interpretieren. Dies ist die Standardeinstellung.
  • 3DDer äußere Radius ist als 3D-Entfernung zu interpretieren.
Boolean
horizontal_start_angle
(optional)

Der Anfangswinkel des horizontalen Abtastbereichs. Geben Sie den Wert in Grad von 0 bis 360 als ganze Zahl oder als Gleitkommawert an (0 = Norden). Der Standardwert ist 0.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Double; Field
horizontal_end_angle
(optional)

Der Endwinkel des horizontalen Abtastbereichs. Geben Sie den Wert in Grad von 0 bis 360 als ganze Zahl oder als Gleitkommawert an (0 = Norden). Der Standardwert ist 360.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Double; Field
vertical_upper_angle
(optional)

Die Grenze für den vertikalen oberen Winkel des Scanbereichs im Verhältnis zur horizontalen Ebene. Der Wert wird in Grad als Ganzzahl- oder Gleitkommawert angegeben. Der zulässige Bereich liegt zwischen -90 und 90 (einschließlich).

Dieser Parameterwert muss größer als der Wert des Parameters Vertikaler unterer Winkel sein.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist 90 (senkrecht nach oben).

Double; Field
vertical_lower_angle
(optional)

Die Grenze für den vertikalen unteren Winkel des Scanbereichs im Verhältnis zur horizontalen Ebene. Der Wert wird in Grad als Ganzzahl- oder Gleitkommawert angegeben. Der zulässige Bereich liegt zwischen -90 und 90 (ausschließlich).

Dieser Parameterwert muss kleiner als der Wert des Parameters Vertikaler oberer Winkel sein.

Sie können ein Feld im Eingabe-Beobachter-Dataset auswählen oder einen numerischen Wert angeben.

Ist dieser Parameter auf einen Wert festgelegt, wird dieser Wert auf alle Beobachter angewendet. Um für jeden Beobachter unterschiedliche Werte anzugeben, legen Sie diesen Parameter auf ein Feld im Eingabe-Beobachter-Features-Dataset fest.

Der Standardwert ist -90 (senkrecht nach unten).

Double; Field
analysis_method
(optional)

Gibt an, mit welcher Methode die Sichtbarkeit berechnet wird. Mit dieser Option tauschen Sie ein wenig Genauigkeit gegen eine erhöhte Performance ein.

  • ALL_SIGHTLINESEine Sichtlinie wird für jede Zelle im Raster ausgeführt, um sichtbare Bereiche zu erstellen. Dies ist das Standardverfahren.
  • PERIMETER_SIGHTLINESSichtlinien werden nur für die Zellen des Umfangs der sichtbaren Bereiche ausgeführt, um sichtbare Bereiche zu erstellen. Diese Methode zeichnet sich im Vergleich zu der Methode Alle Sichtlinien durch eine bessere Performance aus, da weniger Sichtlinien in der Berechnung enthalten sind.
String
analysis_target_device
(optional)

Gibt das Gerät an, das für die Berechnung verwendet wird.

  • GPU_THEN_CPUWenn eine kompatible GPU gefunden wird, wird sie für die Berechnung verwendet. Andernfalls wird die CPU verwendet. Dies ist die Standardeinstellung.
  • CPU_ONLYDie Berechnung wird nur auf der CPU durchgeführt.
  • GPU_ONLYDie Berechnung wird nur auf der GPU durchgeführt.
String

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster.

Beim Analysetyp FREQUENCY, bei dem der Parameter für einen vertikalen Fehler 0 (Null) beträgt oder nicht angegeben ist, erfasst das Ausgabe-Raster die Häufigkeit, mit der jede Zellenposition im Eingabe-Oberflächen-Raster für die Eingabe-Beobachterpositionen sichtbar ist. Ist der Parameter für den vertikalen Fehler größer als 0 (Null), wird in jeder Zelle des Ausgabe-Rasters die Summe der Wahrscheinlichkeiten erfasst, mit der die Zelle für einen der Betrachter sichtbar ist. Beim Analysetyp OBSERVERS erfasst das Ausgabe-Raster die eindeutigen Regionen-IDs für die sichtbaren Flächen, die anhand der Ausgabetabelle für Beobachter-Regionen-Beziehungen mit den Beobachter-Features in Bezug gesetzt werden können.

Raster

Codebeispiel

Viewshed2: Beispiel 1 (Python-Fenster)

In diesem Beispiel werden die Oberflächenpositionen, die verschiedene Beobachter sehen können, ohne Verwendung von Beobachterparametern bestimmt.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outViewshed2 = Viewshed2("elevation", "obser1.shp", "", "OBSERVERS", "",
                         "C:/sapyexamples/output/obstable01.dbf",
                         analysis_method="ALL_SIGHTLINES")
outViewshed2.save("C:/sapyexamples/output/outvwshd2_01")
Viewshed2: Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden die Oberflächenpositionen, die verschiedene Beobachter sehen können, mithilfe von Attributen in der Eingabe-Feature-Class als Beobachterparameter bestimmt.

# Name: Viewshed2_Ex_02.py
# Description: Determines the raster surface locations visible to a set of
#              observer features.
# 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"
inObservers = "obser2.shp"
outAGL = ""
analysisType = "OBSERVERS"
verticalError = ""
outAnalysisRelationTable = "C:/sapyexamples/output/obser_region2.dbf"
refractCoeff = ""
surfaceOffset = "offsetb"
observerElevation = "spot"
observerOffset = "offseta"
innerRadius = "radius1"
innerIs3D = "False"
outerRadius = "radius2"
outerIs3D = "True"
horizStartAngle = "azimuth1"
horizEndAngle = "azimuth2"
vertUpperAngle = "vert1"
vertLowerAngle = "vert2"
analysisMethod = "ALL_SIGHTLINES"

# Execute Viewshed2
outViewshed2 = Viewshed2(inRaster, inObservers, outAGL, analysisType,
                         verticalError, outAnalysisRelationTable, refractCoeff,
                         surfaceOffset, observerElevation, observerOffset,
                         innerRadius, innerIs3D, outerRadius, outerIs3D,
                         horizStartAngle, horizEndAngle, vertUpperAngle,
                         vertLowerAngle, analysisMethod)

# Save the output
outViewshed2.save("C:/sapyexamples/output/outvwshd2_02")