Near 3D (3D Analyst Tools)

Zusammenfassung

Berechnet die dreidimensionale Entfernung von jedem Eingabe-Feature zum nächstgelegenen Feature, das sich in einer oder mehreren Near-Feature-Classes befindet.

Verwendung

Alle Eingabe-Features müssen Z-Werte aufweisen, und alle Geometrietypen werden unterstützt. Die Eingabe-Features können auch als Near-Features angegeben werden, um die nächstgelegenen Features in derselben Feature-Class zu bestimmen.
Die folgenden Felder können der Attributtabelle des Eingabe-Features hinzugefügt werden:
- NEAR_FID—Die FID des nächstgelegenen Features. Der Wert -1 gibt an, dass innerhalb des angegebenen Suchradius keine Übereinstimmung gefunden wurde.
- NEAR_DIST—Die 2D-Entfernung (horizontale Entfernung) zwischen dem nächstgelegenen Punkt in einem Eingabe-Feature und dem nächstgelegenen Punkt im nächstgelegenen Feature.
- NEAR_DIST3—Die 3D-Entfernung (Schrägstrecke) zwischen dem nächstgelegenen Punkt in einem Eingabe-Feature und dem nächstgelegenen Punkt im nächstgelegenen Feature.
- NEAR_DELTX—Die Entfernung auf der X-Achse vom nächstgelegenen Punkt im Eingabe-Feature zum nächstgelegenen Punkt im nächstgelegenen Feature.
- NEAR_DELTY—Die Entfernung auf der Y-Achse vom nächstgelegenen Punkt im Eingabe-Feature zum nächstgelegenen Punkt im nächstgelegenen Feature.
- NEAR_DELTZ—Die Entfernung auf der Z-Achse vom nächstgelegenen Punkt im Eingabe-Feature zum nächstgelegenen Punkt im nächstgelegenen Feature.
- NEAR_FROMX—Die X-Koordinate vom nächstgelegenen Punkt im Eingabe-Feature zum nächstgelegenen Feature.
- NEAR_FROMY—Die Y-Koordinate vom nächstgelegenen Punkt im Eingabe-Feature zum nächstgelegenen Feature.
- NEAR_FROMZ—Die Z-Koordinate vom nächstgelegenen Punkt im Eingabe-Feature zum nächstgelegenen Feature.
- NEAR_X—Die X-Koordinate vom nächstgelegenen Punkt im nächstgelegenen Feature.
- NEAR_Y—Die Y-Koordinate vom nächstgelegenen Punkt im nächstgelegenen Feature.
- NEAR_Z—Die Z-Koordinate vom nächstgelegenen Punkt im nächstgelegenen Feature.
- NEAR_ANG_H—Der in Grad angegebene horizontale arithmetische Winkel zum nächstgelegenen Punkt.
- NEAR_ANG_V—Der in Grad angegebene Höhenwinkel zum nächstgelegenen Punkt. Horizontal ist Null, senkrecht nach oben ist 90, senkrecht nach unten ist -90.
- NEAR_FC—Der Pfad der Feature-Class, die das nächstgelegene Feature enthält. Dieses Feld wird nur hinzugefügt, wenn mehrere Near-Features angegeben wurden.
Hinweis:

Wenn die obigen Felder bereits vorhanden sind, werden ihre Werte aktualisiert.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Eingabe-Feature-Class, deren Features die Informationen zum nächsten Feature zugeordnet werden.	Feature Layer
Near-Features	Die Features, deren Nähe zu den Eingabe-Features berechnet wird. Falls mehrere Feature-Classes angegeben sind, wird der Eingabe-Feature-Class ein Zusatzfeld mit dem Namen `NEAR_FC` hinzugefügt, in dem angegeben wird, welche Near-Feature-Class das nächstgelegene Feature enthält.	Feature Layer
Suchradius (Optional)	Die maximale Entfernung, in der die nächstgelegenen Features von einem angegebenen Punkt ermittelt werden. Wenn kein Wert angegeben ist, wird das nächstgelegene Feature mit einer beliebigen Entfernung ermittelt.	Linear Unit
Position (Optional)	Legt fest, ob die Koordinaten des nächstgelegenen Punktes in der Eingabe und im Near-Feature zu der Attributtabelle der Eingabe hinzugefügt werden. Aktiviert—The coordinates are added to the input feature. Deaktiviert—The coordinates are not added to the input feature. This is the default.	Boolean
Winkel (Optional)	Legt fest, ob der horizontale arithmetische Winkel und der vertikale Winkel zwischen dem Eingabe-Feature und dem nächstgelegenen Feature zu der Attributtabelle der Eingabe hinzugefügt werden. Aktiviert—The horizontal arithmetic angle and vertical angle will be added to the `NEAR_ANG_H` and `NEAR_ANG_V` fields in the input's attribute table. Deaktiviert—The angles will not be added to the input's attribute table. This is the default.	Boolean
Delta (Optional)	Legt fest, ob der Attributtabelle der Eingabe die Entfernungen entlang den X-, Y- und Z-Achsen zwischen dem Eingabe-Feature und dem nächstgelegenen Feature hinzugefügt werden. Aktiviert—Distances along the X, Y, and Z axes will be calculated in the `NEAR_DELTX`, `NEAR_DELTY`, and `NEAR_DELTZ` fields. Deaktiviert—No distances will be added to the input attribute table. This is the default.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabe-Features	Die aktualisierten Eingabe-Features.	Feature Layer

arcpy.3d.Near3D(in_features, near_features, {search_radius}, {location}, {angle}, {delta})

Name	Erläuterung	Datentyp
in_features	Die Eingabe-Feature-Class, deren Features die Informationen zum nächsten Feature zugeordnet werden.	Feature Layer
near_features [near_features,...]	Die Features, deren Nähe zu den Eingabe-Features berechnet wird. Falls mehrere Feature-Classes angegeben sind, wird der Eingabe-Feature-Class ein Zusatzfeld mit dem Namen `NEAR_FC` hinzugefügt, in dem angegeben wird, welche Near-Feature-Class das nächstgelegene Feature enthält.	Feature Layer
search_radius (Optional)	Die maximale Entfernung, in der die nächstgelegenen Features von einem angegebenen Punkt ermittelt werden. Wenn kein Wert angegeben ist, wird das nächstgelegene Feature mit einer beliebigen Entfernung ermittelt.	Linear Unit
location (Optional)	Legt fest, ob die Koordinaten des nächstgelegenen Punktes in der Eingabe und im Near-Feature zu der Attributtabelle der Eingabe hinzugefügt werden. `LOCATION`—The coordinates are added to the input feature. `NO_LOCATION`—The coordinates are not added to the input feature. This is the default.	Boolean
angle (Optional)	Legt fest, ob der horizontale arithmetische Winkel und der vertikale Winkel zwischen dem Eingabe-Feature und dem nächstgelegenen Feature zu der Attributtabelle der Eingabe hinzugefügt werden. `ANGLE`—The horizontal arithmetic angle and vertical angle will be added to the `NEAR_ANG_H` and `NEAR_ANG_V` fields in the input's attribute table. `NO_ANGLE`—The angles will not be added to the input's attribute table. This is the default.	Boolean
delta (Optional)	Legt fest, ob der Attributtabelle der Eingabe die Entfernungen entlang den X-, Y- und Z-Achsen zwischen dem Eingabe-Feature und dem nächstgelegenen Feature hinzugefügt werden. `DELTA`—Distances along the X, Y, and Z axes will be calculated in the `NEAR_DELTX`, `NEAR_DELTY`, and `NEAR_DELTZ` fields. `NO_DELTA`—No distances will be added to the input attribute table. This is the default.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_feature_class	Die aktualisierten Eingabe-Features.	Feature Layer

Codebeispiel

Near3D: Beispiel 1 (Python-Fenster)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.Near3D("points_3D.shp", "buildings_multipatch.shp", "30", "LOCATION", "ANGLE", "DELTA")

Near3D: Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht:

'''****************************************************************************
Name: Near 3D Example
Description: This script demonstrates how to use
             the Near 3D tool to identify the nearest z-aware features
             that satisfy the results from a queried feature.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'
# Set Local Variables
inFC = 'homes.shp'
nearFC = 'radiotowers.shp'
# See the 'Building an SQL expression' topic for more information
# Query the field 'MATERIAL' for the string 'Reinforced Concrete'
SQL_Expression = "'"'MATERIAL'"' = 'Reinforced Concrete'"
# Run Make Feature Layer
arcpy.management.MakeFeatureLayer(nearFC, 'Near Layer', SQL_Expression)
result = arcpy.management.GetCount('Near Layer')
if int(result.getOutput(0)) == 0:
    arcpy.AddMessage('{0} has no features that satisfy the query: {1}'\
         .format(nearFC, SQL_Expression))
else:
    # Run Near3D
    arcpy.ddd.Near3D(inFC, 'nearLayer', '', 'LOCATION', 'ANGLE')

Umgebungen

Aktueller Workspace, Ausdehnung

Lizenzierungsinformationen

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

Near 3D (3D Analyst Tools)

Zusammenfassung

Verwendung

Hinweis:

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen