Near 3D (3D Analyst)

Zusammenfassung

Berechnet die dreidimensionale Entfernung von jedem Eingabe-Feature zum nächstgelegenen Feature, das sich in einer oder mehreren nahen 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.

Parameter

BeschriftungErläuterungDatentyp
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
Standort
(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.

  • Deaktiviert – Die Koordinaten werden dem Eingabe-Feature nicht hinzugefügt. Dies ist die Standardeinstellung.
  • Aktiviert – Die Koordinaten werden dem Eingabe-Feature hinzugefügt.
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.

  • Deaktiviert – Die Winkel werden der Attributtabelle der Eingabe nicht hinzugefügt. Dies ist die Standardeinstellung.
  • Aktiviert: Der horizontale arithmetische Winkel und der vertikale Winkel werden den Feldern NEAR_ANG_H und NEAR_ANG_V in der Attributtabelle der Eingabe hinzugefügt.
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.

  • Deaktiviert – Der Attributtabelle der Eingabe werden keine Entfernungen hinzugefügt. Dies ist die Standardeinstellung.
  • Aktiviert: Entfernungen entlang der X-, Y-, und Z-Achsen werden in den Feldern NEAR_DELTX, NEAR_DELTY und NEAR_DELTZ berechnet.
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Eingabe-Features

Die aktualisierten Eingabe-Features.

Feature-Layer

arcpy.ddd.Near3D(in_features, near_features, {search_radius}, {location}, {angle}, {delta})
NameErläuterungDatentyp
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.

  • NO_LOCATIONDie Koordinaten werden dem Eingabe-Feature nicht hinzugefügt. Dies ist die Standardeinstellung.
  • LOCATIONDie Koordinaten werden dem Eingabe-Feature hinzugefügt.
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.

  • NO_ANGLEDie Winkel werden der Attributtabelle der Eingabe nicht hinzugefügt. Dies ist die Standardeinstellung.
  • ANGLEDer horizontale arithmetische Winkel und der vertikale Winkel werden den Feldern NEAR_ANG_H und NEAR_ANG_V in der Attributtabelle der Eingabe hinzugefügt.
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.

  • NO_DELTADer Attributtabelle der Eingabe werden keine Entfernungen hinzugefügt. Dies ist die Standardeinstellung.
  • DELTAEntfernungen entlang der X-, Y-, und Z-Achsen werden in den Feldern NEAR_DELTX, NEAR_DELTY und NEAR_DELTZ berechnet.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_feature_class

Die aktualisierten Eingabe-Features.

Feature-Layer

Codebeispiel

Near3D – Beispiel 1 (Python-Fenster)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

arcpy.env.workspace = "C:/data"
arcpy.Near3D_3d("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'"
#Execute 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:
    #Execute Near3D
    arcpy.ddd.Near3D(inFC, 'nearLayer', '', 'LOCATION', 'ANGLE')

Lizenzinformationen

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

Verwandte Themen