Start-Ziel-Verbindungen erstellen (Analysis)

Zusammenfassung

Erstellt Verbindungslinien zwischen Start- und Ziel-Features. Dies wird oft als Netzdiagramm bezeichnet.

Abbildung

Start-Ziel-Verbindungen erstellen

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 Ursprungs-Features (oder seines Schwerpunkts).
    • ORIG_Y: Die Y-Koordinate des Ursprungs-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 NULL 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.

Syntax

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})
ParameterErklärungDatentyp
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 Geodätisch zu verwenden.

  • PLANARZwischen Features wird die planare Entfernung verwendet. Dies ist die Standardeinstellung.
  • GEODESICZwischen den Features werden geodätische Entfernungen verwendet. Bei diesem Linientyp wird die Krümmung des Sphäroiden berücksichtigt und die Daten in der Nähe der Datumsgrenze und der Pole werden richtig verarbeitet.
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.

  • KILOMETERSDie Entfernung zwischen Ursprung und Ziel wird in Kilometern berechnet.
  • METERSDie Entfernung zwischen Ursprung und Ziel wird in Metern berechnet.
  • MILESDie Entfernung zwischen Ursprung und Ziel wird in Meilen berechnet.
  • NAUTICALMILESDie Entfernung zwischen Ursprung und Ziel wird in Seemeilen berechnet.
  • YARDSDie Entfernung zwischen Ursprung und Ziel wird in Yard berechnet.
  • FEETDie Entfernung zwischen Ursprung und Ziel wird in Fuß berechnet.
String
aggregate_links
(optional)

Gibt an, ob überlappende Verbindungen aggregiert werden.

  • AGGREGATE_OVERLAPPINGÜberlappende Verbindungen werden aggregiert, wenn die Ausgangspunkt-Koordinaten identisch sind.
  • NO_AGGREGATEÜberlappende Verbindungen werden nicht aggregiert. Dies ist die Standardeinstellung.
Boolean
sum_fields
[sum_fields,...]
(optional)

Gibt numerische Felder aus den Ziel-Features an, welche Attributwerte enthalten, die bei Überlappung mehrerer Verbindungen summiert werden. Es können mehrere Statistik- und Feldkombinationen angegeben werden. NULL-Werte sind von allen statistischen Berechnungen ausgeschlossen.

Die folgenden Statistiktypen sind verfügbar:

  • SUM: Der Gesamtwert für das angegebene Feld wird hinzugefügt
  • MEAN: Der Mittelwert für das angegebene Feld wird berechnet
  • MIN: Der kleinste Wert aller Datensätze für das angegebene Feld wird ermittelt
  • MAX: Der größte Wert aller Datensätze für das angegebene Feld wird ermittelt
  • RANGE: Der Wertebereich (MAX minus MIN) für das angegebene Feld wird ermittelt.
  • STD: Die Standardabweichung der Werte für das angegebene Feld wird ermittelt.
  • COUNT: Gibt die Anzahl der Werte zurück, die in statistischen Berechnungen enthalten sind. Zählt alle Werte außer den NULL-Werten. Um die Anzahl der NULL-Werte in einem Feld zu bestimmen, wenden Sie COUNT auf das gewünschte Feld an. Wenden Sie dann COUNT auf ein anderes Feld an, das keine NULL-Werte enthält (z. B. OID, falls vorhanden), und ermitteln Sie die Differenz zwischen dem Feld mit NULL-Werten und Feld ohne NULL-Werte.
  • FIRST: Der erste Datensatz in der Eingabe wird ermittelt, und der angegebene Feldwert wird verwendet.
  • LAST: Der letzte Datensatz in der Eingabe wird ermittelt, und der angegebene Feldwert wird verwendet.
  • MEDIAN: Der Median aller Datensätze für das angegebene Feld wird ermittelt.
  • VARIANCE: Die Varianz aller Datensätze für das angegebene Feld wird ermittelt.
  • UNIQUE: Die Anzahl der Einzelwerte für das angegebene Feld wird gezählt.
Value Table

Codebeispiel

GenerateOriginDestinationLinks – Beispiel 1 (Python-Fenster)

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

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

arcpy.GenerateOriginDestinationLinks_analysis(
    "Station_100", "City_FireResponses", "Station_100_OD_Links")
GenerateOriginDestinationLinks – Beispiel 2 (eigenständiges Skript)

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.GenerateOriginDestinationLinks_analysis(
    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)

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen