| Beschriftung | Erläuterung | Datentyp |
Eingabe-Oberfläche | Die Oberfläche des Szenen-Layers mit integrierten Meshes, LAS-Datasets, Rasters, TINs oder Terrains, die zur Bestimmung der Sichtbarkeit verwendet wurde. | TIN Layer; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Scene Layer; File |
Eingabe-Linien-Features | Die Sichtlinien-Features, deren erster Stützpunkt den Beobachtungspunkt definiert und deren letzter Stützpunkt das Beobachtungsziel identifiziert. Wenn es sich bei den Sichtlinien um 2D-Features handelt, werden die Beobachter- und Zielhöhen aus der Eingabeoberfläche abgeleitet. Wenn es sich bei den Sichtlinien um 3D-Features handelt, werden die Beobachter- und Zielhöhen aus den Z-Koordinaten des Features ermittelt. 2D-Linien werden mit einem Versatz zur zugrunde liegenden Oberfläche ausgewertet. Ein Standardversatz von 1 wird angewendet, um die Punkte über die Oberfläche anzuheben. Verwenden Sie ein Feld namens OffsetA, um eine benutzerdefinierte Versatzhöhe für den Beobachter zu definieren; verwenden Sie ein Feld namens OffsetB, um einen benutzerdefinierten Versatz für das Ziel zu definieren. | Feature Layer |
Ausgabe-Feature-Class | Die Ausgabe-Line-Feature-Class, entlang der die Sichtbarkeit bestimmt wird. | Feature Class |
Point-Feature-Class für Ausgabe-Einschränkung (optional) | Eine optionale Point-Feature-Class, die die Position des ersten Hindernisses in der Sichtlinie des Beobachters auf das Ziel angibt. | Feature Class |
Krümmung verwenden (optional) |
Legt fest, ob die Erdkrümmung in der Sichtlinienanalyse berücksichtigt wird. Damit dieser Parameter aktiv ist, muss die Oberfläche über einen definierten Raumbezug in projizierten Koordinaten sowie definierte Z-Einheiten verfügen.
| Boolean |
Brechung verwenden (optional) |
Legt fest, ob die atmosphärische Lichtbrechung berücksichtigt wird, wenn eine Sichtbarkeitslinie aus einer Oberflächenfunktion generiert wird. Dieser Parameter findet keine Anwendung, wenn Multipatch-Features verwendet werden.
| Boolean |
Brechungsfaktor (optional) | Der Wert für den Brechungsfaktor. Der Standardwert ist 0,13. | Double |
Auflösung der Pyramidenebene (optional) | Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0 und entspricht der vollen Auflösung. | Double |
Eingabe-Features (optional) | Ein Multipatch-Feature, das möglicherweise zusätzliche blockierende Elemente definiert, z. B. Gebäude. Brechungsoptionen werden für diese Eingabe nicht berücksichtigt. | Feature Layer |
Ausgabe-Diagrammattribute (optional) | Gibt an, ob die Ausgabe-Sichtlinienattribute zusätzliche Felder mit Informationen enthalten, die in einem Profildiagramm verwendet werden können. Die Werte in diesen Feldern stellen die Informationen für die Erstellung eines Profildiagramms bereit, das eine Repräsentation des Beobachters, eines möglichen Hindernisses und des Zielpunkts jeder Sichtlinie sowie die Sichtbarkeit der direkten Sichtlinie, die den Beobachter mit dem Ziel verbindet, enthält.
| Boolean |
Zusammenfassung
Bestimmt die Sichtbarkeit von Sichtlinien über Hindernissen, die aus einer Oberfläche und einem optionalen Multipatch-Dataset bestehen.
Weitere Informationen zur Funktionsweise von "Sichtbarkeitslinie"
Abbildung
Verwendung
Nur die Endpunkte der Eingabelinie werden zum Definieren von Beobachter und Ziel verwendet. Sichtlinien sollten einfache, gerade Linien aus zwei Stützpunkten sein, die den Beobachtungspunkt und die Zielposition, für die die Sichtbarkeit bestimmt wird, darstellen.
Überlegen Sie, ob es sinnvoll sein kann, Sichtlinien mit dem Werkzeug Sichtlinien konstruieren zu erstellen, falls die Sichtbarkeitsziele sich in einer anderen Feature-Class befinden. Zum Beispiel können Sichtlinien erstellt werden, indem ein Ziel-Linien-Feature in einem bestimmten Intervall abgetastet wird, um die Sichtbarkeit entlang eines Pfades zu testen.
Ausgabelinien werden anhand sichtbarer und unsichtbarer Teile der Eingabesichtlinie getrennt. Wenn die Sichtbarkeit der Sichtlinie nur durch eine Oberfläche bestimmt wird, folgen die Ausgabelinien dem Oberflächenprofil. Wenn bei der Berechnung der Sichtbarkeitslinie ein Multipatch-Feature angegeben wird, folgen die Ausgabelinien dem Verlauf der Eingabesichtlinien.
Die Ausgabe-Line-Feature-Class enthält folgende Felder:
- SourceOID– Die eindeutige ID des Eingabe-Linien-Features, das bei der Berechnung der Sichtbarkeit verwendet wurde.
- VisCode– Gibt an, ob die Ausgabelinie einen sichtbaren oder nicht sichtbaren Teil der Sichtlinie darstellt. Jede Sichtlinie kann möglicherweise in mehrere Features unterteilt werden, je nachdem, ob die Sichtlinie teilweise verdeckt ist. Dieses Attribut gibt den Sichtbarkeitsstatus jedes Teils dieser Sichtlinien an. Der Wert 1 gibt an, dass die Linie sichtbar ist. Der Wert 2 gibt an, dass die Linie nicht sichtbar ist. Dieses Feld ist nur in Ausgabe-Linien-Features vorhanden.
- TarIsVis– Gibt an, ob der Zielpunkt vom Beobachterpunkt aus sichtbar ist. Der Wert 1 gibt an, dass das Ziel sichtbar ist. Der Wert 0 gibt an, dass das Ziel nicht sichtbar ist. Dieses Feld ist nur in Ausgabe-Linien-Features vorhanden.
- OBSTR_MPID– Das Hindernis, das die Sicht auf den Zielpunkt verdeckt. Für die sichtbaren und verdeckten Teile jeder Eingabe-Sichtlinie wird ein separates Linien-Feature erstellt. Der Teil, der nicht verdeckt ist, hat den Wert -9999, der Teil, der durch ein Multipatch verdeckt ist, hat die eindeutige ID des verdeckenden Features, und der Teil, der durch die Oberfläche verdeckt ist, hat den Wert -1.
Wenn der Parameter Ausgabe-Diagrammattribute aktiviert ist, enthält die Ausgabe-Feature-Class die folgenden zusätzlichen Felder:
- OBSERVERZ– Die Höhe des Beobachterpunkts, einschließlich eines eventuell vorgenommenen vertikalen Versatzes.
- TARGETZ– Die Höhe des Zielpunkts, einschließlich eines eventuell vorgenommenen vertikalen Versatzes.
- OBSTR_DIST– Die horizontale Entfernung vom Beobachter zu dem Punkt, der die Sicht auf das Ziel verdeckt. Wenn die Sichtlinie nicht verdeckt ist, beträgt dieser Wert -1,0.
Weitere Informationen über die Erstellung von Profildiagramms
Parameter
arcpy.ddd.LineOfSight(in_surface, in_line_feature_class, out_los_feature_class, {out_obstruction_feature_class}, {use_curvature}, {use_refraction}, {refraction_factor}, {pyramid_level_resolution}, {in_features}, {output_graphing_attributes})| Name | Erläuterung | Datentyp |
in_surface | Die Oberfläche des Szenen-Layers mit integrierten Meshes, LAS-Datasets, Rasters, TINs oder Terrains, die zur Bestimmung der Sichtbarkeit verwendet wurde. | TIN Layer; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Scene Layer; File |
in_line_feature_class | Die Sichtlinien-Features, deren erster Stützpunkt den Beobachtungspunkt definiert und deren letzter Stützpunkt das Beobachtungsziel identifiziert. Wenn es sich bei den Sichtlinien um 2D-Features handelt, werden die Beobachter- und Zielhöhen aus der Eingabeoberfläche abgeleitet. Wenn es sich bei den Sichtlinien um 3D-Features handelt, werden die Beobachter- und Zielhöhen aus den Z-Koordinaten des Features ermittelt. 2D-Linien werden mit einem Versatz zur zugrunde liegenden Oberfläche ausgewertet. Ein Standardversatz von 1 wird angewendet, um die Punkte über die Oberfläche anzuheben. Verwenden Sie ein Feld namens OffsetA, um eine benutzerdefinierte Versatzhöhe für den Beobachter zu definieren; verwenden Sie ein Feld namens OffsetB, um einen benutzerdefinierten Versatz für das Ziel zu definieren. | Feature Layer |
out_los_feature_class | Die Ausgabe-Line-Feature-Class, entlang der die Sichtbarkeit bestimmt wird. | Feature Class |
out_obstruction_feature_class (optional) | Eine optionale Point-Feature-Class, die die Position des ersten Hindernisses in der Sichtlinie des Beobachters auf das Ziel angibt. | Feature Class |
use_curvature (optional) |
Legt fest, ob die Erdkrümmung in der Sichtlinienanalyse berücksichtigt wird. Damit dieser Parameter aktiviert werden kann, muss die Oberfläche über einen definierten Raumbezug in projizierten Koordinaten sowie definierte Z-Einheiten verfügen.
| Boolean |
use_refraction (optional) |
Legt fest, ob die atmosphärische Lichtbrechung berücksichtigt wird, wenn eine Sichtbarkeitslinie aus einer Oberflächenfunktion generiert wird. Dieser Parameter findet keine Anwendung, wenn Multipatch-Features verwendet werden.
| Boolean |
refraction_factor (optional) | Der Wert für den Brechungsfaktor. Der Standardwert ist 0,13. | Double |
pyramid_level_resolution (optional) | Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0 und entspricht der vollen Auflösung. | Double |
in_features (optional) | Ein Multipatch-Feature, das möglicherweise zusätzliche blockierende Elemente definiert, z. B. Gebäude. Brechungsoptionen werden für diese Eingabe nicht berücksichtigt. | Feature Layer |
output_graphing_attributes (optional) | Gibt an, ob die Ausgabe-Sichtlinienattribute zusätzliche Felder mit Informationen enthalten, die in einem Profildiagramm verwendet werden können. Die Werte in diesen Feldern stellen die Informationen für die Erstellung eines Profildiagramms bereit, das eine Repräsentation des Beobachters, eines möglichen Hindernisses und des Zielpunkts jeder Sichtlinie sowie die Sichtbarkeit der direkten Sichtlinie, die den Beobachter mit dem Ziel verbindet, enthält.
| Boolean |
Codebeispiel
Im folgenden Beispiel wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:
arcpy.env.workspace = "C:/data"
arcpy.ddd.LineOfSight("tin", "line.shp", "los.shp", "buldings_multipatch.shp",
"obstruction.shp")Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht:
'''*********************************************************************
Name: Sight Line Visibility of Parade Path
Description: This script demonstrates how to create a sight line feature class
from a pair of observer and target points.
*********************************************************************'''
# Import system modules
import arcpy
# Set Local Variables:
arcpy.env.workspace = 'C:/data'
# Setting up input and output variables:
obs = "observer_pts.shp"
tar = "parade_path.shp"
sightlines = "output_sightlines.shp"
height = "<None>"
join_field = "#"
sampling = 0.5
direction = "OUTPUT_THE_DIRECTION"
surface = 'elevation.tif'
bldgs = 'buildings.shp'
arcpy.ddd.ConstructSightLines(obs, tar, sightlines, height, height,
join_field, sampling, direction)
arcpy.ddd.LineOfSight(surface, sightlines, "Parade_LOS.shp",
"Obstructions.shp", in_features=bldgs)Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst
- Standard: Erfordert 3D Analyst
- Advanced: Erfordert 3D Analyst