Punktentfernung (Analyse)

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 Entfernungsmatrix, wenn der Standardsuchradius verwendet wird. In diesem Fall werden Entfernungen von allen Eingabe-Features zu allen Near-Features berechnet. Die Ausgabe-Tabelle kann sehr groß werden. Wenn beispielsweise sowohl die Eingabe- als auch die Near-Features über jeweils 1000 Punkte verfügen, kann die Ausgabe-Tabelle eine Million Datensätze enthalten. Begrenzen Sie die Größe der Ausgabe mithilfe eines sinnvollen Suchradius.

• Die Ergebnisse werden in der Ausgabe-Tabelle 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.

• 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

PointDistance_analysis (in_features, near_features, out_table, {search_radius})

Parameter	Erläuterung	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 enthält die 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)	Entfernungen werden nur für die Near-Features berechnet, die im Suchradius der Eingabe-Features liegen.	Linear unit

Codebeispiel

PointDistance – Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
  
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")

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

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

# Name: PointDistance.py
# Description: Finds distance of each near point from each input point and outputs to a table.
# Author: ESRI
  
# import system modules
import arcpy
from arcpy import env
  
# set workspace environment
env.workspace = "C:/data/pointdistance.gdb"
  
# set variables
inFeatures = "police_stations"
nearFeatures = "crime_location"
outTable = "crime_distance4"
searchRadius = "22000 Feet"
  
# find crime locations within the search radius
arcpy.PointDistance_analysis(inFeatures, nearFeatures, outTable, searchRadius)

Umgebungen

Ausdehnung, Aktueller Workspace, Scratch-Workspace

Lizenzinformationen

ArcView: Nein

ArcEditor: Nein

ArcInfo: Ja