Beobachterpunkte (Spatial Analyst)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

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

Weitere Informationen zur Funktionsweise von "Beobachterpunkte"

Verwendung

Syntax

ObserverPoints (in_raster, in_observer_point_features, {z_factor}, {curvature_correction}, {refractivity_coefficient}, {out_agl_raster})
ParameterErläuterungDatentyp
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)

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. Hierbei handelt es sich um 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)

Ermöglicht eine Korrektur der Erdkrümmung.

  • FLAT_EARTH Es wird keine Krümmungskorrektur vorgenommen. Dies ist die Standardeinstellung.
  • CURVED_EARTH Es wird eine Krümmungskorrektur vorgenommen.
Boolean
refractivity_coefficient
(optional)

Koeffizient der Brechung sichtbaren Lichts in der Atmosphäre.

Der Standardwert ist 0,13.

Double
out_agl_raster
(optional)

Das AGL-Ausgabe-Raster.

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

Rückgabewert

NameErläuterungDatentyp
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

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

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

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Erfordert Spatial Analyst oder 3D Analyst
ArcGIS for Desktop Standard: Erfordert Spatial Analyst oder 3D Analyst
ArcGIS for Desktop Advanced: Erfordert Spatial Analyst oder 3D Analyst
9/12/2013