| Beschriftung | Erläuterung | Datentyp |
Eingabe-Oberfläche | Die Oberfläche des Szenen-Layers mit integrierten Meshes, LAS-Datasets, Rasters, TINs oder Terrains, die bei der 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 die Zielposition identifiziert. Wenn Sichtlinien 2D-Features sind, werden die Beobachter- und Zielhöhen von der Eingabeoberfläche abgeleitet. Wenn Sichtlinien 3D-Features sind, werden die Beobachter- und Zielhöhen anhand der Z-Koordinaten des Features ermittelt. 2D-Linien werden mit einem Versatz von der zugrunde liegenden Oberfläche ausgewertet. Der Standardversatz 1 wird angewendet, um die Punkte über die Oberfläche zu heben. Verwenden Sie das Feld OffsetA, um für den Beobachter eine benutzerdefinierte Versatzhöhe zu definieren. Mit dem Feld OffsetB definieren Sie einen benutzerdefinierten Versatz für das Ziel. | Feature Layer |
Ausgabe-Feature-Class | Die Ausgabe-Line-Feature-Class, entlang der die Sichtbarkeit bestimmt wurde. Zwei Attributfelder werden erstellt. Das Feld VisCode gibt die Sichtbarkeit entlang der Linie an. Dabei steht 1 für "sichtbar" und 2 für "nicht sichtbar". Das Feld TarIsVis gibt die Sichtbarkeit des Zieles an. Dabei steht 0 für "nicht sichtbar" und 1 für "sichtbar". | 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, also volle 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 |
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. Sichtlinien können beispielsweise generiert werden, indem in bestimmten Intervallen Stichproben von einem Ziel-Linien-Feature genommen werden, 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 Attributtabelle des Ausgabe-Linien-Features enthält die folgenden Felder:
- SourceOID: Die eindeutige ID des Linien-Features, das bei der Berechnung der Sichtbarkeit verwendet wurde.
- VisCode: Die Sichtbarkeit entlang der Linie. Der Wert 1 gibt an, dass das Ziel sichtbar ist. Der Wert 2 gibt an, dass das Ziel nicht sichtbar ist. Dieses Feld ist nur vorhanden, wenn es sich bei der Ausgabegeometrie um eine Linie handelt.
- TarIsVis: Die Sichtbarkeit des Ziels entlang der Linie. 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 vorhanden, wenn es sich bei der Ausgabegeometrie um eine Linie handelt.
- OBSTR_MPID: Das Hindernis, das die Sichtbarkeit des Zielpunktes blockiert. Ein gesondertes Linien-Feature wird für die sichtbaren und verdeckten Teile jeder Eingabesichtlinie erstellt. Der nicht verdeckte Teil hat den Wert -9999. Der von einem Multipatch verdeckte Teil erhält die eindeutige ID des blockierenden Features. Der von der Oberfläche verdeckte Teil hat den Wert -1.
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})| Name | Erläuterung | Datentyp |
in_surface | Die Oberfläche des Szenen-Layers mit integrierten Meshes, LAS-Datasets, Rasters, TINs oder Terrains, die bei der 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 die Zielposition identifiziert. Wenn Sichtlinien 2D-Features sind, werden die Beobachter- und Zielhöhen von der Eingabeoberfläche abgeleitet. Wenn Sichtlinien 3D-Features sind, werden die Beobachter- und Zielhöhen anhand der Z-Koordinaten des Features ermittelt. 2D-Linien werden mit einem Versatz von der zugrunde liegenden Oberfläche ausgewertet. Der Standardversatz 1 wird angewendet, um die Punkte über die Oberfläche zu heben. Verwenden Sie das Feld OffsetA, um für den Beobachter eine benutzerdefinierte Versatzhöhe zu definieren. Mit dem Feld OffsetB definieren Sie einen benutzerdefinierten Versatz für das Ziel. | Feature Layer |
out_los_feature_class | Die Ausgabe-Line-Feature-Class, entlang der die Sichtbarkeit bestimmt wurde. Zwei Attributfelder werden erstellt. Das Feld VisCode gibt die Sichtbarkeit entlang der Linie an. Dabei steht 1 für "sichtbar" und 2 für "nicht sichtbar". Das Feld TarIsVis gibt die Sichtbarkeit des Zieles an. Dabei steht 0 für "nicht sichtbar" und 1 für "sichtbar". | 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, also volle 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 |
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)