Zusammenfassung
Gibt Polygone sichtbarer Bereiche für mehrere angegebene Eingabe-Beobachterpunkte zurück.
Verwendung
Die Werkzeuge in der Sammlung "Einsatzbereite Werkzeuge" sind ArcGIS Online-Geoverarbeitungsservices, die gehostete Daten und Analysefunktionen von ArcGIS Online verwenden.
Es stehen mehrere Höhenquellen zur Verfügung, die eine unterschiedliche räumliche Auflösung aufweisen und verschiedene Flächen abdecken. Nicht alle Auflösungen sind für alle Flächen verfügbar. Das Werkzeug gibt eine Fehlermeldung zurück, wenn die angegebene Auflösung an einem der Eingabe-Beobachterpunkte nicht verfügbar ist.
Wenn der Parameter DEM-Auflösung nicht angegeben wurde, wird die gröbste Auflösung (90 m) verwendet. Wenn Finest angegeben wurde, verwendet das Werkzeug die höchste verfügbare Auflösung am Beobachterpunkt, die durch den Parameter Maximale Entfernung zulässig ist.
Für den Parameter Maximale Entfernung beträgt der zulässige Wert für die DEM-Auflösungen von 10 m und 30 m maximal 15 Kilometer. Für die DEM-Auflösung von 90 m liegt der zulässige Wert bei maximal 50 Kilometern. Wenn dieser Parameter nicht angegeben ist, verwendet das Werkzeug einen Standardwert basierend auf dem Parameter für die DEM-Auflösung. Bei der Auflösung von 10 m beträgt die standardmäßige maximale Entfernung 5 Kilometer. Bei den DEM-Auflösungen von 30 m und 90 m beträgt die Standardentfernung 15 Kilometer.
Das Werkzeug verwendet eine Höhenquelle mit einfacher Auflösung für die Eingabe-Features. Alle Eingabe-Features müssen in eine einfache Auflösung passen. Andernfalls wählt das Werkzeug die höchste Auflösung aus, die die Eingabe-Features abdeckt.
Die Sichtbarkeit in Wasser ist eingeschränkt, deshalb verwendet das Werkzeug die Wasseroberfläche als Höhenoberfläche. Meeren wird der Wert Null zugewiesen, und großen Wasserflächen wird eine angemessene flache örtliche Höhe zugewiesen.
Das Ausgabesichtfeld wird als Polygon-Features zurückgegeben. Das Feld Frequency wird zum Aufnehmen der Anzahl der Beobachtungspunkte verwendet, von denen aus jedes Polygon sichtbar ist. Das Feld DEMResolution wird zum Aufnehmen der Quell-DEM-Auflösung für die Sichtfeldberechnung verwendet.
Es werden drei zusätzliche Felder zurückgegeben, welche die DEM-Datenquelle identifizieren, die in der Berechnung verwendet wird. Es handelt sich um die Felder Product Name, Source und Source URL.
Eine niedrigere DEM-Auflösung führt zu einer schnelleren Antwort des Werkzeugs. Beispielsweise hat die 90 m-Auflösung die kürzeste Antwortzeit. Der Kompromiss besteht darin, dass eine niedrigere DEM-Auflösung eine geringere Genauigkeit im Sichtfeldergebnis im Vergleich zu einer höheren DEM-Auflösung aufweist.
Der Parameter Maximale Entfernung kann sich auch auf die Antwortzeit des Werkzeugs auswirken. Generell führt die Verwendung einer geringeren Entfernung zu einer kürzeren Antwortzeit.
Die maximale Anzahl von Eingabepunkten beträgt 1.000. Wenn mehr als 1.000 Eingabepunkte bereitgestellt werden, gibt das Werkzeug einen Fehler zurück und wird nicht ausgeführt.
Syntax
arcpy.agolservices.Viewshed(InputPoints, {MaximumDistance}, {MaximumDistanceUnits}, {DEMResolution}, {ObserverHeight}, {ObserverHeightUnits}, {SurfaceOffset}, {SurfaceOffsetUnits}, {GeneralizeViewshedPolygons})
Parameter | Erklärung | Datentyp |
InputPoints | Die Punkt-Features, die als Beobachterpositionen verwendet werden sollen. | Feature Set |
MaximumDistance (optional) | Die maximale Entfernung zum Berechnen des Sichtfeldes. | Double |
MaximumDistanceUnits (optional) | Gibt die Einheiten für den Parameter Maximale Entfernung an.
| String |
DEMResolution (optional) |
Gibt die annähernde räumliche Auflösung (Zellengröße) der für die Berechnung verwendeten Quellhöhendaten an. Das Schlagwort "Auflösung" ist eine Approximation der räumlichen Auflösung des digitalen Höhenmodells. Viele Höhenquellen werden in den Einheiten Bogensekunden verteilt, das Schlagwort ist zum besseren Verständnis eine Approximation in Metern.
| String |
ObserverHeight (optional) | Die Höhe über der Oberfläche des Beobachters. Der Standardwert von 1,75 Metern ist die Durchschnittshöhe für eine Person. Verwenden Sie bei einer erhöhten Position, beispielsweise einem Beobachtungsturm oder einem hohen Gebäude, stattdessen die tatsächliche Höhe. | Double |
ObserverHeightUnits (optional) | Gibt die Einheiten für den Parameter Beobachterhöhe an.
| String |
SurfaceOffset (optional) | Die Höhe über der Oberfläche des Objekts, das Sie betrachten. Der Standardwert ist 0. Wenn Sie Gebäude oder Windräder betrachten, verwenden Sie deren Höhe. | Double |
SurfaceOffsetUnits (optional) | Gibt die Einheiten für den Parameter Oberflächenversatz an.
| String |
GeneralizeViewshedPolygons (optional) | Gibt an, ob die Sichtfeld-Polygone generalisiert werden. Die Sichtfeldberechnung basiert auf einem Raster-Höhenmodell, das ein Ergebnis mit stufenförmigen Kanten erstellt. Um ein angenehmeres Aussehen zu erstellen und die Performance zu verbessern, werden die Polygone standardmäßig generalisiert. Diese Generalisierung ändert die Genauigkeit des Ergebnisses für eine beliebige Position nicht um mehr als die Hälfte der DEM-Auflösung.
| Boolean |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
OutputViewshed | Das ausgegebene Sichtfeld. | Feature Set |