Near-Tabelle erstellen (Analyse)
Zusammenfassung
Dieses Werkzeug ermittelt innerhalb des Suchradius die Entfernungen der einzelnen Features der Eingabe-Features zu einem oder mehreren Features der Near-Features. Die Ergebnisse werden in der Ausgabetabelle aufgezeichnet.
Weitere Informationen zum Berechnen der Nähe mit Geoverarbeitungswerkzeugen
Bild
 |
Verwendung
-
Das Verhalten dieses Werkzeugs entspricht dem Verhalten des Werkzeugs Near. Anstatt jedoch die Eingabe-Features zu aktualisieren, erstellt es eine neue Ausgabetabelle. Außerdem kann es nach so vielen Near-Features suchen, wie im Parameter Maximale Anzahl der nächstgelegenen Übereinstimmungen angegeben sind.
Die Ausgabetabelle enthält standardmäßig die drei Felder IN_FID, NEAR_FID und NEAR_DIST. Der Ausgabe werden je nach den ausgewählten optionalen Parametern, wie im Parametereintrag erläutert, zusätzliche Felder hinzugefügt.
- IN_FID – Speichert die Feature-ID des Eingabe-Features.
- NEAR_FID – Dient zum Speichern der Feature-ID des nächstgelegenen Features.
- NEAR_DIST – Dient zum Speichern des Abstands von einem Eingabe-Feature zum nächstgelegenen Feature. Der Wert dieses Feldes ist in der linearen Einheit des Koordinatensystems des Eingabe-Features angegeben.
-
Die Ausgabetabelle kann anhand der Felder "IN_FID" oder "NEAR_FID" wieder mit der Eingabe-Feature-Class oder einer Near-Feature-Class verknüpft werden.
-
Eingabe-Features und Near-Features können vom Typ "Punkt", "Multipunkt", "Linie" oder "Polygon" sein.
-
In der Standardoption dieses Werkzeugs wird die Entfernung von jedem Eingabe-Feature zum nächsten Near-Feature ermittelt. Wählen Sie die Option "ALL" aus, indem Sie den Parameter Nur nächstgelegenes Feature suchen deaktivieren, um eine Tabelle mit den Entfernungen von allen Eingabe-Features zu allen Near-Features zu erstellen.
-
Der Wert für NEAR_FID und NEAR_DIST ist -1, falls innerhalb des Suchradius kein Feature gefunden wird.
-
Wenn kein Wert für Suchradius angegeben wird, wird ein Radius verwendet, der groß genug ist, dass alle Near-Features in die Entfernungsberechnung integriert werden können. Wenn der standardmäßige Suchradius verwendet wird (es ist kein Radius angegeben), kann die Ausgabetabelle relativ groß werden. Wenn Sie beispielsweise die Entfernungen zwischen 1000 Punkten in einer Feature-Class und 1000 Punkten in einer anderen Feature-Class berechnen, enthält die Ausgabetabelle 1 Million Datensätze. Verwenden Sie den Suchradius, um die Anzahl an Ausgabedatensätzen zu reduzieren.
-
Eingabe-Features und Near-Features können aus demselben Dataset stammen. Ist dies der Fall und handelt es sich bei dem Eingabe- und dem Near-Feature um denselben Datensatz, wird das Ergebnis übersprungen, da sonst das Ergebnis lautet, dass jedes Feature 0 Einheiten von sich selbst entfernt ist.
Die Eingabe-Features können ein Layer sein, auf dem Sie eine Auswahl durchgeführt haben. Die selektierten Features werden beim Ausführen des Werkzeugs verwendet und aktualisiert. Die verbleibenden Features haben die Werte der auf -1 festgelegten neu erstellten Felder (z. B. NEAR_FID und NEAR_DIST).
Die von diesem Werkzeug berechneten Entfernungen sind in der Einheit des Koordinatensystems der Eingabe-Features angegeben. Wenn die Eingabe in einem geographischen Koordinatensystem ist und die Ausgabeentfernungen in einer linearen Einheit (im Gegensatz zu Dezimalgrad) gemessen werden sollen, müssen Sie zunächst die Eingabe mit dem Werkzeug "Projizieren" in ein projiziertes Koordinatensystem projizieren. Verwenden Sie für beste Ergebnisse eine äquidistante Projektion oder eine für das Untersuchungsgebiet geeignete Projektion (z. B. UTM).
Syntax
| Parameter | Erläuterung | Datentyp |
in_features |
Die Eingabe-Features können vom Typ "Punkt", "Polylinie, "Polygon" oder "Multipoint" sein. | Feature Layer |
near_features [near_features,...] |
Wert, der verwendet wurde, um die nächsten Features von Eingabe-Features zu suchen. 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 Eingabetabelle ein neues Feld NEAR_FC hinzugefügt, um die Pfade der Quell-Feature-Class mit den nächstgelegenen Features zu speichern. | Feature Layer |
out_table |
Die Ausgabetabelle enthält Nachbarschaftsinformationen wie IN_FID, NEAR_FID und NEAR_DIST und bei Bedarf weitere Attribute wie Position (NEAR_X, NEAR_Y) und Winkel (NEAR_ANGLE) des nächstgelegenen Features sowie NEAR_FC. | Table |
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. Als Suchradiuseinheit werden standardmäßig die Einheiten des Koordinatensystems der Eingabe-Features verwendet. Die Einheiten können in jede beliebige Einheit geändert werden. Dies hat jedoch keine Auswirkungen auf die Einheiten des Ausgabefeldes NEAR_DIST, die von den Einheiten des Koordinatensystems der Eingabe-Features abhängen. | 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.
| 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 dem nächsten Feature an den nächstgelegenen Positionen verbindet. Der Dezimalgradbereich beträgt 0 bis 180 bzw. 0 bis -180: 0 nach Osten, 90 nach Norden, 180 (-180°) nach Westen und -90 nach Süden.
| Boolean |
closest (optional) |
Gibt an, ob nur die nächstgelegenen Features oder alle Features im Suchradius gesucht und zurückgegeben werden.
| Boolean |
closest_count (optional) |
Es wird nur die angegebene Anzahl an nächstgelegenen Features gesucht. Dieser Parameter wird nicht verwendet, wenn die Option Nur nächstgelegenes Feature suchen aktiviert ist. | Long |
Codebeispiel
Der folgende Codeausschnitt veranschaulicht, wie Sie die Funktion "GenerateNearTable" im Python-Fenster verwenden.
import arcpy
arcpy.env.workspace = "C:/data/input/gnt.gdb"
arcpy.GenerateNearTable_analysis("campsites", ["parks", "trails"], "better_sites")
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion "GenerateNearTable" in einem eigenständigen Skript verwenden.
# 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
try:
# find crime locations within the search radius
arcpy.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius,
location, angle, closest, closest_count)
except:
print arcpy.GetMessages()