Start-Ziel-Verbindungen erstellen (Analysis)

Zusammenfassung

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

Abbildung

Ursprung-Ziel-Beziehungen 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 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

BeschriftungErläuterungDatentyp
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.

  • PlanarZwischen Features wird die planare Entfernung verwendet. Dies ist die Standardeinstellung.
  • GeodätischZwischen 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
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.

  • KilometerDie Entfernung zwischen Ursprung und Ziel wird in Kilometern berechnet.
  • MeterDie Entfernung zwischen Ursprung und Ziel wird in Metern berechnet.
  • MeilenDie Entfernung zwischen Ursprung und Ziel wird in Meilen berechnet.
  • SeemeilenDie Entfernung zwischen Ursprung und Ziel wird in Seemeilen berechnet.
  • YardDie Entfernung zwischen Ursprung und Ziel wird in Yard berechnet.
  • FußDie Entfernung zwischen Ursprung und Ziel wird in Fuß berechnet.
String
Überlappende Verbindungen aggregieren
(optional)

Gibt an, ob überlappende Verbindungen aggregiert werden.

  • Aktiviert: Überlappende Verbindungen werden aggregiert, wenn die Ausgangspunkt-Koordinaten identisch sind.
  • Deaktiviert: Überlappende Verbindungen werden nicht aggregiert. Dies ist die Standardeinstellung.
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:

  • Summe: Die Werte für das angegebene Feld werden addiert.
  • Mittelwert: Der Durchschnitt für das angegebene Feld wird berechnet.
  • Minimum: Der kleinste Wert aller Datensätze des angegebenen Feldes wird ermittelt.
  • Maximum: Der größte Wert aller Datensätze des angegebenen Felds wird ermittelt.
  • Bereich: Der Wertebereich (Maximum minus Minimum) für das angegebene Feld wird berechnet.
  • Standardabweichung: Die Standardabweichung der Werte im angegebenen Feld wird berechnet.
  • Anzahl: Die Anzahl der Werte, die in den statistischen Berechnungen enthalten sind, wird ermittelt. Alle Werte außer den NULL-Werten werden gezählt. Um die Anzahl der NULL-Werte in einem Feld zu bestimmen, wenden Sie "Anzahl" auf das gewünschte Feld an. Wenden Sie dann "Anzahl" auf ein anderes Feld an, das keine NULL-Werte enthält (z. B. OID, falls vorhanden), und ermitteln Sie die Differenz.
  • Erster: Der angegebene Feldwert des ersten Datensatzes in der Eingabe wird verwendet.
  • Letzter: Der angegebene Feldwert des letzten Datensatzes in der Eingabe wird verwendet.
  • Medianwert: Der Medianwert aller Datensätze des angegebenen Feldes wird berechnet.
  • Varianz: Die Varianz aller Datensätze des angegebenen Feldes wird berechnet.
  • Eindeutig: Die Anzahl der Einzelwerte für das angegebene Feld wird gezählt.
Value Table

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})
NameErläuterungDatentyp
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.

  • 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 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:

  • SUM: Die Werte für das angegebene Feld werden addiert.
  • MEAN: Es wird der Mittelwert für den angegebenen Bereich berechnet.
  • MIN: Der kleinste Wert aller Datensätze des angegebenen Feldes wird ermittelt.
  • MAX: Der größte Wert aller Datensätze des angegebenen Felds wird ermittelt.
  • RANGE: Der Wertebereich (Maximum minus Minimum) für das angegebene Feld wird berechnet.
  • STD: Die Standardabweichung der Werte im angegebenen Feld wird berechnet.
  • COUNT: Die Anzahl der Werte, die in den statistischen Berechnungen enthalten sind, wird ermittelt. Alle Werte außer den NULL-Werten werden gezählt. Um die Anzahl der NULL-Werte in einem Feld zu bestimmen, wenden Sie "Anzahl" auf das gewünschte Feld an. Wenden Sie dann "Anzahl" auf ein anderes Feld an, das keine NULL-Werte enthält (z. B. OID, falls vorhanden), und ermitteln Sie die Differenz.
  • FIRST: Der angegebene Feldwert des ersten Datensatzes in der Eingabe wird verwendet.
  • LAST: Der angegebene Feldwert des letzten Datensatzes in der Eingabe wird verwendet.
  • MEDIAN: Der Medianwert aller Datensätze des angegebenen Feldes wird berechnet.
  • VARIANCE: Die Varianz aller Datensätze des angegebenen Feldes wird berechnet.
  • 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.analysis.GenerateOriginDestinationLinks(
    "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.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)

Lizenzinformationen

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

Verwandte Themen