Beschriftung | Erläuterung | Datentyp |
Ursprungs-Features |
Die Eingabe-Features, aus denen Verbindungen erstellt werden. | Feature Layer |
Ziel-Features |
Die Ziel-Features, zu denen Verbindungen erstellt werden. | Feature Layer |
Ausgabe-Feature-Class |
Die Ausgabe-Polyline-Feature-Class, die die Ausgabeverbindungen enthält. | Feature Class |
Feld "Ursprungsgruppe" (optional) |
Das Attributfeld aus den Eingabe-Ursprungs-Features, die für die Gruppierung verwendet werden. Features mit demselben Gruppenfeldwert zwischen Ursprüngen und Zielen werden miteinander verbunden. | Field |
Feld "Zielgruppe" (optional) | Das Attributfeld aus den Eingabe-Ziel-Features, die für die Gruppierung verwendet werden. Features mit demselben Gruppenfeldwert zwischen Ursprüngen und Zielen werden miteinander verbunden. | Field |
Linientyp (optional) | Gibt an, ob bei der Erstellung der Ausgabeverbindungen eine kürzeste Verbindung auf einem Sphäroiden (geodätisch) oder einer kartesisch-projizierten Ebene (planar) verwendet wird. Geodätische Linien weisen eine leichte Krümmung auf, wenn sie länger als ca. 50 km sind, da durch die Erdkrümmung die kürzeste Entfernung zwischen zwei Punkten auf einer 2D-Karte wie eine gekrümmte Linie wirkt. 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, oder für Datasets, die einen großen geographischen Bereich umfassen, den Linientyp Geodätisch zu verwenden.
| String |
Anzahl der nächstgelegenen Ziele (optional) | Die maximale Anzahl der Verbindungen, die pro Ursprungs-Feature zu den nächstgelegenen Ziel-Features erstellt werden. Wenn keine Zahl angegeben wird, erstellt das Werkzeug Verbindungen zwischen allen Ursprungs- und Ziel-Features. Beispiel: Beim Wert 1 werden Verbindungen zwischen den einzelnen Ursprungs-Features und dem jeweils nächstgelegenen Ziel-Feature erstellt. | Double |
Suchentfernung (optional) | Die maximale Entfernung zwischen Ursprungs- und Ziel-Feature, bis zu der ein Link-Feature in der Ausgabe generiert wird. Die Einheit der Suchentfernung wird mit dem Parameter "Entfernungseinheit" angegeben. Wenn keine Suchentfernung angegeben wird, erstellt das Werkzeug Verbindungen zwischen allen Start- und Ziel-Features unabhängig von ihrer Entfernung voneinander. | Double |
Entfernungseinheit | Gibt die Einheiten für die Messung der Verbindungslängen an. Die Entfernungen der einzelnen Verbindungen werden im Feld LINK_DIST dargestellt. Wenn keine Entfernungseinheit angegeben ist, wird die Einheit des Koordinatensystems der Ursprungs-Features verwendet.
| String |
Überlappende Verbindungen aggregieren (optional) | Gibt an, ob überlappende Verbindungen aggregiert werden.
| Boolean |
Zusammenfassungsfelder (optional) | Gibt das Feld oder die Felder mit den Attributwerten an, mit denen die angegebene Statistik berechnet wird. Es können mehrere Statistik- und Feldkombinationen angegeben werden. NULL-Werte sind von allen Berechnungen ausgeschlossen. Standardmäßig werden mit dem Werkzeug keine Statistiken berechnet. Textattributfelder können mit den Statistiken FIRST oder LAST zusammengefasst werden. Numerische Attributfelder können mit jeder beliebigen Statistik zusammengefasst werden. Die folgenden Statistiktypen stehen zur Verfügung:
| Value Table |
Zusammenfassung
Erstellt Verbindungslinien zwischen Start- und Ziel-Features. Dies wird oft als Netzdiagramm bezeichnet.
Abbildung
Verwendung
Wenn es sich bei den Ursprungs- oder Ziel-Features um Linien oder Polygone handelt, werden die Schwerpunkte der Features zum Generieren der Verbindungen verwendet.
Die Ausgabe-Features enthalten die folgenden Attributfelder:
- ORIG_FID: Das Feld ObjectID des Ursprungs-Features.
- ORIG_X: Die X-Koordinate des Start-Features (oder seines Schwerpunkts).
- ORIG_Y: Die Y-Koordinate des Start-Features (oder seines Schwerpunkts).
- DEST_FID: Das Feld ObjectID des Ziel-Features.
- DEST_X: Die X-Koordinate des Ziel-Features (oder seines Schwerpunkts).
- DEST_Y: Die Y-Koordinate des Ziel-Features (oder seines Schwerpunkts).
- LINK_DIST: Die Länge der Ausgabeverbindung, gemessen in der angegebenen Entfernungseinheit.
- GROUP_ID: Die gemeinsamen Gruppenfeldwerte zwischen verbundenen Paaren aus Ursprungs- und Ziel-Feature. Dieses Feld wird nur hinzugefügt, wenn sowohl Felder der Ursprungs- als auch der Zielgruppe angegeben werden.
- COLOR_ID: Ein numerischer Wert, mit dem Ursprünge oder Gruppen mit bis zu acht Verbindungen in eindeutigen Farben symbolisiert werden. Die Werte sind Zufallszahlen zwischen 1 und 8.
- LINK_COUNT: Die Anzahl der überlappenden Verbindungen. Dieses Feld wird hinzugefügt, wenn Sie festlegen, dass überlappende Verbindungen aggregiert werden sollen.
- Statistikfelder, die beim Aggregieren überlappender Verbindungen angegeben werden, werden ebenfalls der Ausgabe-Feature-Class hinzugefügt.
Für die Ursprungs-Features und Ziel-Features kann der derselbe Layer oder dasselbe Dataset angegeben werden. Wenn für Ursprünge und Ziele dieselben Daten verwendet werden, werden von den Ursprungs-Features zu den Ziel-Features mit derselben Objekt-ID keine Verbindungen generiert, da diese Linie der Länge 0 ein NULL-Geometrie-Fehler ist.
Dieses Werkzeug kann für Eins-zu-Eins- und Eins-zu-Viele-Beziehungen verwendet werden. Zum Beispiel kann eine Verbindung zwischen dem Ort eines Kfz-Diebstahls und der Fundstelle des gestohlenen Fahrzeugs (Eins-zu-Eins) hergestellt oder eine Nachbarschaftsanalyse zum Ermitteln der Entfernungen von einer Unternehmenszentrale zu den regionalen Niederlassungen (Eins-zu-Viele) durchgeführt werden.
Der Ausgabe-Verbindungs-Layer enthält die folgenden Diagramme, um das Ergebnis der Analyse zu visualisieren:
- Ein Balkendiagramm der Anzahl der einzelnen Gruppen-IDs, sofern Sie Gruppenfelder angegeben haben.
- Ein Balkendiagramm der Summe der Verbindungslängen für jede Ursprungs-ID oder Gruppen-ID (sofern Sie Gruppenfelder angegeben haben). Hieran lässt sich ablesen, ob einige Ursprünge oder Gruppen lange oder kurze Gesamtentfernungen zu den Zielen aufweisen.
- Ein Balkendiagramm der mittleren Verbindungslänge für jede Ursprungs-ID oder Gruppen-ID (sofern Sie Gruppenfelder angegeben haben). Hieran lässt sich die durchschnittliche Entfernung zwischen den Ursprungs-Features oder Ursprungsgruppen und ihren verbundenen Zielen ablesen.
- Ein Boxplot der Verteilung der Verbindungslängen für jede Ursprungs-ID oder Gruppen-ID (sofern Sie Gruppenfelder angegeben haben). Hieran lässt sich erkennen, ob die meisten Verbindungen von einem Ursprung oder einer Gruppe zu ihrem Ziel lang oder kurz sind, und das Diagramm stellt den Bereich und eine Übersicht über die Verteilung dieser Verbindungslängen dar. Wenn eine Ursprungs-ID oder Gruppen-ID durch einen vertikal niedrigen Kasten dargestellt wird, sind die Entfernungen zwischen dem Ursprung oder der Gruppen und allen verbundenen Zielen ähnlich. Wenn die Ursprungs-ID oder Gruppen-ID durch einen Kasten dargestellt wird, der sich weit oben auf der X-Achse befindet, sind die meisten Verbindungen lang.
Parameter
arcpy.analysis.GenerateOriginDestinationLinks(origin_features, destination_features, out_feature_class, {origin_group_field}, {destination_group_field}, {line_type}, {num_nearest}, {search_distance}, distance_unit, {aggregate_links}, {sum_fields})
Name | Erläuterung | Datentyp |
origin_features |
Die Eingabe-Features, aus denen Verbindungen erstellt werden. | Feature Layer |
destination_features |
Die Ziel-Features, zu denen Verbindungen erstellt werden. | Feature Layer |
out_feature_class |
Die Ausgabe-Polyline-Feature-Class, die die Ausgabeverbindungen enthält. | Feature Class |
origin_group_field (optional) |
Das Attributfeld aus den Eingabe-Ursprungs-Features, die für die Gruppierung verwendet werden. Features mit demselben Gruppenfeldwert zwischen Ursprüngen und Zielen werden miteinander verbunden. | Field |
destination_group_field (optional) | Das Attributfeld aus den Eingabe-Ziel-Features, die für die Gruppierung verwendet werden. Features mit demselben Gruppenfeldwert zwischen Ursprüngen und Zielen werden miteinander verbunden. | Field |
line_type (optional) | Gibt an, ob bei der Erstellung der Ausgabeverbindungen eine kürzeste Verbindung auf einem Sphäroiden (geodätisch) oder einer kartesisch-projizierten Ebene (planar) verwendet wird. Geodätische Linien weisen eine leichte Krümmung auf, wenn sie länger als ca. 50 km sind, da durch die Erdkrümmung die kürzeste Entfernung zwischen zwei Punkten auf einer 2D-Karte wie eine gekrümmte Linie wirkt. 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, oder für Datasets, die einen großen geographischen Bereich umfassen, den Linientyp GEODESIC zu verwenden.
| String |
num_nearest (optional) | Die maximale Anzahl der Verbindungen, die pro Ursprungs-Feature zu den nächstgelegenen Ziel-Features erstellt werden. Wenn keine Zahl angegeben wird, erstellt das Werkzeug Verbindungen zwischen allen Ursprungs- und Ziel-Features. Beispiel: Beim Wert 1 werden Verbindungen zwischen den einzelnen Ursprungs-Features und dem jeweils nächstgelegenen Ziel-Feature erstellt. | Double |
search_distance (optional) | Die maximale Entfernung zwischen Ursprungs- und Ziel-Feature, bis zu der ein Link-Feature in der Ausgabe generiert wird. Die Einheit der Suchentfernung wird mit dem Parameter "Entfernungseinheit" angegeben. Wenn keine Suchentfernung angegeben wird, erstellt das Werkzeug Verbindungen zwischen allen Start- und Ziel-Features unabhängig von ihrer Entfernung voneinander. | Double |
distance_unit | Gibt die Einheiten für die Messung der Verbindungslängen an. Die Entfernungen der einzelnen Verbindungen werden im Feld LINK_DIST dargestellt. Wenn keine Entfernungseinheit angegeben ist, wird die Einheit des Koordinatensystems der Ursprungs-Features verwendet.
| String |
aggregate_links (optional) | Gibt an, ob überlappende Verbindungen aggregiert werden.
| Boolean |
sum_fields [sum_fields,...] (optional) | Gibt das Feld oder die Felder mit den Attributwerten an, mit denen die angegebene Statistik berechnet wird. Es können mehrere Statistik- und Feldkombinationen angegeben werden. NULL-Werte sind von allen Berechnungen ausgeschlossen. Standardmäßig werden mit dem Werkzeug keine Statistiken berechnet. Textattributfelder können mit den Statistiken FIRST oder LAST zusammengefasst werden. Numerische Attributfelder können mit jeder beliebigen Statistik zusammengefasst werden. Die folgenden Statistiktypen stehen zur Verfügung:
| Value Table |
Codebeispiel
Im Folgenden wird veranschaulicht, wie die Funktion GenerateOriginDestinationLinks im Python-Fenster verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data/input/genODLinks.gdb"
arcpy.analysis.GenerateOriginDestinationLinks(
"Station_100", "City_FireResponses", "Station_100_OD_Links")
Das folgende Python-Skript veranschaulicht die Verwendung der Funktion GenerateOriginDestinationLinks in einem eigenständigen Skript:
# Name: GenerateODLinks.py
# Description: Finds 10 nearest links within 25 miles from the origin fire
# stations to the destination response points.
# import system modules
import arcpy
# set workspace environment
arcpy.env.workspace = "C:/data/input/genODLinks.gdb"
# set required parameters
origin_features = "Station_100"
destination_features = "City_FireResponses"
out_feature_class = "Station_100_OD_Links"
# optional parameters
origin_group_field = 'STA_NUM'
destination_group_field = 'District'
line_type = 'PLANAR'
num_nearest = 10
search_distance = 25
distance_unit = 'MILES'
aggregate_links='AGGREGATE_OVERLAPPING'
sum_fields = 'TimeSpentOnCall SUM'
# make links between fire stations and call response points
arcpy.analysis.GenerateOriginDestinationLinks(
origin_features, destination_features, out_feature_class,
origin_group_field, destination_group_field, line_type, num_nearest,
search_distance, distance_unit, aggregate_links, sum_fields)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja