Zusammenfassung
Berechnet die Entfernung und andere Nachbarschaftsinformationen zwischen Features in einer oder mehreren Feature-Classes oder Layern. Im Gegensatz zum Werkzeug Near, bei dem die Eingabe modifiziert wird, schreibt Near-Tabelle erstellen Ergebnisse in eine neue Standalone-Tabelle und unterstützt die Suche von mehr als einem Near-Feature.
Weitere Informationen zum Berechnen der Nähe mit Geoverarbeitungswerkzeugen
Abbildung
![Near-Tabelle erstellen (Werkzeugbild) Near-Tabelle erstellen (Werkzeugbild)](GUID-4C997050-8F1C-405C-80AB-D29EDDAD99E5-web.png)
Verwendung
Die Ausgabetabelle enthält die folgenden Felder:
- IN_FID: Die ObjectID des Eingabe-Features.
- NEAR_FID: Die ObjectID des nächstgelegenen Features.
- NEAR_DIST: Die Entfernung vom Eingabe-Feature zum Near-Feature. Der Wert dieses Feldes wird in der linearen Einheit des Koordinatensystems des Eingabe-Features oder in Metern angegeben, wenn für den Parameter Methode der Wert Geodätisch festgelegt wurde und die Eingabe in einem geographischen Koordinatensystem vorliegt.
- NEAR_FC: Der Katalogpfad zur Feature-Class mit dem Near-Feature. Dieses Feld wird nur dann zur Ausgabetabelle hinzugefügt, wenn mehrere Near-Features angegeben wurden.
- NEAR_RANK: Ein Ganzzahlwert, nach dem alle Near-Features abhängig von ihrer Nähe zu einem bestimmten Eingabe-Feature sortiert werden. Das nächstgelegene Feature erhält den -Wert 1, das zweitnächstgelegene den -Wert 2 usw.
Die folgenden Felder werden der Ausgabetabelle hinzugefügt, wenn der Parameter Position aktiviert ist (für den location-Parameter wurde in Python LOCATION festgelegt). Die Einheit für die Werte der Felder ist von der im Parameter Methode verwendeten Methode abhängig. Bei Verwendung von Planar ist die Werteinheit die lineare Einheit des Koordinatensystems des Eingabe-Features. Bei Verwendung von Geodätisch ist die Werteinheit das geographische Koordinatensystem, das mit dem Koordinatensystem des Eingabe-Features verknüpft ist.
- FROM_X: Die X-Koordinate der Position im Eingabe-Feature, das dem Near-Feature am nächsten liegt
- FROM_Y: Die Y-Koordinate der Position im Eingabe-Feature, das dem Near-Feature am nächsten liegt
- NEAR_X: Die X-Koordinate der Position im Near-Feature, das dem Eingabe-Feature am nächsten liegt
- NEAR_Y: Die Y-Koordinate der Position im Near-Feature, das dem Eingabe-Feature am nächsten liegt
Das folgende Feld wird der Ausgabetabelle hinzugefügt, wenn der Parameter Winkel aktiviert ist (für den angle-Parameter wurde in Python ANGLE festgelegt).
- NEAR_ANGLEDer Winkel der Linie an der FROM_X- und FROM_Y-Position, die die Eingabe-Features mit dem Near-Feature verbindet.
Wenn die Eingabe und das Near-Feature sich schneiden, werden die folgenden Werte in die Ausgabetabelle geschrieben:
- NEAR_ANGLE und NEAR_DIST wird auf 0,0 festgelegt.
- FROM_X und FROM_Y sind identisch mit NEAR_X und NEAR_Y und entsprechen einer Position im Schnittpunkt der zwei Features.
Die Werte im NEAR_DIST-Feld sind in der linearen Einheit des Koordinatensystems des Eingabe-Features angegeben. Wenn sich die Eingabe in einem geographischen Koordinatensystem befindet und für den Parameter Methode der Wert Geodesic festgelegt wurde, sind die Einheiten des Feldes NEAR_DIST Meter.
Die Ausgabetabelle kann anhand des IN_FID-Felds wieder mit den Eingabe-Features oder mithilfe des NEAR_FID-Felds mit den Near-Features verknüpft werden.
Wenn der Parameter Suchradius angegeben ist und kein Near-Feature gefunden wurde, wird kein Datensatz ausgegeben.
Falls der Parameter Suchradius nicht angegeben wurde, werden alle Near-Features als Kandidaten betrachtet.
Wenn der Parameter Suchradius nicht angegeben wurde, der Parameter Nur nächstgelegene Features suchen nicht aktiviert ist und für den Parameter Maximale Anzahl der nächstgelegenen Übereinstimmungen der Standardwert (0 oder leer) festgelegt wurde, enthält die Ausgabetabelle Entfernungsberechnungen zwischen allen Eingabe-Features und allen Near-Features. Dieser Prozess kann viel Zeit in Anspruch nehmen und eine große Ausgabetabelle erzeugen. Wenn es beispielsweise 1.000 Eingabe-Features und 1.000 Near-Features gibt, enthält die Ausgabetabelle 1.000.000 Datensätze.
Eine Feature-Class oder ein Layer kann sowohl als Eingabe-Feature als auch als Near-Feature verwendet werden. In diesem Fall wird das ausgewertete Eingabe-Feature aus den Near-Feature-Kandidaten ausgeschlossen, um zu vermeiden, dass alle Features jeweils das nächstgelegene Feature für sich selbst darstellen.
Bei Verwendung der Option Planar für den Parameter Methode sollten Sie für die Eingabe-Features eine Projektion verwenden, die für den Entfernungsmesswert geeignet ist, z. B. eine äquidistante Projektion.
Weitere Informationen zu geographischen und projizierten Koordinatensystemen
Um die Feldwerte FROM_X, FROM_Y, NEAR_X und NEAR_Y zu visualisieren, kann die Ausgabetabelle als Eingabe für das Werkzeug XY-Ereignis-Layer erstellen oder XY in Linie verwendet werden.
Syntax
arcpy.analysis.GenerateNearTable(in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count}, {method})
Parameter | Erklärung | Datentyp |
in_features | Die Eingabe-Features können vom Typ "Punkt", "Polylinie, "Polygon" oder "Multipoint" sein. | Feature Layer |
near_features [near_features,...] | Ein oder mehrere Layer von Feature-Classes mit Near-Feature-Kandidaten. Die Near-Features können vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein. Wenn mehrere Layer oder Feature-Classes angegeben werden, wird der Eingabetabelle das Feld NEAR_FC hinzugefügt. Darin werden die Pfade der Quell-Feature-Class mit dem nächstgelegenen Feature gespeichert. Eine Feature-Class oder ein Layer kann sowohl als Eingabe-Feature als auch als Near-Feature verwendet werden. | Feature Layer |
out_table |
Die Ausgabetabelle mit dem Ergebnis der Analyse. | Table |
search_radius (optional) | Der zum Suchen nach Near-Features verwendete Radius. Wenn kein Wert angegeben wurde, sind alle Near-Features Kandidaten. Wenn eine Entfernung eingegeben wurde, jedoch keine Einheit oder "Unbekannt" angegeben wurde, werden die Einheiten des Koordinatensystems der Eingabe-Features verwendet. Bei Verwendung der Option GEODESIC für den Parameter method ist eine lineare Einheit wie Kilometer oder Meilen zu verwenden. | Linear Unit |
location (optional) | Gibt an, ob X- und Y-Koordinaten der Position des Eingabe-Features und die nächstgelegene Position des Near-Features in die Felder FROM_X, FROM_Y, NEAR_X und NEAR_Y geschrieben werden.
| Boolean |
angle (optional) | Gibt an, ob der nächstgelegene Winkel berechnet und in das Feld NEAR_ANGLE der Ausgabetabelle geschrieben wird. Der nächstgelegene Winkel misst die Richtung der Linie, die ein Eingabe-Feature mit dem diesem zunächst liegenden Feature an der nächstgelegenen Position verbindet. Bei Verwendung der Methode PLANAR für den Parameter method liegt der Winkel im Bereich -180° bis 180°, wobei 0° Osten, 90° Norden, 180° (oder -180°) Westen und -90° Süden bedeutet. Bei Verwendung der GEODESIC-Methode für den Parameter method liegt der Winkel im Bereich -180° bis 180°, wobei 0° Norden, 90° Osten, 180° (oder -180°) Süden und -90° Westen bedeutet.
| Boolean |
closest (optional) | Gibt an, ob nur das nächstgelegene Feature in die Ausgabetabelle geschrieben wird.
| Boolean |
closest_count (optional) | Begrenzt die Anzahl der Near-Features, die für jedes Eingabe-Feature angegeben werden. Dieser Parameter wird ignoriert, wenn für den closest-Parameter CLOSEST angegeben ist. | Long |
method (optional) | Gibt an, ob die kürzeste Route auf einem Sphäroiden (geodätisch) oder die Entfernung auf einer Ebene (planar) verwendet werden soll. Es wird dringend empfohlen, für Daten, die in einem nicht für Entfernungsmesswerte geeigneten Koordinatensystem (z. B. Web Mercator und geographische Koordinatensysteme) gespeichert sind, sowie für ein Dataset, das einen großen geographischen Bereich umfasst, die Methode GEODESIC zu verwenden.
| String |
Codebeispiel
GenerateNearTable – Beispiel 1 (Python-Fenster)
Im Folgenden wird veranschaulicht, wie die Funktion GenerateNearTable im Python-Fenster verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data/input/gnt.gdb"
arcpy.GenerateNearTable_analysis("campsites", ["parks", "trails"], "better_sites")
GenerateNearTable – Beispiel 2 (eigenständiges Skript)
Das folgende Python-Skript veranschaulicht, wie die Funktion GenerateNearTable in einem eigenständigen Skript verwendet wird.
# Name: GenerateNearTable.py
# Description: Finds 3 nearest in the near feature class from the input feature class.
# import system modules
import arcpy
# set workspace environment
arcpy.env.workspace = "C:/data/input/gnt.gdb"
# set required parameters
in_features = "campsites"
near_features = ["parks", "trails"]
out_table = "near_parks_trails"
# optional parameters
search_radius = '1500 Meters'
location = 'NO_LOCATION'
angle = 'NO_ANGLE'
closest = 'ALL'
closest_count = 3
# find crime locations within the search radius
arcpy.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius,
location, angle, closest, closest_count)
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Nein
- Advanced: Ja