Sichtlinien konstruieren (3D Analyst Tools)

Zusammenfassung

Dient zum Erstellen von Linien-Features, die Sichtlinien von einem oder mehreren Beobachterpunkten zu Features in einer Ziel-Feature-Class darstellen.

Abbildung

Sichtlinien konstruieren

Verwendung

Sichtlinien werden aus dem Umfang von Ziellinien und -polygonen ermittelt und sind von dem im Parameter Abtastschrittweite angegebenen Wert abhängig. Die Einheiten unter Abtastschrittweite sollten in den XY-Einheiten der Ausgabe-Feature-Class angegeben werden.
Ein Join-Feld wird verwendet, um ein oder mehrere Ziele für einen bestimmten Beobachter anzugeben. Wenn kein Join-Feld verwendet wird, werden alle Punkte mit allen Zielen verbunden.
Es wird eine dreidimensionale Ausgabe generiert, wenn sowohl für Beobachter- als auch Ziel-Features eine Quelle für das Höhenmaß angegeben wird. Als Standard für die Quelle des Höhenmaßes der Beobachter- und Ziel-Features wird der Feldname verwendet, der als erstes in dieser Liste gefunden wird:
1. Shape.Z (nur verfügbar für Features, die Z-aktiviert sind)
2. Spot
3. Z
4. Z_Value
5. Height
6. Elev
7. Elevation
8. Contour
Wenn kein geeignetes Höhenfeld vorhanden ist, wird standardmäßig das Schlüsselwort <None> verwendet, um anzugeben, dass die Features keine Z-Werte haben.
Wenn das gewünschte Höhenfeld in der Standard-Feldauswahl keine höhere Priorität hat, muss das gewünschte Feld explizit angegeben werden. Wenn kein Höhenfeld benötigt wird, die Feature-Class jedoch eines der Felder in der Standard-Auswahlliste enthält, muss außerdem das Schlüsselwort <None> verwendet werden.
Der Ausgabe-Feature-Class, die die Sichtlinien enthält, werden die folgenden Felder hinzugefügt:
- OID_OBSERV—Die OID des Beobachterpunkts
- OID_TARGET—Die OID des Ziel-Features
- DIST_ALONG—Die Entfernung entlang des Ziel-Features, wenn es sich um eine Linie oder ein Polygon handelt.
Wenn der Parameter Richtung ausgeben aktiviert ist, verfügen die ausgegebenen Sichtlinien über zwei zusätzliche Attributfelder:
- AZIMUTH—Grad von genau Norden, wobei die Werte im Uhrzeigersinn zunehmen
- VERT_ANGLE—Vertikaler Winkel in Grad vom Horizont, wobei sich 90° direkt über und -90° direkt unter dem Horizont befindet. Der vertikale Winkel ist nur relevant, wenn ein Höhenfeld angegeben wird.

Beschriftung	Erläuterung	Datentyp
Beobachterpunkte	Die einzelnen Punkt-Features, die Beobachterpunkte darstellen. Multipoint-Features werden nicht unterstützt.	Feature Layer
Ziel-Features	Die Ziel-Features (Punkte, Multipoints, Linien und Polygone).	Feature Layer
Ausgabe	Die Ausgabe-Feature-Class, die die Sichtlinien enthält.	Feature Class
Beobachterhöhenfeld (Optional)	Die Quelle der Höhenwerte für die aus der Attributtabelle abgerufenen Beobachterpunkte. Ein Standard-Beobachterhöhenfeld wird aus den unten aufgeführten Optionen nach Priorität ausgewählt. Wenn mehrere Felder vorhanden sind und das gewünschte Feld in der Standard-Feldauswahl keine höhere Priorität hat, muss das gewünschte Feld angegeben werden. No Height Source—No Z values will be assigned to the resulting sight line features.	String
Zielhöhenfeld (Optional)	Das Höhenfeld für das Ziel. Ein Standard-Zielhöhenfeld wird aus den unten aufgeführten Optionen nach Priorität ausgewählt. Wenn mehrere Felder vorhanden sind und das gewünschte Feld in der Standard-Feldauswahl keine höhere Priorität hat, muss das gewünschte Feld angegeben werden. No Height Source—No Z values will be assigned to the resulting sight line features.	String
Feld verbinden (Optional)	Das Join-Feld wird verwendet, um Beobachter mit bestimmten Zielen zu vergleichen. No Join Field—No Z values will be assigned to the resulting sight line features.	String
Abtastschrittweite (Optional)	Die Entfernung zwischen Beispielen, wenn das Ziel entweder eine Line- oder Polygon-Feature-Class ist. Die Einheiten für Abtastschrittweite werden in den XY-Einheiten der Ausgabe-Feature-Class interpretiert.	Double
Richtung ausgeben (Optional)	Gibt an, ob Richtungsattribute zu den ausgegebenen Sichtlinien hinzugefügt werden. Zwei zusätzliche Felder werden hinzugefügt und ausgefüllt, um die Richtung anzugeben: `AZIMUTH` und `VERT_ANGLE` (vertikaler Winkel). Aktiviert—Two additional fields will be added and populated to indicate direction: `AZIMUTH` and `VERT_ANGLE` (vertical angle). Deaktiviert—No direction attributes will be added to the output sight lines. This is the default.	Boolean
Stichprobenmethode (Optional)	Gibt an, wie die Abtastschrittweite zum Einrichten von Sichtlinien entlang des Ziel-Features verwendet wird. 2D distance—The distance will be evaluated in two-dimensional Cartesian space. This is the default. 3D distance—The distance will be evaluated in three-dimensional length.	String

arcpy.3d.ConstructSightLines(in_observer_points, in_target_features, out_line_feature_class, {observer_height_field}, {target_height_field}, {join_field}, {sample_distance}, {output_the_direction}, {sampling_method})

Name	Erläuterung	Datentyp
in_observer_points	Die einzelnen Punkt-Features, die Beobachterpunkte darstellen. Multipoint-Features werden nicht unterstützt.	Feature Layer
in_target_features	Die Ziel-Features (Punkte, Multipoints, Linien und Polygone).	Feature Layer
out_line_feature_class	Die Ausgabe-Feature-Class, die die Sichtlinien enthält.	Feature Class
observer_height_field (Optional)	Die Quelle der Höhenwerte für die aus der Attributtabelle abgerufenen Beobachterpunkte. Ein Standard-Beobachterhöhenfeld wird aus den unten aufgeführten Optionen nach Priorität ausgewählt. Wenn mehrere Felder vorhanden sind und das gewünschte Feld in der Standard-Feldauswahl keine höhere Priorität hat, muss das gewünschte Feld angegeben werden. `Shape.Z` `Spot` `Z` `Z_Value` `Height` `Elev` `Elevation` `Contour` `<None>`—No Z values will be assigned to the resulting sight line features.	String
target_height_field (Optional)	Das Höhenfeld für das Ziel. Ein Standard-Zielhöhenfeld wird aus den unten aufgeführten Optionen nach Priorität ausgewählt. Wenn mehrere Felder vorhanden sind und das gewünschte Feld in der Standard-Feldauswahl keine höhere Priorität hat, muss das gewünschte Feld angegeben werden. `Shape.Z` `Spot` `Z` `Z_Value` `Height` `Elev` `Elevation` `Contour` `<None>`—No Z values will be assigned to the resulting sight line features.	String
join_field (Optional)	Das Join-Feld wird verwendet, um Beobachter mit bestimmten Zielen zu vergleichen. `<None>`—No Z values will be assigned to the resulting sight line features.	String
sample_distance (Optional)	Die Entfernung zwischen Beispielen, wenn das Ziel entweder eine Line- oder Polygon-Feature-Class ist. Die Einheiten für Abtastschrittweite werden in den XY-Einheiten der Ausgabe-Feature-Class interpretiert.	Double
output_the_direction (Optional)	Gibt an, ob Richtungsattribute zu den ausgegebenen Sichtlinien hinzugefügt werden. Zwei zusätzliche Felder werden hinzugefügt und ausgefüllt, um die Richtung anzugeben: `AZIMUTH` und `VERT_ANGLE` (vertikaler Winkel). `OUTPUT_THE_DIRECTION`—Two additional fields will be added and populated to indicate direction: `AZIMUTH` and `VERT_ANGLE` (vertical angle). `NOT_OUTPUT_THE_DIRECTION`—No direction attributes will be added to the output sight lines. This is the default.	Boolean
sampling_method (Optional)	Gibt an, wie die Abtastschrittweite zum Einrichten von Sichtlinien entlang des Ziel-Features verwendet wird. `2D_DISTANCE`—The distance will be evaluated in two-dimensional Cartesian space. This is the default. `3D_DISTANCE`—The distance will be evaluated in three-dimensional length.	String

Codebeispiel

ConstructSightLines: Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:

arcpy.env.workspace = 'C:/data'
arcpy.ddd.ConstructSightLines('observer_pt.shp', 'target.shp', 'sightlines.shp', 'BASEHEIGHT', 'TOP_HEIGHT', 'NAME', "1", "OUTPUT_THE_DIRECTION")

ConstructSightLines: Beispiel 2 (eigenständiges Skript)

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

Aktueller Workspace, Ausdehnung, Ausgabe-Koordinatensystem, Geographische Transformationen, XY-Auflösung, XY-Toleranz, Ausgabe-XY-Domäne, Z-Auflösung, Z-Toleranz, Ausgabe-Z-Domäne, Ausgabe-CONFIG-Schlüsselwort, Auto-Commit

Lizenzierungsinformationen

Basic: Erfordert 3D Analyst
Standard: Erfordert 3D Analyst
Advanced: Erfordert 3D Analyst