Near-Tabelle erstellen (Analysis Tools)

Zusammenfassung

Berechnet die Entfernung und andere Nachbarschaftsinformationen zwischen Features in einer oder mehreren Feature-Classes oder Layern. Im Gegensatz zum Werkzeug Near, bei dem die Eingabe geändert wird, schreibt Near-Tabelle erstellen Ergebnisse in eine neue eigenständige Tabelle und unterstützt die Suche von mehr als einem Near-Feature.

Weitere Informationen zum Berechnen der Nähe mit Geoverarbeitungswerkzeugen

Abbildung

Abbildung des Werkzeugs "Near-Tabelle erstellen"

Verwendung

Die Ausgabetabelle enthält die folgenden Felder:
- IN_FID—Die Objekt-ID des Eingabe-Features.
- NEAR_FID—Die Objekt-ID des nächstgelegenen Features.
- NEAR_DIST—Die Entfernung vom Eingabe-Feature zum Near-Feature. Der Wert wird in der linearen Einheit des Koordinatensystems des Eingabe-Features oder in Metern angegeben, wenn für den Parameter Methode der Wert Geodätisch festgelegt wurde und die Eingabe sich in einem geographischen Koordinatensystem befindet.
- NEAR_FC—Der Katalogpfad zur Feature-Class mit dem Near-Feature. Dieses Feld wird nur dann zur Ausgabetabelle hinzugefügt, wenn mehrere Parameterwerte für Near-Features angegeben wurden.
- NEAR_RANK—Ein Ganzzahlwert, nach dem alle Near-Features abhängig von ihrer Nähe zu einem bestimmten Eingabe-Feature sortiert werden. Das nächstgelegene Feature erhält den -Wert 1, das zweitnächstgelegene den -Wert 2 usw.
Die folgenden Felder werden der Ausgabetabelle hinzugefügt, wenn der Parameter Position aktiviert ist. Die Einheit der Feldwerte hängt von dem Wert des Parameters Methode ab. Wenn der Parameter Methode auf Planar festgelegt ist, liegt der Feldwert in der linearen Einheit des Koordinatensystems des Eingabe-Features vor. Bei Festlegung auf Geodätisch wird er in dem geographischen Koordinatensystem angegeben, das mit dem Koordinatensystem des Eingabe-Features verknüpft ist.
- FROM_X—Die X-Koordinate der Position im Eingabe-Feature, das dem Near-Feature am nächsten liegt
- FROM_Y—Die Y-Koordinate der Position im Eingabe-Feature, das dem Near-Feature am nächsten liegt
- NEAR_X—Die X-Koordinate der Position im Near-Feature, das dem Eingabe-Feature am nächsten liegt.
- NEAR_Y—Die Y-Koordinate der Position im Near-Feature, das dem Eingabe-Feature am nächsten liegt
Das folgende Feld wird der Ausgabetabelle hinzugefügt, wenn der Parameter Winkel aktiviert ist:
- NEAR_ANGLE—Der Winkel der Linie an der FROM_X- und FROM_Y-Position, die die Eingabe-Features mit dem Near-Feature verbindet.
Wenn das Eingabe-Feature und das Near-Feature sich überschneiden, werden die folgenden Werte in die Ausgabetabelle geschrieben:
- NEAR_ANGLE und NEAR_DIST wird auf 0,0 festgelegt.
- FROM_X und FROM_Y sind identisch mit NEAR_X und NEAR_Y und entsprechen einer Position im Schnittpunkt der zwei Features.
Die Werte für das Feld NEAR_DIST werden in der linearen Einheit des Koordinatensystems des Eingabe-Features angegeben. Wenn sich die Eingabe in einem geographischen Koordinatensystem befindet und für den Parameter Methode der Wert Geodätisch festgelegt wurde, lautet die Einheit für das Feld NEAR_DIST Meter.
Die Ausgabetabelle kann anhand des IN_FID-Felds wieder mit den Eingabe-Features oder mithilfe des NEAR_FID-Felds mit den Near-Features verknüpft werden.
Wenn der Parameterwert Suchradius angegeben ist und kein Near-Feature gefunden wurde, wird kein Datensatz ausgegeben.
Wenn der Wert des Parameters Suchradius nicht angegeben wurde, werden alle Near-Features als Kandidaten betrachtet.
Wenn der Parameterwert Suchradius nicht angegeben wurde, der Parameter Nur nächstgelegene Features suchen nicht aktiviert ist und für den Parameter Maximale Anzahl der nächstgelegenen Übereinstimmungen der Standardwert (0 oder leer) festgelegt wurde, enthält die Ausgabetabelle Entfernungsberechnungen zwischen allen Eingabe-Features und allen Near-Features. Dieser Prozess kann viel Zeit in Anspruch nehmen und eine große Ausgabetabelle erzeugen. Wenn es beispielsweise 1.000 Eingabe-Features und 1.000 Near-Features gibt, enthält die Ausgabetabelle 1 Million Datensätze.
Um die Entfernung und weitere Nachbarschaftsinformationen in einer einzelnen Feature-Class oder in einem einzelnen Feature-Layer zu berechnen, kann dieselbe Feature-Class bzw. derselbe Feature-Layer verwendet werden. In diesem Fall wird das ausgewertete Eingabe-Feature aus den Near-Feature-Kandidaten ausgeschlossen, um zu vermeiden, dass alle Features jeweils das nächstgelegene Feature für sich selbst darstellen.
Verwenden Sie bei Verwendung der Option Planar für den Parameter Methode für die Eingabe-Features eine Projektion, die für den Entfernungsmesswert geeignet ist, z. B. eine äquidistante Projektion.

Weitere Informationen zu Koordinatensystemen und Projektionen
Um die Feldwerte FROM_X, FROM_Y, NEAR_X und NEAR_Y zu visualisieren, kann die Ausgabetabelle als Eingabe für das Werkzeug XY-Ereignis-Layer erstellen oder XY in Linie verwendet werden.
You can set a unit of measurement for the NEAR_DIST festlegen, z. B. Meter, Kilometer oder Meilen, indem Sie den Parameter Entfernungseinheit verwenden.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Eingabe-Features können vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein.	Feature Layer
Near-Features	Ein oder mehrere Feature-Layer oder Feature-Classes mit Near-Feature-Kandidaten. Die Near-Features können vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein. Wenn mehrere Layer oder Feature-Classes angegeben werden, wird der Eingabetabelle das Feld `NEAR_FC` hinzugefügt. Darin werden die Pfade der Quell-Feature-Class mit dem nächstgelegenen Feature gespeichert. Eine Feature-Class oder ein Layer kann sowohl als Eingabe-Feature als auch als Near-Feature verwendet werden.	Feature Layer
Ausgabetabelle	Die Ausgabetabelle mit dem Ergebnis der Analyse.	Table
Suchradius (Optional)	Der zum Suchen nach Near-Features verwendete Radius. Wenn kein Wert angegeben wird, werden alle Near-Features berücksichtigt. Wenn eine Entfernung eingegeben, jedoch keine Einheit oder "Unbekannt" angegeben wurde, werden die Einheiten des Koordinatensystems der Eingabe-Features verwendet. Bei Verwendung der Option Geodätisch für den Parameter Methode ist eine lineare Einheit wie Kilometer oder Meilen zu verwenden.	Linear Unit
Position (Optional)	Gibt an, ob X- und Y-Koordinaten der Position des Eingabe-Features und die nächstgelegene Position des Near-Features in die Felder `FROM_X`, `FROM_Y`, `NEAR_X` und `NEAR_Y` geschrieben werden. Aktiviert—Positionen werden in die Ausgabetabelle geschrieben. Deaktiviert—Positionen werden nicht in die Ausgabetabelle geschrieben. Dies ist die Standardeinstellung.	Boolean
Winkel (Optional)	Gibt an, ob der nächstgelegene Winkel berechnet und in das Feld `NEAR_ANGLE` der Ausgabetabelle geschrieben wird. Der nächstgelegene Winkel misst die Richtung der Linie, die ein Eingabe-Feature mit dem diesem zunächst liegenden Feature an der nächstgelegenen Position verbindet. Bei Verwendung der Methode `PLANAR` für den Parameter `method` liegt der Winkel im Bereich -180° bis 180°, wobei 0° Osten, 90° Norden, 180° (oder -180°) Westen und -90° Süden bedeutet. Bei Verwendung der Methode `GEODESIC` für den Parameter `method` liegt der Winkel im Bereich -180° bis 180°, wobei 0° Norden, 90° Osten, 180° (oder -180°) Süden und -90° Westen bedeutet. Aktiviert—Der nächstgelegene Winkel wird berechnet, und das Feld `NEAR_ANGLE` wird der Ausgabetabelle hinzugefügt. Deaktiviert—Der nächstgelegene Winkel wird nicht berechnet, und das Feld `NEAR_ANGLE` wird nicht der Ausgabetabelle hinzugefügt. Dies ist die Standardeinstellung.	Boolean
Nur nächstgelegenes Feature suchen (Optional)	Gibt an, ob nur das nächstgelegene Near-Feature in die Ausgabetabelle geschrieben wird. Aktiviert—Nur das nächstgelegene Near-Feature wird in die Ausgabetabelle geschrieben. Dies ist die Standardeinstellung. Deaktiviert—Mehrere Near-Features werden in die Ausgabetabelle geschrieben (im Parameter `closest_count` kann ein Grenzwert angegeben werden).	Boolean
Maximale Anzahl der nächstgelegenen Übereinstimmungen (Optional)	Begrenzt die Anzahl der Near-Features, die für jedes Eingabe-Feature angegeben werden. Dieser Parameter ist inaktiv, wenn der Parameter Nur nächstgelegenes Feature suchen aktiviert ist.	Long
Methode (Optional)	Gibt an, ob der kürzeste Pfad für einen Sphäroiden (geodätisch) oder eine Ebene (planar) als Entfernungsmethode verwendet werden soll. Es wird dringend empfohlen, für Daten, die in einem nicht für Entfernungsmesswerte geeigneten Koordinatensystem (z. B. Web Mercator und geographische Koordinatensysteme) gespeichert sind, sowie für Datasets, die einen großen geographischen Bereich umfassen, die Methode Geodätisch zu verwenden. Planar—Zwischen Features wird die planare Entfernung verwendet. Dies ist die Standardeinstellung. Geodätisch—Zwischen den Features wird die geodätische Entfernung verwendet. Bei dieser Methode wird die Krümmung des Sphäroiden berücksichtigt, und die Daten in der Nähe der internationalen Datumsgrenze und der Pole werden richtig verarbeitet.	String
Entfernungseinheit (Optional)	Gibt die Messeinheit für das Feld `NEAR_DIST` an. Wenn keine Messeinheit angegeben ist, werden die Werte in dem Feld `NEAR_DIST` in der linearen Einheit des Koordinatensystems des Eingabe-Features angegeben. Wenn sich die Eingabe in einem geographischen Koordinatensystem befindet und die geodätische Methode verwendet wird, lauten die Einheiten des Feldes `NEAR_DIST` Meter. Kilometer—Die Einheit ist Kilometer. Meter—Die Einheit ist Meter. Seemeilen (International)—Die Einheit ist Seemeilen (International). Meilen (Britisch)—Die Einheit ist Meilen (Britisch). Yards (International)—Die Einheit ist Yards (International). Fuß (International)—Die Einheit ist Fuß (International). Seemeilen (US Survey)—Die Einheit ist Seemeile (US Survey). Meilen (US Survey)—Die Einheit ist Meile (US Survey). Yards (US Survey)—Die Einheit ist Yard (US Survey). Fuß (US Survey)—Die Einheit ist Fuß (US Survey).	String
Felder abgleichen (Optional)	Die Feldpaare aus den Eingabe-Features und den Near-Features, die für den Attributabgleich verwendet werden. In der Near-Berechnung werden nur Near-Features verwendet, die gemeinsame Abgleich-Feldwerte mit den Eingabe-Features aufweisen. Spalten der Wertetabelle: Input Fields—Fields from the input features that will be used for attribute matching. Near Fields—Fields from the near features that will be used for attribute matching.	Value Table

arcpy.analysis.GenerateNearTable(in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count}, {method}, {distance_unit}, {match_fields})

Name	Erläuterung	Datentyp
in_features	Die Eingabe-Features können vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein.	Feature Layer
near_features [near_features,...]	Ein oder mehrere Feature-Layer oder Feature-Classes mit Near-Feature-Kandidaten. Die Near-Features können vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein. Wenn mehrere Layer oder Feature-Classes angegeben werden, wird der Eingabetabelle das Feld `NEAR_FC` hinzugefügt. Darin werden die Pfade der Quell-Feature-Class mit dem nächstgelegenen Feature gespeichert. Eine Feature-Class oder ein Layer kann sowohl als Eingabe-Feature als auch als Near-Feature verwendet werden.	Feature Layer
out_table	Die Ausgabetabelle mit dem Ergebnis der Analyse.	Table
search_radius (Optional)	Der zum Suchen nach Near-Features verwendete Radius. Wenn kein Wert angegeben wird, werden alle Near-Features berücksichtigt. Wenn eine Entfernung eingegeben, jedoch keine Einheit oder "Unbekannt" angegeben wurde, werden die Einheiten des Koordinatensystems der Eingabe-Features verwendet. Bei Verwendung der Option `GEODESIC` für den Parameter `method` ist eine lineare Einheit wie Kilometer oder Meilen zu verwenden.	Linear Unit
location (Optional)	Gibt an, ob X- und Y-Koordinaten der Position des Eingabe-Features und die nächstgelegene Position des Near-Features in die Felder `FROM_X`, `FROM_Y`, `NEAR_X` und `NEAR_Y` geschrieben werden. `LOCATION`—Positionen werden in die Ausgabetabelle geschrieben. `NO_LOCATION`—Positionen werden nicht in die Ausgabetabelle geschrieben. Dies ist die Standardeinstellung.	Boolean
angle (Optional)	Gibt an, ob der nächstgelegene Winkel berechnet und in das Feld `NEAR_ANGLE` der Ausgabetabelle geschrieben wird. Der nächstgelegene Winkel misst die Richtung der Linie, die ein Eingabe-Feature mit dem diesem zunächst liegenden Feature an der nächstgelegenen Position verbindet. Bei Verwendung der Methode `PLANAR` für den Parameter `method` liegt der Winkel im Bereich -180° bis 180°, wobei 0° Osten, 90° Norden, 180° (oder -180°) Westen und -90° Süden bedeutet. Bei Verwendung der Methode `GEODESIC` für den Parameter `method` liegt der Winkel im Bereich -180° bis 180°, wobei 0° Norden, 90° Osten, 180° (oder -180°) Süden und -90° Westen bedeutet. `ANGLE`—Der nächstgelegene Winkel wird berechnet, und das Feld `NEAR_ANGLE` wird der Ausgabetabelle hinzugefügt. `NO_ANGLE`—Der nächstgelegene Winkel wird nicht berechnet, und das Feld `NEAR_ANGLE` wird nicht der Ausgabetabelle hinzugefügt. Dies ist die Standardeinstellung.	Boolean
closest (Optional)	Gibt an, ob nur das nächstgelegene Near-Feature in die Ausgabetabelle geschrieben wird. `CLOSEST`—Nur das nächstgelegene Near-Feature wird in die Ausgabetabelle geschrieben. Dies ist die Standardeinstellung. `ALL`—Mehrere Near-Features werden in die Ausgabetabelle geschrieben (im Parameter `closest_count` kann ein Grenzwert angegeben werden).	Boolean
closest_count (Optional)	Begrenzt die Anzahl der Near-Features, die für jedes Eingabe-Feature angegeben werden. Dieser Parameter wird ignoriert, wenn für den Parameter `closest` die Option `CLOSEST` angegeben ist.	Long
method (Optional)	Gibt an, ob der kürzeste Pfad für einen Sphäroiden (geodätisch) oder eine Ebene (planar) als Entfernungsmethode verwendet werden soll. Es wird dringend empfohlen, für Daten, die in einem nicht für Entfernungsmesswerte geeigneten Koordinatensystem (z. B. Web Mercator und geographische Koordinatensysteme) gespeichert sind, sowie für Datasets, die einen großen geographischen Bereich umfassen, die Methode `GEODESIC` zu verwenden. `PLANAR`—Zwischen Features wird die planare Entfernung verwendet. Dies ist die Standardeinstellung. `GEODESIC`—Zwischen den Features wird die geodätische Entfernung verwendet. Bei dieser Methode wird die Krümmung des Sphäroiden berücksichtigt, und die Daten in der Nähe der internationalen Datumsgrenze und der Pole werden richtig verarbeitet.	String
distance_unit (Optional)	Gibt die Messeinheit für das Feld `NEAR_DIST` an. Wenn keine Messeinheit angegeben ist, werden die Werte in dem Feld `NEAR_DIST` in der linearen Einheit des Koordinatensystems des Eingabe-Features angegeben. Wenn sich die Eingabe in einem geographischen Koordinatensystem befindet und die geodätische Methode verwendet wird, lauten die Einheiten des Feldes `NEAR_DIST` Meter. `Kilometers`—Die Einheit ist Kilometer. `Meters`—Die Einheit ist Meter. `NauticalMilesInt`—Die Einheit ist Seemeilen (International). `MilesInt`—Die Einheit ist Meilen (Britisch). `YardsInt`—Die Einheit ist Yards (International). `FeetInt`—Die Einheit ist Fuß (International). `NauticalMiles`—Die Einheit ist Seemeile (US Survey). `Miles`—Die Einheit ist Meile (US Survey). `Yards`—Die Einheit ist Yard (US Survey). `Feet`—Die Einheit ist Fuß (US Survey).	String
match_fields [[input_field, near_field],...] (Optional)	Die Feldpaare aus den Eingabe-Features und den Near-Features, die für den Attributabgleich verwendet werden. In der Near-Berechnung werden nur Near-Features verwendet, die gemeinsame Abgleich-Feldwerte mit den Eingabe-Features aufweisen. Spalten der Wertetabelle: `Input Fields`—Fields from the input features that will be used for attribute matching. `Near Fields`—Fields from the near features that will be used for attribute matching.	Value Table

Codebeispiel

GenerateNearTable: Beispiel 1 (Python-Fenster)

Im Folgenden wird veranschaulicht, wie die Funktion GenerateNearTable im Python-Fenster verwendet wird.

import arcpy

arcpy.env.workspace = "C:/data/input/gnt.gdb"

arcpy.analysis.GenerateNearTable("campsites", ["parks", "trails"], "better_sites")

GenerateNearTable: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht die Verwendung der Funktion GenerateNearTable in einem eigenständigen Skript.

# 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

# find crime locations within the search radius
arcpy.analysis.GenerateNearTable(in_features, near_features, out_table, search_radius,
                                 location, angle, closest, closest_count)

Umgebungen

Aktueller Workspace, Scratch-Workspace, Ausdehnung

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja