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 Ausgabe-Tabelle aufgezeichnet.
Abbildung
 |
Verwendung
-
Das Verhalten dieses Werkzeugs entspricht dem Verhalten des Werkzeugs Near. Anstatt jedoch die Eingabe-Features zu aktualisieren, erstellt es eine neue Ausgabe-Tabelle. Außerdem kann es nach so vielen Near-Features suchen, wie im Parameter Maximale Anzahl der nächstgelegenen Übereinstimmungen angegeben sind.
Die Ausgabe-Tabelle 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.
-
Die Ausgabe-Tabelle kann anhand der Felder INPUT_FID oder NEAR_FID wieder mit der Eingabe-Feature-Class oder einer Near-Feature-Class verknüpft werden.
-
Sowohl Eingabe-Features als auch Near-Features können vom Typ "Punkt", "Multipoint", "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.
-
Falls kein Suchradius angegeben wird, wird ein ausreichend großer Radius verwendet, damit alle Near-Features in die Entfernungsberechnung einbezogen werden können. Wenn der standardmäßige Suchradius verwendet wird (es ist kein Radius angegeben), kann die Ausgabe-Tabelle relativ groß werden. Falls Sie beispielsweise die Entfernungen zwischen 1000 Punkten in einer Feature-Class und 1000 Punkten in einer anderen Feature-Class berechnen, kann die Ausgabe-Tabelle eine Million Datensätze enthalten. 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 sind das Eingabe- und das Near-Feature derselbe Datensatz, wird das Ergebnis übersprungen, da sonst das Ergebnis lautet, dass jedes Feature 0 Einheiten von sich selbst entfernt ist.
Syntax
| 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 |
out_table |
Die Ausgabe-Tabelle enthält Nachbarschaftsinformationen, wie IN_FID, NEAR_FID und NEAR_DIST, und andere Attribute des Near-Features, wie Position (NEAR_X, NEAR_Y) und Winkel (NEAR_ANGLE), sowie bei Bedarf 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. 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.
| 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.
| 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. # Author: ESRI # import system modules import arcpy from arcpy import env # set workspace environment env.workspace = "C:/data/input/gnt.gdb" # set required parameters inFeatures = "campsites" nearFeatures = ["parks", "trails"] outTable = "near_parks_trails" # optional parameters searchRadius = '1500 Meters' location = 'NO_LOCATION' angle = 'NO_ANGLE' closest = 'ALL' closestCount = 3 # find crime locations within the search radius arcpy.GenerateNearTable_analysis(inFeatures, nearFeatures, outTable, searchRadius, location, angle, closest, closestCount)