Beobachterpunkte (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der 3D Analyst-Lizenz verfügbar.

Zusammenfassung

Hiermit werden die Beobachterpunkte bestimmt, die von jeder Position auf der Raster-Oberfläche sichtbar sind.

Das Werkzeug Geodätisches Sichtfeld bietet eine erweiterte Funktionalität und Performance.

Abbildung

Ausgabe des Werkzeugs "Bobachterpunkte" auf einer geschummerten Höhenoberfläche

Verwendung

• Das Bestimmen von Beobachterpunkten ist ein verarbeitungsintensiver Prozess. Die Verarbeitungsdauer hängt von der Auflösung ab. Im Rahmen vorbereitender Untersuchungen können Sie eine gröbere Zellengröße wählen, um die Anzahl der Zellen in der Eingabe zu reduzieren. Verwenden Sie das Raster in voller Auflösung, wenn die endgültigen Ergebnisse erstellt werden sollen.

• Wenn das Eingabe-Raster aufgrund von Fehlern bei der Referenzpunkterfassung nicht erwünschte Informationen enthält, können Sie das Raster mit einem Tiefpassfilter wie der Option "Mittelwert" des Werkzeugs Focal Statistics glätten, bevor Sie dieses Werkzeug ausführen.

• Die Sichtbarkeit aller Zellzentren wird bestimmt, indem der Höhenwinkel zum Zellzentrum mit dem Höhenwinkel zum lokalen Horizont verglichen wird. Der lokale Horizont wird durch Untersuchen des Zwischenterrains zwischen dem Beobachterpunkt und dem aktuellen Zellzentrum berechnet. Wenn der Punkt über dem lokalen Horizont liegt, gilt er als sichtbar.

• Das Werkzeug stellt ein optionales Ausgabe-Raster der Ebene über Bodenoberfläche (AGL, Above Ground Level) bereit. Jede Zelle des AGL-Ausgabe-Rasters erfasst die Mindesthöhe, die dieser Zelle hinzugefügt werden muss, um sie zumindest durch einen Beobachter sichtbar zu machen.

  Wenn die Eingabe-Beobachter-Features mehrere Beobachter enthalten, ist der Ausgabewert das Minimum der AGL-Werte der einzelnen Beobachter.

• 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.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raster	Das Eingabe-Oberflächen-Raster.	Raster Layer
Eingabe-Punkt-Features für Beobachter	Die Point-Feature-Class, die die Beobachterpositionen identifiziert. Die maximal zulässige Zahl an Punkten ist 16.	Feature Layer
Z-Faktor (optional)	Die Anzahl der XY-Geländeeinheiten in einer Z-Oberflächeneinheit. Durch den Z-Faktor werden die Maßeinheiten der Z-Einheiten angepasst, falls sie sich von den XY-Einheiten der Eingabe-Oberfläche unterscheiden. Die Z-Werte der Eingabe-Oberfläche werden bei der Berechnung der endgültigen Ausgabe-Oberfläche mit dem Z-Faktor multipliziert. Falls die XY-Einheiten und die Z-Einheiten in denselben Maßeinheiten ausgedrückt sind, lautet der Z-Faktor 1. Dies ist die Standardeinstellung. Wenn die XY- und Z-Einheiten unterschiedliche Maßeinheiten aufweisen, muss der Z-Faktor entsprechend festgelegt werden, da andernfalls falsche Ergebnisse erzielt werden. Beispiel: Wenn die Z-Einheiten in Fuß und die XY-Einheiten in Metern angegeben sind, müssen Sie den Z-Faktor "0,3048" wählen, um die Z-Einheiten von Fuß in Meter umzurechnen (1 Fuß = 0,3048 Meter).	Double
Erdkrümmungskorrektur verwenden (optional)	Legt fest, ob eine Korrektur der Erdkrümmung angewendet wird. Deaktiviert: Es wird keine Krümmungskorrektur vorgenommen. Dies ist die Standardeinstellung. Aktiviert: Es wird eine Krümmungskorrektur vorgenommen.	Boolean
Brechungskoeffizient (optional)	Der Koeffizient der Brechung sichtbaren Lichts in der Atmosphäre. Der Standardwert ist 0,13.	Double
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, haben in diesem Ausgabe-Raster den Wert 0.	Raster Dataset

Rückgabewert

Beschriftung	Erläuterung	Datentyp
Ausgabe-Raster	Das Ausgabe-Raster. Die Ausgabe bestimmt die exakten Beobachterpunkte, die von jeder Position auf der Raster-Oberfläche sichtbar sind.	Raster

Python

ObserverPoints(in_raster, in_observer_point_features, {z_factor}, {curvature_correction}, {refractivity_coefficient}, {out_agl_raster})

Name	Erläuterung	Datentyp
in_raster	Das Eingabe-Oberflächen-Raster.	Raster Layer
in_observer_point_features	Die Point-Feature-Class, die die Beobachterpositionen identifiziert. Die maximal zulässige Zahl an Punkten ist 16.	Feature Layer
z_factor (optional)	Die Anzahl der XY-Geländeeinheiten in einer Z-Oberflächeneinheit. Durch den Z-Faktor werden die Maßeinheiten der Z-Einheiten angepasst, falls sie sich von den XY-Einheiten der Eingabe-Oberfläche unterscheiden. Die Z-Werte der Eingabe-Oberfläche werden bei der Berechnung der endgültigen Ausgabe-Oberfläche mit dem Z-Faktor multipliziert. Falls die XY-Einheiten und die Z-Einheiten in denselben Maßeinheiten ausgedrückt sind, lautet der Z-Faktor 1. Dies ist die Standardeinstellung. Wenn die XY- und Z-Einheiten unterschiedliche Maßeinheiten aufweisen, muss der Z-Faktor entsprechend festgelegt werden, da andernfalls falsche Ergebnisse erzielt werden. Beispiel: Wenn die Z-Einheiten in Fuß und die XY-Einheiten in Metern angegeben sind, müssen Sie den Z-Faktor "0,3048" wählen, um die Z-Einheiten von Fuß in Meter umzurechnen (1 Fuß = 0,3048 Meter).	Double
curvature_correction (optional)	Legt fest, ob eine Korrektur der Erdkrümmung angewendet wird. FLAT_EARTH—Es wird keine Krümmungskorrektur vorgenommen. Dies ist die Standardeinstellung. CURVED_EARTH—Es wird eine Krümmungskorrektur vorgenommen.	Boolean
refractivity_coefficient (optional)	Der Koeffizient der Brechung sichtbaren Lichts in der Atmosphäre. Der Standardwert ist 0,13.	Double
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, haben in diesem Ausgabe-Raster den Wert 0.	Raster Dataset

Rückgabewert

Name	Erläuterung	Datentyp
out_raster	Das Ausgabe-Raster. Die Ausgabe bestimmt die exakten Beobachterpunkte, die von jeder Position auf der Raster-Oberfläche sichtbar sind.	Raster

Codebeispiel

ObserverPoints – Beispiel 1 (Python-Fenster)

In diesem Beispiel werden die Beobachterpunkte exakt bestimmt, die von jeder Position auf der Raster-Oberfläche sichtbar sind.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outObsPoints = ObserverPoints("elevation","observers.shp", 1, "CURVED_EARTH", 0.13)
outObsPoints.save("C:/sapyexamples/output/outobspnt01")

ObserverPoints – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel werden die Beobachterpunkte exakt bestimmt, die von jeder Position auf der Raster-Oberfläche sichtbar sind.

# Name: ObserverPoints_Ex_02.py
# Description: Identifies exactly which observer points are visible 
#              from each raster surface location.
# 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"
inObsPoints = "observers.shp"
zFactor = 1
useEarthCurv = "CURVED_EARTH"
refractionVal = 0.13

# Execute ObserverPoints
outObsPoints = ObserverPoints(inRaster, inObsPoints, zFactor, 
                              useEarthCurv, refractionVal)

# Save the output 
outObsPoints.save("C:/sapyexamples/output/outobspnt02")

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Komprimierung, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Scratch-Workspace, Fang-Raster, Kachelgröße