Générer des liens origine-destination (Analyse)

Synthèse

Génère des lignes de connexion entre les entités d’origine et les entités de destination. Ce graphique est souvent appelé diagramme en étoile.

Illustration

Générer des liens origine-destination

Utilisation

  • Si les entités d’origine ou de destination sont des lignes ou des polygones, les liens sont générés à partir des centroïdes d’entité.

  • Les entités en sortie incluent les champs attributaires suivants :

    • ORIG_FID— Le champ ObjectID de l’entité d'origine.
    • ORIG_X— La coordonnée x de l’entité d'origine (ou centroïde).
    • ORIG_Y— La coordonnée y de l’entité d'origine (ou centroïde).
    • DEST_FID— Le champ ObjectID de l'entité de destination.
    • DEST_X— La coordonnée x de l’entité de destination (ou centroïde).
    • DEST_Y— La coordonnée y de l’entité de destination (ou centroïde).
    • LINK_DIST— La longueur du lien en sortie, mesurée dans l’unité de distance spécifiée.
    • GROUP_ID— Les valeurs des champs de regroupement partagées entre les paires liées d’entités d’origine et de destination. Ce champ n’est ajouté que si les champs des groupes d’origine et de destination sont tous deux spécifiés.
    • COLOR_ID— Une valeur numérique utilisée pour symboliser les origines ou groupes en un maximum de huit liens de couleur uniques. Les valeurs sont des nombres aléatoires compris entre 1 et 8.
    • LINK_COUNT— Le nombre de liens de superposition. Ce champ est ajouté si vous souhaitez agréger les liens de superposition.
    • Les champs de statistiques spécifiés lors de l’agrégation des liens de superposition sont également ajoutés à la classe d’entités en sortie.

  • Les entités d’origine et les entités de destination peuvent être spécifiées comme appartenant à la même couche ou au même jeu de données. Si les mêmes données sont utilisées à la fois comme origines et destinations, les liens ne sont pas générés à partir d’une entité d’origine vers l’entité de destination avec le même ID d’objet, car la ligne de longueur égale à zéro correspond à une erreur de géométrie nulle.

  • Cet outil peut être utilisé pour les relations un vers un et un vers plusieurs. Par exemple, vous pouvez lier un vol de véhicules à moteur à l’emplacement où il a été retrouvé (un à un) ou effectuer une analyse de proximité pour comprendre les distances entre l’emplacement d’un quartier général et les emplacements des bureaux régionaux (un à plusieurs).

  • La couche des liens en sortie inclut les diagrammes suivants pour que vous puissiez visualiser le résultat de l’analyse :

    • Un diagramme à barres du total de chaque ID de groupe si vous avez spécifié des champs de groupe.
    • Un diagramme à barres de la somme des longueurs de lien de chaque ID d’origine ou ID de groupe (si vous avez spécifié des champs de groupe). Ce diagramme est utile pour déterminer si des origines ou des groupes ont de grandes ou petites distances totales jusqu’aux destinations.
    • Un diagramme à barres des longueurs de lien moyennes de chaque ID d’origine ou ID de groupe (si vous avez spécifié des champs de groupe). Ce diagramme est utile pour déterminer la distance moyenne entre les entités d’origine ou les groupes et les destinations liées.
    • Une boîte à moustaches de la distribution des longueurs de lien de chaque ID d’origine ou ID de groupe (si vous avez spécifié des champs de groupe). Ce diagramme est utile pour déterminer si la plupart des liens reliant une origine ou un groupe à leurs destinations sont de grande ou petite taille et voir la plage et la distribution récapitulant ces longueurs de liens. Si le rectangle d’une entité d’origine ou d’un ID de groupe est plus large que haut, cela signifie que les distances entre cette origine ou ce groupe et toutes les destinations liées étaient similaires. Si une entité d’origine ou un ID de groupe a une boîte à moustaches plus haute que large, la plupart des liens sont de longueur importante.

Paramètres

ÉtiquetteExplicationType de données
Entités d'origine

Entités en entrée à partir desquelles les liens sont générés.

Feature Layer
Entités de destination

Entités de destination vers lesquelles les liens sont générés.

Feature Layer
Classe d’entités en sortie

Classe d'entités polylignes en sortie devant contenir les liens en sortie.

Feature Class
Champ de regroupement Origin (Origine)
(Facultatif)

Champ attributaire issu des entités d’origine en entrée à utiliser pour le regroupement. Les entités possédant la même valeur de champ de regroupement entre les origines et les destinations sont connectées avec un lien.

Field
Champ de regroupement Destination (Destination)
(Facultatif)

Champ attributaire issu des entités de destination en entrée à utiliser pour le regroupement. Les entités possédant la même valeur de champ de regroupement entre les origines et les destinations sont connectées avec un lien.

Field
Type de ligne
(Facultatif)

Spécifie si un chemin le plus court sur une sphéroïde (géodésique) ou une terre selon une projection cartésienne (planaire) est utilisé lors de la génération des liens en sortie. Les lignes géodésiques sont légèrement courbées si leur longueur dépasse environ 50 kilomètres car en raison de la courbure de la terre, la distance la plus courte entre deux points semble courbe sur une carte 2D.

Il est recommandé d’utiliser le type de ligne Geodesic (Géodésique) avec des données stockées dans un système de coordonnées non approprié pour les mesures de distance (par exemple, Web Mercator ou tout système de coordonnées géographiques) or tout jeu de données couvrant une zone géographique importante.

  • planeUne distance planaire est utilisée entre les entités. Il s’agit de l’option par défaut.
  • GéodésiqueDes distances géodésiques sont utilisées entre les entités. Ce type de ligne tient compte de la courbure de la sphéroïde et gère correctement les données situées près de la ligne de changement de jour et des pôles.
String
Number of Nearest Destinations (Nombre de destinations les plus proches)
(Facultatif)

Nombre maximal de liens générés par entité d'origine vers les entités de destination les plus proches. Si aucun nombre n’est spécifié, l’outil génère des liens entre toutes les entités d’origine et de destination.

Par exemple, l’utilisation de la valeur 1 génère des liens entre chaque entité d'origine et son entité de destination la plus proche.

Double
Distance de recherche
(Facultatif)

Distance maximum entre une entité d’origine et une entité de destination qui produit une entité de lien en sortie. L’unité de distance de recherche est spécifiée selon le paramètre d’unité de distance. Si aucune distance de recherche n’est spécifiée, l’outil génère des liens entre toutes les entités d’origine et de destination, quelle que soit la distance qui les sépare.

Double
Unité de distance

Spécifie les unités utilisées pour mesurer les longueurs des liens. Les distances de chaque lien apparaissent dans le champ LINK_DIST. Si aucune unité de distance n'est spécifiée, celle du système de coordonnées des entités d'origine est utilisée.

  • KilomètresLa distance entre l’origine et la destination est calculée en kilomètres.
  • MètresLa distance entre l’origine et la destination est calculée en mètres.
  • MillesLa distance entre l’origine et la destination est calculée en miles.
  • Milles nautiquesLa distance entre l’origine et la destination est calculée en miles nautiques.
  • YardsLa distance entre l’origine et la destination est calculée en yards.
  • PiedsLa distance entre l’origine et la destination est calculée en pieds.
String
Aggregate Overlapping Links (Agréger les liens de superposition)
(Facultatif)

Indique si les liens de superposition sont agrégés.

  • Activé : les liens de superposition sont agrégés si les coordonnées du point de départ sont identiques.
  • Désactivée : les liens de superposition ne sont pas agrégés. Il s’agit de l’option par défaut.
Boolean
Champs de récapitulation
(Facultatif)

Spécifie le ou les champs contenant les valeurs attributaires permettant de calculer les statistiques indiquées. Vous pouvez spécifier plusieurs combinaisons de statistiques et de champs. Les valeurs nulles sont exclues de tous les calculs.

Par défaut, l’outil ne calcule aucune statistique.

Les champs attributaires textuels peuvent être récapitulés à l’aide de la première et de la dernière statistique. Les champs attributaires numériques peuvent être récapitulés à l’aide de toutes les statistiques.

Types de statistiques disponibles :

  • Somme : Les valeurs du champ spécifié seront additionnées.
  • Moyenne : calcule la moyenne du champ spécifié.
  • Minimum : recherche la valeur la plus faible parmi tous les enregistrements du champ spécifié.
  • Maximum : recherche la valeur la plus élevée parmi tous les enregistrements du champ spécifié.
  • Plage : calcule la plage de valeurs (maximum moins minimum) du champ spécifié.
  • Écart type : calcule l’écart type dans les valeurs du champ spécifié.
  • Total : recherche le nombre de valeurs contenues dans les calculs statistiques. Toutes les valeurs sont comptées à l’exception des valeurs nulles. Pour déterminer le nombre de valeurs Null dans un champ, utilisez COUNT sur le champ en question, puis sur un autre champ qui ne contient pas de valeurs Null (par exemple l’OID, s’il est présent), puis soustrayez les deux valeurs.
  • Premier : utilise la valeur du champ spécifié du premier enregistrement en entrée.
  • Dernier : utilise la valeur du champ spécifié du dernier enregistrement en entrée.
  • Médiane : calcule la médiane de tous les enregistrements du champ spécifié.
  • Variance : calcule la variance de tous les enregistrements du champ spécifié.
  • Unique : calcule le nombre de valeurs uniques du champ spécifié.
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})
NomExplicationType de données
origin_features

Entités en entrée à partir desquelles les liens sont générés.

Feature Layer
destination_features

Entités de destination vers lesquelles les liens sont générés.

Feature Layer
out_feature_class

Classe d'entités polylignes en sortie devant contenir les liens en sortie.

Feature Class
origin_group_field
(Facultatif)

Champ attributaire issu des entités d’origine en entrée à utiliser pour le regroupement. Les entités possédant la même valeur de champ de regroupement entre les origines et les destinations sont connectées avec un lien.

Field
destination_group_field
(Facultatif)

Champ attributaire issu des entités de destination en entrée à utiliser pour le regroupement. Les entités possédant la même valeur de champ de regroupement entre les origines et les destinations sont connectées avec un lien.

Field
line_type
(Facultatif)

Spécifie si un chemin le plus court sur une sphéroïde (géodésique) ou une terre selon une projection cartésienne (planaire) est utilisé lors de la génération des liens en sortie. Les lignes géodésiques sont légèrement courbées si leur longueur dépasse environ 50 kilomètres car en raison de la courbure de la terre, la distance la plus courte entre deux points semble courbe sur une carte 2D.

Il est recommandé d’utiliser le type de ligne GEODESIC avec des données stockées dans un système de coordonnées non approprié pour les mesures de distance (par exemple, Web Mercator ou tout système de coordonnées géographiques) or tout jeu de données couvrant une zone géographique importante.

  • PLANARUne distance planaire est utilisée entre les entités. Il s’agit de l’option par défaut.
  • GEODESICDes distances géodésiques sont utilisées entre les entités. Ce type de ligne tient compte de la courbure de la sphéroïde et gère correctement les données situées près de la ligne de changement de jour et des pôles.
String
num_nearest
(Facultatif)

Nombre maximal de liens générés par entité d'origine vers les entités de destination les plus proches. Si aucun nombre n’est spécifié, l’outil génère des liens entre toutes les entités d’origine et de destination.

Par exemple, l’utilisation de la valeur 1 génère des liens entre chaque entité d'origine et son entité de destination la plus proche.

Double
search_distance
(Facultatif)

Distance maximum entre une entité d’origine et une entité de destination qui produit une entité de lien en sortie. L’unité de distance de recherche est spécifiée selon le paramètre d’unité de distance. Si aucune distance de recherche n’est spécifiée, l’outil génère des liens entre toutes les entités d’origine et de destination, quelle que soit la distance qui les sépare.

Double
distance_unit

Spécifie les unités utilisées pour mesurer les longueurs des liens. Les distances de chaque lien apparaissent dans le champ LINK_DIST. Si aucune unité de distance n'est spécifiée, celle du système de coordonnées des entités d'origine est utilisée.

  • KILOMETERSLa distance entre l’origine et la destination est calculée en kilomètres.
  • METERSLa distance entre l’origine et la destination est calculée en mètres.
  • MILESLa distance entre l’origine et la destination est calculée en miles.
  • NAUTICALMILESLa distance entre l’origine et la destination est calculée en miles nautiques.
  • YARDSLa distance entre l’origine et la destination est calculée en yards.
  • FEETLa distance entre l’origine et la destination est calculée en pieds.
String
aggregate_links
(Facultatif)

Indique si les liens de superposition sont agrégés.

  • AGGREGATE_OVERLAPPINGLes liens de superposition sont agrégés si les coordonnées du point de départ sont identiques.
  • NO_AGGREGATELes liens de superposition ne sont pas agrégés. Il s’agit de l’option par défaut.
Boolean
sum_fields
[sum_fields,...]
(Facultatif)

Spécifie le ou les champs contenant les valeurs attributaires permettant de calculer les statistiques indiquées. Vous pouvez spécifier plusieurs combinaisons de statistiques et de champs. Les valeurs nulles sont exclues de tous les calculs.

Par défaut, l’outil ne calcule aucune statistique.

Les champs attributaires textuels peuvent être récapitulés à l’aide de la première et de la dernière statistique. Les champs attributaires numériques peuvent être récapitulés à l’aide de toutes les statistiques.

Types de statistiques disponibles :

  • SUM : les valeurs du champ spécifié seront additionnées.
  • MEAN : calcule la moyenne du champ spécifié.
  • MIN : recherche la valeur la plus faible parmi tous les enregistrements du champ spécifié.
  • MAX : recherche la valeur la plus élevée parmi tous les enregistrements du champ spécifié.
  • RANGE : calcule la plage de valeurs (maximum moins minimum) du champ spécifié.
  • STD : calcule l’écart type dans les valeurs du champ spécifié.
  • COUNT : recherche le nombre de valeurs contenues dans les calculs statistiques. Toutes les valeurs sont comptées à l’exception des valeurs nulles. Pour déterminer le nombre de valeurs Null dans un champ, utilisez COUNT sur le champ en question, puis sur un autre champ qui ne contient pas de valeurs Null (par exemple l’OID, s’il est présent), puis soustrayez les deux valeurs.
  • FIRST : utilise la valeur du champ spécifié du premier enregistrement en entrée.
  • LAST : utilise la valeur du champ spécifié du dernier enregistrement en entrée.
  • MEDIAN : calcule la médiane de tous les enregistrements du champ spécifié.
  • VARIANCE : calcule la variance de tous les enregistrements du champ spécifié.
  • UNIQUE : calcule le nombre de valeurs uniques du champ spécifié.
Value Table

Exemple de code

Exemple 1 d’utilisation de l’outil GenerateOriginDestinationLinks (fenêtre Python)

L’exemple ci-dessous illustre l’utilisation de la fonction GenerateOriginDestinationLinks dans la fenêtre Python :

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

arcpy.analysis.GenerateOriginDestinationLinks(
    "Station_100", "City_FireResponses", "Station_100_OD_Links")
Exemple 2 d’utilisation de l’outil GenerateOriginDestinationLinks (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction GenerateOriginDestinationLinks dans un script autonome :

# 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)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes