Sichtfelder erstellen (Raster Analysis)

Zusammenfassung

Erstellt Flächen, in denen ein Betrachter Objekte auf dem Boden erkennen kann. Die Eingabe-Beobachterpunkte können entweder Beobachter (z. B. Personen am Boden oder Beobachter in einem Feuerwachturm) oder beobachtete Objekte (z. B. Windkraftanlagen, Wassertürme, Fahrzeuge oder Personen) sein.

Sowohl Beobachter als auch beobachtete Objekte können sich in einer bestimmten Höhe über dem Boden befinden. Diese Höhen werden zur Ermittlung der Sichtbarkeit verwendet. So wird beispielsweise ein Sichtfeld, das für 90 Meter hohe Windkraftanlagen und eine 1,80 Meter große, am Boden stehende Person berechnet wird, üblicherweise größer sein als ein Sichtfeld für 60 Meter hohe Windkraftanlagen und eine 1,50 Meter große Person.

Der Ergebnis-Layer zeichnet auf, wie oft jede Zellenposition im Eingabe-Oberflächen-Raster von den Eingabe-Beobachterpunkten aus gesehen werden kann. Nicht sichtbare Zellen erhalten den Wert "NoData".

Abbildung

Abbildung zum Werkzeug "Sichtfelder erstellen"

Verwendung

  • Dieses Portal-Werkzeug für die Raster-Analyse ist verfügbar, wenn Sie bei einem ArcGIS Enterprise-Portal angemeldet sind, das über einen für Raster Analysis konfigurierten ArcGIS Image Server verfügt. Beim Ausführen des Werkzeugs dient ArcGIS Pro als Client. Die Verarbeitung erfolgt auf den Servern, die mit ArcGIS Enterprise verbunden sind. Das Portal-Werkzeug akzeptiert Layer aus dem Portal als Eingabe und erstellt die Ausgabe im Portal.

    Als Eingabe-Raster-Layer kann ein Layer aus dem Portal, ein URI bzw. eine URL zu einem Image-Service oder die Ausgabe des Werkzeugs Image Server-Layer erstellen verwendet werden. Bei dem Eingabe-Feature-Layer kann es sich um einen Layer aus dem Portal oder ein URI bzw. eine URL zu einem Feature-Service handeln. Lokale Raster-Daten oder -Layer werden von diesem Werkzeug nicht unterstützt. Obwohl Sie lokale Feature-Daten und Layer als Eingabe für dieses Portal verwenden können, empfiehlt es sich, Layer aus Ihrem Portal als Eingabe zu nutzen.

  • Die Sichtbarkeit jedes einzelnen Zellenmittelpunkts wird durch einen Sichtlinientest zwischen dem Ziel und dem jeweiligen Beobachter ermittelt.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Erhöhungsoberfläche

Die Erhöhungsoberfläche, die für die Berechnung des Sichtfeldes verwendet wird.

Wenn sich die vertikale Einheit der Eingabe-Oberfläche von der horizontalen Einheit unterscheidet, beispielsweise, wenn die Erhöhungswerte in Fuß angegeben werden, das Koordinatensystem aber in Metern ist, muss für die Oberfläche ein vertikales Koordinatensystem definiert werden. Das Werkzeug verwendet nämlich die vertikalen (Z) und horizontalen (XY) Einheiten, um einen Z-Faktor für die Sichtfeldanalyse zu berechnen. Ohne ein vertikales Koordinatensystem und ohne verfügbare Z-Einheit wird angenommen, dass die Z-Einheit mit der XY-Einheit identisch ist. Das hat zur Folge, dass für die Analyse ein interner Z-Faktor von 1,0 verwendet wird. Dies kann die Ergebnisse verfälschen.

Die Erhöhungsoberfläche kann eine ganze Zahl oder eine Gleitkommazahl sein.

Raster Layer; Image Service; String
Beobachter-Features

Die Punkt-Features, die die Beobachterpositionen beim Berechnen der Sichtfelder identifizieren.

Feature Set
Ausgabename

Der Name des Ausgabe-Raster-Service.

Der Standardname basiert auf dem Werkzeugnamen und dem Namen des Eingabe-Layers. Wenn der Layer-Name bereits vorhanden ist, werden Sie dazu aufgefordert, einen anderen Namen einzugeben.

String
Optimiert für
(optional)

Gibt die Optimierungsmethode an, die zum Berechnen des Sichtfeldes verwendet wird.

  • GeschwindigkeitDie Verarbeitungsgeschwindigkeit wird auf Kosten der Genauigkeit optimiert, um die Performance zu verbessern. Dies ist die Standardeinstellung.
  • GenauigkeitDie Ergebnisgenauigkeit wird optimiert, was eine längere Verarbeitungsdauer zur Folge hat.
String
Maximale Beobachtungsentfernung - Typ
(optional)

Gibt an, wie die maximale Beobachtungsentfernung bestimmt wird.

Wenn Sie den Typ von Entfernung in Feld ändern, wird der Parameter Maximale Beobachtungsentfernung in Maximales Beobachtungsentfernungsfeld geändert.

  • EntfernungDie maximale Beobachtungsentfernung wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FeldDie maximale Entfernung von jeder Beobachterposition wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
Maximale Beobachtungsentfernung
(optional)

Der Entfernungsgrenzwert, bis zu dem sichtbare Flächen berechnet werden. Ob jenseits dieser Entfernung die weiteren Objekte von den Beobachterpunkten aus sichtbar sind, ist nicht bekannt.

Die Einheitenwerte lauten Kilometer, Meter, Meilen (Britisch), Yards (International), Fuß (International), Meilen (US Survey), Yards (US Survey) und Fuß (US Survey).

Der Standardwert ist 9 Meilen (Britisch).

Linear Unit
Maximales Beobachtungsentfernungsfeld
(optional)

Das Feld, das die maximale Beobachtungsentfernung für jeden Beobachter enthält. Die Werte in dem Feld müssen dieselbe Einheit wie die XY-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Die maximale Beobachtungsentfernung ist ein Entfernungsgrenzwert, bis zu dem sichtbare Flächen berechnet werden. Ob jenseits dieser Entfernung die weiteren Objekte von den Beobachterpunkten aus sichtbar sind, ist nicht bekannt.

Field
Minimale Beobachtungsentfernung - Typ
(optional)

Gibt an, wie die minimale sichtbare Beobachtungsentfernung bestimmt wird.

Wenn Sie den Typ von Entfernung in Feld ändern, wird der Parameter Minimale Beobachtungsentfernung in Minimales Beobachtungsentfernungsfeld geändert.

  • EntfernungDie minimale Beobachtungsentfernung wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FeldDie minimale Entfernung von jeder Beobachterposition wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
Minimale Beobachtungsentfernung
(optional)

Die Entfernung, ab der die sichtbaren Flächen berechnet werden. Zellen auf der Oberfläche, die innerhalb dieser Entfernung liegen, sind in der Ausgabe nicht sichtbar, können aber dennoch die Sichtbarkeit der Zellen zwischen der minimalen und der maximalen Beobachtungsentfernung behindern.

Die Einheitenwerte lauten Kilometer, Meter, Meilen (Britisch), Yards (International), Fuß (International), Meilen (US Survey), Yards (US Survey) und Fuß (US Survey).

Linear Unit
Minimales Beobachtungsentfernungsfeld
(optional)

Das Feld, das die minimale Beobachtungsentfernung für jeden Beobachter enthält. Die Werte in dem Feld müssen dieselbe Einheit wie die XY-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Die minimale Beobachtungsentfernung legt die Entfernung fest, ab der die sichtbaren Flächen berechnet werden. Zellen auf der Oberfläche, die innerhalb dieser Entfernung liegen, sind in der Ausgabe nicht sichtbar, können aber dennoch die Sichtbarkeit der Zellen zwischen der minimalen und der maximalen Beobachtungsentfernung behindern.

Field
Beobachtungsentfernungen sind dreidimensional
(optional)

Gibt an, ob die Parameterwerte für die minimale und die maximale Beobachtungsentfernung in 3D oder 2D gemessen werden. Eine 2D-Entfernung ist eine einfache lineare Distanz zwischen einem Beobachter und dem Ziel, die anhand der projizierten Position auf Höhe des Meeresspiegels ermittelt wird. Eine 3D-Entfernung liefert einen realistischeren Wert, da auch die relativen Höhen berücksichtigt werden.

  • Aktiviert: Die Beobachtungsentfernung wird als 3D-Entfernung gemessen.
  • Deaktiviert: Die Beobachtungsentfernung wird als 2D-Entfernung gemessen. Dies ist die Standardeinstellung.
Boolean
Beobachtererhöhungstyp
(optional)

Gibt an, wie die Erhöhung der Beobachter bestimmt wird.

Wenn Sie den Typ von Erhöhung in Feld ändern, wird der Parameter Beobachtererhöhung in Beobachtererhöhungsfeld geändert.

  • ErhöhungDie Beobachtererhöhung wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FeldDie Erhöhung für jede Beobachterposition wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
Beobachtererhöhung
(optional)

Die Erhöhung, die für die Beobachterpositionen verwendet wird.

Wird für den Parameter kein Wert angegeben, wird die Beobachtererhöhung 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 in den Eingabe-Beobachter-Features fest.

Die Einheitenwerte lauten Kilometer, Meter, Meilen (Britisch), Yards (International), Fuß (International), Meilen (US Survey), Yards (US Survey) und Fuß (US Survey).

Linear Unit
Beobachtererhöhungsfeld
(optional)

Das Feld mit der Erhöhung der Beobachter. Der Wert in dem Feld muss dieselbe Einheit wie die Z-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Wird für den Parameter kein Wert angegeben, wird die Beobachtererhöhung mittels bilinearer Interpolation dem Oberflächen-Raster entnommen.

Field
Beobachterhöhentyp
(optional)

Gibt an, wie die Höhe der Beobachter bestimmt wird.

Wenn Sie den Typ von Höhe in Feld ändern, wird der Parameter Beobachterhöhe in Beobachterhöhenfeld geändert.

  • HöheDie Beobachterhöhe wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FeldDie Höhe von jeder Beobachterposition wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
Beobachterhöhe
(optional)

Die Höhe, die für die Beobachterpositionen verwendet wird.

Die Einheitenwerte lauten Kilometer, Meter, Meilen (Britisch), Yards (International), Fuß (International), Meilen (US Survey), Yards (US Survey) und Fuß (US Survey).

Der Standardwert ist 6 Fuß (International).

Linear Unit
Beobachterhöhenfeld
(optional)

Das Feld mit der Höhe der Beobachter. Der Wert in dem Feld muss dieselbe Einheit wie die Z-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Field
Zielhöhentyp
(optional)

Gibt an, wie die Zielhöhe bestimmt wird.

Wenn Sie den Typ von Höhe in Feld ändern, wird der Parameter Zielhöhe in Zielhöhenfeld geändert.

  • HöheDie Zielhöhe wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FeldDie Höhe von jedem Ziel wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
Zielhöhe
(optional)

Die Höhe von Strukturen oder Personen am Boden, auf deren Basis die Sichtbarkeit festgestellt wird. Das sich hieraus ergebende Sichtfeld umfasst diejenigen Flächen, von denen aus ein Beobachterpunkt diese anderen Objekte sehen kann. Umgekehrt können die anderen Objekte auch einen Beobachterpunkt sehen.

Die Einheitenwerte lauten Kilometer, Meter, Meilen (Britisch), Yards (International), Fuß (International), Meilen (US Survey), Yards (US Survey) und Fuß (US Survey).

Linear Unit
Zielhöhenfeld
(optional)

Das Feld mit der Höhe der Ziele. Der Wert in dem Feld muss dieselbe Einheit wie die Z-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Field
AGL-Ausgabename (Above Ground Level)
(optional)

Der Name des AGL-Ausgabe-Rasters (Above Ground Level, Höhe über Grund). 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 für einen Beobachter sichtbar zu machen. Zellen, die bereits sichtbar waren, wird in diesem Ausgabe-Raster der Wert 0 zugewiesen.

String
Vertikaler Fehler
(optional)

Der Unsicherheitsfaktor (RMS-Fehler [Root Mean Square]) 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.

Linear Unit
Brechungskoeffizient
(optional)

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

Der Standardwert ist 0,13.

Double
Horizontaler Anfangswinkel
(optional)

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

Sie können ein Feld in den Eingabe-Beobachter-Features auswählen oder einen numerischen Wert angeben.

String
Horizontaler Endwinkel
(optional)

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

Sie können ein Feld in den Eingabe-Beobachter-Features auswählen oder einen numerischen Wert angeben.

String
Vertikaler oberer Winkel
(optional)

Die Grenze für den vertikalen oberen Winkel des Scanbereichs im Verhältnis zur horizontalen Ebene. Geben Sie den Wert in Grad zwischen -90 und 90 (einschließlich) ein. Der Wert kann eine ganze Zahl oder eine Gleitkommazahl sein. Der Standardwert ist 90 (senkrecht nach oben).

Sie können ein Feld in den Eingabe-Beobachter-Features auswählen oder einen numerischen Wert angeben.

String
Vertikaler unterer Winkel
(optional)

Die Grenze für den vertikalen unteren Winkel des Scanbereichs im Verhältnis zur horizontalen Ebene. Geben Sie den Wert in Grad zwischen -90 und 90 (ausschließlich) ein. Der Wert kann eine ganze Zahl oder eine Gleitkommazahl sein. Der Standardwert ist -90 (senkrecht nach unten).

Sie können ein Feld in den Eingabe-Beobachter-Features auswählen oder einen numerischen Wert angeben.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster für das Sichtfeld.

Raster Layer
AGL-Ausgabe-Raster (Above Ground Level)

Das Ausgabe-Raster mit der Höhe über Grund (Above Ground Level, AGL).

Raster Layer

arcpy.ra.CreateViewshed(inputElevationSurface, inputObserverFeatures, outputName, {optimizeFor}, {maximumViewingDistanceType}, {maximumViewingDistance}, {maximumViewingDistanceField}, {minimumViewingDistanceType}, {minimumViewingDistance}, {minimumViewingDistanceField}, {viewingDistanceIs3D}, {observersElevationType}, {observersElevation}, {observersElevationField}, {observersHeightType}, {observersHeight}, {observersHeightField}, {targetHeightType}, {targetHeight}, {targetHeightField}, {aboveGroundLevelOutputName}, {verticalError}, {refractivityCoefficient}, {horizontalStartAngle}, {horizontalEndAngle}, {verticalUpperAngle}, {verticalLowerAngle})
NameErläuterungDatentyp
inputElevationSurface

Die Erhöhungsoberfläche, die für die Berechnung des Sichtfeldes verwendet wird.

Wenn sich die vertikale Einheit der Eingabe-Oberfläche von der horizontalen Einheit unterscheidet, beispielsweise, wenn die Erhöhungswerte in Fuß angegeben werden, das Koordinatensystem aber in Metern ist, muss für die Oberfläche ein vertikales Koordinatensystem definiert werden. Das Werkzeug verwendet nämlich die vertikalen (Z) und horizontalen (XY) Einheiten, um einen Z-Faktor für die Sichtfeldanalyse zu berechnen. Ohne ein vertikales Koordinatensystem und ohne verfügbare Z-Einheit wird angenommen, dass die Z-Einheit mit der XY-Einheit identisch ist. Das hat zur Folge, dass für die Analyse ein interner Z-Faktor von 1,0 verwendet wird. Dies kann die Ergebnisse verfälschen.

Die Erhöhungsoberfläche kann eine ganze Zahl oder eine Gleitkommazahl sein.

Raster Layer; Image Service; String
inputObserverFeatures

Die Punkt-Features, die die Beobachterpositionen beim Berechnen der Sichtfelder identifizieren.

Feature Set
outputName

Der Name des Ausgabe-Raster-Service.

Der Standardname basiert auf dem Werkzeugnamen und dem Namen des Eingabe-Layers. Wenn der Layer-Name bereits vorhanden ist, werden Sie dazu aufgefordert, einen anderen Namen einzugeben.

String
optimizeFor
(optional)

Gibt die Optimierungsmethode an, die zum Berechnen des Sichtfeldes verwendet wird.

  • SPEEDDie Verarbeitungsgeschwindigkeit wird auf Kosten der Genauigkeit optimiert, um die Performance zu verbessern. Dies ist die Standardeinstellung.
  • ACCURACYDie Ergebnisgenauigkeit wird optimiert, was eine längere Verarbeitungsdauer zur Folge hat.
String
maximumViewingDistanceType
(optional)

Gibt an, wie die maximale Beobachtungsentfernung bestimmt wird.

  • DISTANCEDie maximale Beobachtungsentfernung wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FIELDDie maximale Entfernung von jeder Beobachterposition wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
maximumViewingDistance
(optional)

Der Entfernungsgrenzwert, bis zu dem sichtbare Flächen berechnet werden. Ob jenseits dieser Entfernung die weiteren Objekte von den Beobachterpunkten aus sichtbar sind, ist nicht bekannt.

Die Einheitenwerte lauten Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards und Feet.

Der Standardwert ist 9 Meilen (Britisch).

Linear Unit
maximumViewingDistanceField
(optional)

Das Feld, das die maximale Beobachtungsentfernung für jeden Beobachter enthält. Die Werte in dem Feld müssen dieselbe Einheit wie die XY-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Die maximale Beobachtungsentfernung ist ein Entfernungsgrenzwert, bis zu dem sichtbare Flächen berechnet werden. Ob jenseits dieser Entfernung die weiteren Objekte von den Beobachterpunkten aus sichtbar sind, ist nicht bekannt.

Field
minimumViewingDistanceType
(optional)

Gibt an, wie die minimale sichtbare Beobachtungsentfernung bestimmt wird.

  • DISTANCEDie minimale Beobachtungsentfernung wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FIELDDie minimale Entfernung von jeder Beobachterposition wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
minimumViewingDistance
(optional)

Die Entfernung, ab der die sichtbaren Flächen berechnet werden. Zellen auf der Oberfläche, die innerhalb dieser Entfernung liegen, sind in der Ausgabe nicht sichtbar, können aber dennoch die Sichtbarkeit der Zellen zwischen der minimalen und der maximalen Beobachtungsentfernung behindern.

Die Einheitenwerte lauten Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards und Feet.

Linear Unit
minimumViewingDistanceField
(optional)

Das Feld, das die minimale Beobachtungsentfernung für jeden Beobachter enthält. Die Werte in dem Feld müssen dieselbe Einheit wie die XY-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Die minimale Beobachtungsentfernung legt die Entfernung fest, ab der die sichtbaren Flächen berechnet werden. Zellen auf der Oberfläche, die innerhalb dieser Entfernung liegen, sind in der Ausgabe nicht sichtbar, können aber dennoch die Sichtbarkeit der Zellen zwischen der minimalen und der maximalen Beobachtungsentfernung behindern.

Field
viewingDistanceIs3D
(optional)

Gibt an, ob die Parameterwerte für die minimale und die maximale Beobachtungsentfernung in 3D oder 2D gemessen werden. Eine 2D-Entfernung ist eine einfache lineare Distanz zwischen einem Beobachter und dem Ziel, die anhand der projizierten Position auf Höhe des Meeresspiegels ermittelt wird. Eine 3D-Entfernung liefert einen realistischeren Wert, da auch die relativen Höhen berücksichtigt werden.

  • 2DDie Beobachtungsentfernung wird als 2D-Entfernung gemessen. Dies ist die Standardeinstellung.
  • 3DDie Beobachtungsentfernung wird als 3D-Entfernung gemessen.
Boolean
observersElevationType
(optional)

Gibt an, wie die Erhöhung der Beobachter bestimmt wird.

  • ELEVATIONDie Beobachtererhöhung wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FIELDDie Erhöhung für jede Beobachterposition wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
observersElevation
(optional)

Die Erhöhung, die für die Beobachterpositionen verwendet wird.

Wird für den Parameter kein Wert angegeben, wird die Beobachtererhöhung 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 in den Eingabe-Beobachter-Features fest.

Die Einheitenwerte lauten Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards und Feet.

Linear Unit
observersElevationField
(optional)

Das Feld mit der Erhöhung der Beobachter. Der Wert in dem Feld muss dieselbe Einheit wie die Z-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Wird für den Parameter kein Wert angegeben, wird die Beobachtererhöhung mittels bilinearer Interpolation dem Oberflächen-Raster entnommen.

Field
observersHeightType
(optional)

Gibt an, wie die Höhe der Beobachter bestimmt wird.

  • HEIGHTDie Beobachterhöhe wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FIELDDie Höhe von jeder Beobachterposition wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
observersHeight
(optional)

Die Höhe, die für die Beobachterpositionen verwendet wird.

Die Einheitenwerte lauten Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards und Feet.

Der Standardwert ist 6 Fuß (International).

Linear Unit
observersHeightField
(optional)

Das Feld mit der Höhe der Beobachter. Der Wert in dem Feld muss dieselbe Einheit wie die Z-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Field
targetHeightType
(optional)

Gibt an, wie die Zielhöhe bestimmt wird.

  • HEIGHTDie Zielhöhe wird durch den Wert, den Sie angeben, festgelegt. Dies ist das Standardverfahren.
  • FIELDDie Höhe von jedem Ziel wird durch die Werte in einem Feld bestimmt, das Sie angeben.
String
targetHeight
(optional)

Die Höhe von Strukturen oder Personen am Boden, auf deren Basis die Sichtbarkeit festgestellt wird. Das sich hieraus ergebende Sichtfeld umfasst diejenigen Flächen, von denen aus ein Beobachterpunkt diese anderen Objekte sehen kann. Umgekehrt können die anderen Objekte auch einen Beobachterpunkt sehen.

Die Einheitenwerte lauten Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards und Feet.

Linear Unit
targetHeightField
(optional)

Das Feld mit der Höhe der Ziele. Der Wert in dem Feld muss dieselbe Einheit wie die Z-Einheit der Eingabe-Erhöhungsoberfläche aufweisen.

Field
aboveGroundLevelOutputName
(optional)

Der Name des AGL-Ausgabe-Rasters (Above Ground Level, Höhe über Grund). 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 für einen Beobachter sichtbar zu machen. Zellen, die bereits sichtbar waren, wird in diesem Ausgabe-Raster der Wert 0 zugewiesen.

String
verticalError
(optional)

Der Unsicherheitsfaktor (RMS-Fehler [Root Mean Square]) 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.

Linear Unit
refractivityCoefficient
(optional)

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

Der Standardwert ist 0,13.

Double
horizontalStartAngle
(optional)

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

Sie können ein Feld in den Eingabe-Beobachter-Features auswählen oder einen numerischen Wert angeben.

String
horizontalEndAngle
(optional)

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

Sie können ein Feld in den Eingabe-Beobachter-Features auswählen oder einen numerischen Wert angeben.

String
verticalUpperAngle
(optional)

Die Grenze für den vertikalen oberen Winkel des Scanbereichs im Verhältnis zur horizontalen Ebene. Geben Sie den Wert in Grad zwischen -90 und 90 (einschließlich) ein. Der Wert kann eine ganze Zahl oder eine Gleitkommazahl sein. Der Standardwert ist 90 (senkrecht nach oben).

Sie können ein Feld in den Eingabe-Beobachter-Features auswählen oder einen numerischen Wert angeben.

String
verticalLowerAngle
(optional)

Die Grenze für den vertikalen unteren Winkel des Scanbereichs im Verhältnis zur horizontalen Ebene. Geben Sie den Wert in Grad zwischen -90 und 90 (ausschließlich) ein. Der Wert kann eine ganze Zahl oder eine Gleitkommazahl sein. Der Standardwert ist -90 (senkrecht nach unten).

Sie können ein Feld in den Eingabe-Beobachter-Features auswählen oder einen numerischen Wert angeben.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
outputRaster

Das Ausgabe-Raster für das Sichtfeld.

Raster Layer
outputAboveGroundLevelRaster

Das Ausgabe-Raster mit der Höhe über Grund (Above Ground Level, AGL).

Raster Layer

Codebeispiel

CreateViewshed: Beispiel 1 (Python-Fenster)

In diesem Beispiel wird aus angegebenen Oberflächen- und Beobachterpunkten ein Sichtfeld-Image-Service erstellt.

import arcpy

arcpy.ra.CreateViewshed(
    "https://myserver/rest/services/elevation/ImageServer", 
    "https://myserver/rest/services/destination/FeatureServer/0", 
    "outview1", "SPEED", "DISTANCE", "9 Miles", "#", "DISTANCE",
    "0 Meters", "#", "2D", "ELEVATION", "#", "#", "HEIGHT",
    "6 Feet", "#", "HEIGHT", "3 Feet", "#", "outagl1")
CreateViewshed: Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird aus angegebenen Oberflächen- und Beobachterpunkten ein Sichtfeld-Image-Service erstellt.

#---------------------------------------------------------------------------
# Name: CreateViewshed_example02.py
# Description: Creates a viewshed image service raster from given surface
#   and observer points.
#
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inSurface = "https://myserver/rest/services/elevation/ImageServer"
inObservers = "https://myserver/rest/services/destination/FeatureServer/0"
outputViewshed = "outview1"
optimizeFor = "Speed"
maxDistType = "Distance"
maxDist = "9 Miles"
maxDistField = "#"
minDistType = "Distance"
minDist = "0 Miles"
minDistField = "#"
distanceIs3D = "2D"
obsElevationType = "Elevation"
obsElevation = "#"
obsElevationField = "#"
obsOffsetType = "Height"
obsOffset = "6 Feet"
obsOffsetField = "#"
surfOffsetType = "Height"
surfOffset = "3 Feet"
surfOffsetField = "#"
outputAgl = "outagl1"

# Execute Create Viewshed raster analysis tool
arcpy.ra.CreateViewshed(
    inSurface, inObservers, outputViewshed, optimizeFor,
    maxDistType, maxDist, maxDistField, minDistType, minDist,
    minDistField, distanceIs3D, obsElevationType, obsElevation,
    obsElevationField, obsOffsetType, obsOffset, obsOffsetField,
    surfOffsetType, surfOffset, surfOffsetField, outputAgl)

Lizenzinformationen

  • Basic: Erfordert ArcGIS Image Server
  • Standard: Erfordert ArcGIS Image Server
  • Advanced: Erfordert ArcGIS Image Server

Verwandte Themen