Punktentfernung (Analyse)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

Bestimmt innerhalb eines angegebenen Suchradius die Entfernungen von den Eingabe-Punkt-Features zu allen Punkten der Near-Features.

Weitere Informationen zum Berechnen der Nähe mit Geoverarbeitungswerkzeugen

Bild

Abbildung 'Punktentfernung'

Verwendung

Syntax

PointDistance_analysis (in_features, near_features, out_table, {search_radius})
ParameterErläuterungDatentyp
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 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.

# 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"
  
try:
    # find crime locations within the search radius
    arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)
    print arcpy.GetMessages(0)
    
except arcpy.ExecuteError:
    print arcpy.GetMessages(2)
    
except Exception as ex:
    print ex.args[0]

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Nein
ArcGIS for Desktop Standard: Nein
ArcGIS for Desktop Advanced: Ja
9/11/2013