Zusammenfassung
Bestimmt innerhalb eines angegebenen Suchradius die Entfernungen von den Eingabe-Punkt-Features zu allen Punkten der Near-Features.
Abbildung
Verwendung
Das Werkzeug erstellt zwischen zwei Sätzen von Punkten eine Tabelle mit Entfernungen. Wenn der Standardsuchradius verwendet wird, werden die Entfernungen zwischen allen Eingabepunkten und allen nahen Punkten berechnet. Die Ausgabetabelle kann sehr groß werden. Wenn beispielsweise sowohl die Eingabe- als auch die Near-Features über jeweils 1.000 Punkte verfügen, kann die Ausgabetabelle eine Million Datensätze enthalten.
Verwenden Sie einen sinnvollen Suchradius, um die Größe der Ausgabe zu begrenzen und die Performance des Werkzeugs zu verbessern. Die Ausgabetabelle enthält nur jene Datensätze, die über einen nächstgelegenen Punkt innerhalb des Suchradius verfügen.
Die Ergebnisse werden in der Ausgabetabelle mit folgenden Informationen erfasst:
- INPUT_FID: Die Feature-ID der Eingabe-Features
- NEAR_FID: Die Feature-ID der Near-Features
- DISTANCE: Die Entfernung vom Eingabe-Feature zum Near-Feature Der Wert dieses Feldes ist in der linearen Einheit des Koordinatensystems des Eingabe-Features angegeben.
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.
Syntax
arcpy.analysis.PointDistance(in_features, near_features, out_table, {search_radius})| Parameter | Erklärung | Datentyp |
in_features | Die Punkt-Features, für die Entfernungen zu den Near-Features berechnet werden. | Feature Layer |
near_features | Die Punkte, zu denen Entfernungen von den Eingabe-Features berechnet werden. Die Abstände zwischen Punkten derselben Feature-Class oder desselben Feature-Layers können berechnet werden, indem dieselbe Feature-Class bzw. derselbe Feature-Layer sowohl für die Eingabe- als auch für die Near-Features angegeben wird. | Feature Layer |
out_table | Die Tabelle mit der Liste der Eingabe-Features und Informationen zu allen Near-Features im Suchradius. Falls kein Suchradius angegeben wird, werden die Entfernungen von allen Eingabe-Features zu allen Near-Features berechnet. | 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 (d. h. der Standardradius (leer) verwendet wird), werden alle Near-Features in die Berechnung einbezogen. Die Einheit des Suchradius verwendet standardmäßig die Einheiten der Eingabe-Features. Die Einheiten können in jede beliebige andere Einheit geändert werden. Dies hat jedoch keine Auswirkungen auf die Einheiten das Ausgabe-DISTANCE-Feldes, das auf den Einheiten des Koordinatensystems der Eingabe-Features basiert. | Linear Unit |
Codebeispiel
PointDistance – Beispiel 1 (Python-Fenster)
Das folgende Skript für das interaktive Python-Fenster veranschaulicht, wie die Funktion PointDistance im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")
PointDistance – Beispiel 2 (eigenständiges Skript)
Das folgende Python-Skript veranschaulicht die Verwendung der Funktion PointDistance in einem eigenständigen Skript.
# Description: Finds distance of each near point from each input point and outputs to a table.
# import system modules
import arcpy
# set workspace environment
arcpy.env.workspace = "C:/data/pointdistance.gdb"
# set variables
in_features = "police_stations"
near_features = "crime_location"
out_table = "crime_distance4"
search_radius = "22000 Feet"
# find crime locations within the search radius
arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Nein
- Advanced: Ja