Étiquette | Explication | Type 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.
| 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.
| String |
Aggregate Overlapping Links (Agréger les liens de superposition) (Facultatif) | Indique si les liens de superposition sont agrégés.
| Boolean |
Champs de récapitulation (Facultatif) | Spécifie le ou les champ(s) numérique(s) contenant les valeurs attributaires utilisées pour 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. 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 :
| Value Table |
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
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
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})
Nom | Explication | Type 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.
| 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.
| String |
aggregate_links (Facultatif) | Indique si les liens de superposition sont agrégés.
| Boolean |
sum_fields [sum_fields,...] (Facultatif) | Spécifie le ou les champ(s) numérique(s) contenant les valeurs attributaires utilisées pour 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. 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 :
| Value Table |
Exemple de code
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")
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)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?