Near (Analyse)

Zusammenfassung

Hiermit wird innerhalb des Suchradius die Entfernung jedes einzelnen Features in den Eingabe-Features zum nächstgelegenen Feature in den Near-Features berechnet.

Abbildung

Verwendung

• Die folgenden beiden Felder werden der Attributtabelle der Eingabe-Features hinzugefügt. Die Feldwerte werden aktualisiert, falls die Felder bereits vorhanden sind.

  • NEAR_FID: Speichern der Feature-ID des nächstgelegenen Features.
  • NEAR_DIST: Speichern des Abstands von einem Eingabe-Feature zum nächstgelegenen Feature.

• Der Wert für NEAR_FID und NEAR_DIST ist -1, falls innerhalb des Suchradius kein Feature gefunden wird.

• Optional können der Attributtabelle von Eingabe-Features auch die Felder NEAR_X, NEAR_Y, NEAR_ANGLE und NEAR_FC hinzugefügt werden, wie in den Einträgen zu Near-Features und optionalen Parametern erklärt. Der Wert eines Felds wird aktualisiert, falls eines der Felder bereits vorhanden ist. Wenn innerhalb des Suchradius kein Feature gefunden wird, betragen die Werte dieser Felder -1 für NEAR_X und NEAR_Y, 0 für NEAR_ANGLE und NULL für NEAR_FC.

• Sowohl Eingabe-Features als auch Near-Features können vom Typ "Punkt", "Multipoint", "Linie" oder "Polygon" sein.

• Die Near-Features können eine oder mehrere Feature-Classes mit unterschiedlichen Shape-Typen umfassen.

• Dasselbe Dataset kann sowohl für Eingabe-Features als auch für Near-Features verwendet werden. Wenn das nächstgelegene Feature eines Eingabe-Features das Feature selbst ist (NEAR_DIST ist 0), wird dieses Feature bei der Berechnung ignoriert, und es wird nach dem nächsten nächstgelegenen Feature gesucht.

Syntax

Near_analysis (in_features, near_features, {search_radius}, {location}, {angle})

Parameter	Erläuterung	Datentyp
in_features	Die Eingabe-Features, die vom Typ "Punkt", "Polylinie, "Polygon" oder "Multipoint" sein können.	Feature Layer
near_features [near_features,...]	Dies sind die Near-Features, mit denen nach den Features gesucht wird, die den Eingabe-Features am nächsten liegen. Es können einer oder mehrere Near-Features-Einträge vorhanden sein. Jeder Eintrag kann vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein. Falls mehrere Near-Features-Einträge angegeben werden, wird der Eingabe-Tabelle ein neues Feld NEAR_FC hinzugefügt, um die Pfade der Quell-Feature-Class mit den nächstgelegenen Features zu speichern.	Feature Layer
search_radius (optional)	Gibt den Radius an, der zum Suchen nach Near-Feature-Kandidaten verwendet wird. Die Near-Features innerhalb dieses Radius werden in die Berechnung des nächstgelegenen Features einbezogen. Wenn kein Wert angegeben wird, also der Standardradius (leer) verwendet wird, werden alle Near-Features in die Berechnung einbezogen. Sie können jede beliebige Entfernungseinheit angeben, indem Sie die Standardeinheit der Eingabe-Features ersetzen.	Linear unit
location (optional)	Gibt an, ob X- und Y-Koordinaten der nächstgelegenen Position des Near-Features in die neuen Felder NEAR_X und NEAR_Y geschrieben werden. NO_LOCATION —Gibt an, dass die X- und Y-Koordinaten der nächstgelegenen Position nicht geschrieben werden. Dies ist die Standardeinstellung. LOCATION —Gibt an, dass die X- und Y-Koordinaten der nächstgelegenen Position in die Felder NEAR_X und NEAR_Y geschrieben werden.	Boolean
angle (optional)	Gibt an, ob die Werte der nächstgelegenen Winkel in Dezimalgrad berechnet und in ein neues Feld (NEAR_ANGLE) geschrieben werden. Ein nächstgelegener Winkel wird von der X-Achse (horizontale Achse) in Richtung der Linie gemessen, die ein Eingabe-Feature mit seinem nächsten Feature an den nächstgelegenen Positionen verbindet. Der Dezimalgradbereich beträgt 0 bis 180 bzw. 0 bis -180. NO_ANGLE —Gibt an, dass die Werte des nächstgelegenen Winkels nicht geschrieben werden. Dies ist die Standardeinstellung. ANGLE —Gibt an, dass die Werte des nächstgelegenen Winkels in das Feld NEAR_ANGLE geschrieben werden.	Boolean

Codebeispiel

Near – Beispiel 1 (Python-Fenster)

Das folgende Skript für das interaktive Python-Fenster veranschaulicht, wie Sie die Funktion "Near" im unmittelbaren Modus verwenden.

import arcpy
arcpy.env.workspace = "C:/data/city.gdb" 

## find the nearest road from each house
arcpy.Near_analysis('houses', 'roads')

Near – Beispiel 2 (eigenständiges Python-Skript)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion "Near" in einem eigenständigen Skript verwenden.

# Name: Near.py
# Description: Finds nearest features from input feature class to near feature class.
# Author: ESRI

import arcpy
from arcpy import env

# Set workspace environment
env.workspace = "C:/data/city.gdb"

# set local variables
inFeatures = "houses"
nearFeatures = "parks"

# find features only within search radius
searchRadius = "5000 Meters"

# find location & angle of nearest features
location = "true"
angle = "true"

# execute the function
arcpy.Near_analysis(inFeatures, nearFeatures, searchRadius, location, angle)

Umgebungen

Ausdehnung, Aktueller Workspace

Lizenzinformationen

ArcView: Nein

ArcEditor: Nein

ArcInfo: Ja