Générer des lignes d’attraction (Business Analyst)

Disponible avec une licence Business Analyst.

Synthèse

Génère une série de lignes entre chaque client et un emplacement de point de vente associé. Ces lignes sont souvent appelées diagrammes en étoile. L’outil peut également générer un rapport Rose des vents facultatif à partir de la sortie.

Remarque :

Cet outil est analogue à l’outil Générer des liens origine-destination qui se trouve dans le jeu d’outils Proximité de la boîte d’outils d’analyse.

Illustration

Illustration de l'outil Générer des lignes d’attraction

Utilisation

  • La couche de points de vente et la couche de clients doivent chacune être une classe d’entités ponctuelles.

  • La génération de lignes d’attraction avec un temps de trajet et une distance à parcourir prend plus de temps que d’utiliser la méthode de distance (euclidienne) en ligne droite.

  • La sortie présente la distribution spatiale entre les valeurs des paramètres Couche de points de vente et Couche de clients et calcule les valeurs de distance entre chaque point de vente et chaque client.

  • L’activation du paramètre facultatif Créer un rapport crée un rapport Rose des vents, qui visualise la répartition des clients autour de chaque point de vente.

  • Le rapport Interpréter la rose des vents est un document PDF que vous pouvez utiliser pour comprendre les différents éléments et sections du rapport Rose des vents.

Paramètres

ÉtiquetteExplicationType de données
Couche de points de vente

Couche de points en entrée représentant l’emplacement des points de vente ou des installations.

Feature Layer
Couche de clients

Couche de points en entrée représentant des clients ou usagers.

Feature Layer
Classe d’entités en sortie

La classe d’entités obtenue qui va être ajoutée à la fenêtre Contents (Contenu).

Feature Class
Champ ID du point de vente

Champ d’identifiant unique représentant l’emplacement d’un point de vente ou d’une installation.

Field
Champ ID de point de vente associé

Champs d'ID utilisé pour affecter des clients individuels aux points de vente.

Field
Type de distance
(Facultatif)

Méthode de calcul allant être utilisée pour calculer la distance. Ligne droite est définie par défaut.

Lorsque vous utilisez Portal for ArcGIS ou des sources de données locales, les options de mode de déplacement sont remplies de manière dynamique.

String
Unités de mesure
(Facultatif)

Type des unités de distance ou de mesure temporelle à utiliser pour calculer la distance minimale.

String
Limite
(Facultatif)

Distance au-delà de laquelle les clients sont considérés comme environnants et exclus de la génération de la ligne de désir.

Double
Sens de déplacement
(Facultatif)

Spécifie le sens de déplacement qui sera utilisé entre les points de vente et les points de demande.

  • Vers les points de venteLa direction de déplacement va des points de demande vers les points de vente. Il s’agit de l’option par défaut.
  • Depuis les points de venteLa direction de déplacement va des points de vente vers les points de demande.
String
Heure du jour
(Facultatif)

Heure à laquelle le déplacement commence.

Date
Fuseau horaire
(Facultatif)

Spécifie le fuseau horaire qui sera utilisé pour le paramètre Heure du jour.

  • UTCLe temps universel coordonné (UTC) est utilisé. Choisissez cette option pour choisir le meilleur emplacement à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouvent les points de vente ou les points de demande.
  • Heure locale des localisationsLe fuseau horaire dans lequel se trouvent les points de vente ou les points de demande est utilisé. Si la valeur de Feuille de route est À l'écart des points de vente, il s’agit du fuseau horaire des points de vente. Si la valeur de Feuille de route est Vers les points de vente, il s’agit du fuseau horaire des points de demande. Il s’agit de l’option par défaut.
  • UTCLe temps universel coordonné (UTC) est utilisé. Choisissez cette option pour choisir le meilleur emplacement à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouvent les points de vente ou les points de demande.
  • Heure locale des localisationsLe fuseau horaire dans lequel se trouvent les points de vente ou les points de demande est utilisé. Si la valeur de travel_direction est AWAY_FROM_STORES, il s’agit du fuseau horaire des points de vente. Si la valeur de travel_direction est TOWARD_STORES, il s’agit du fuseau horaire des points de demande. Il s’agit de l’option par défaut.
String
Créer un rapport
(Facultatif)

Indique si un rapport de rose des vents va être créé.

  • Activé : un rapport sera créé.
  • Désactivé : aucun rapport ne sera créé. Il s’agit de l’option par défaut.
Boolean
Titre du rapport
(Facultatif)

Titre du rapport de rose des vents.

String
Dossier du rapport en sortie
(Facultatif)

Répertoire en sortie contenant le rapport de rose des vents.

Folder
Format du rapport
(Facultatif)

Un ou plusieurs formats de rapport en sortie. La valeur par défaut est PDF. Les formats disponibles supplémentaires sont les formats XLSX, HTML, CSV et PAGX.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Rapport en sortie

Fichier de rapport en sortie.

File

arcpy.ba.DesireLines(in_stores_layer, in_customers_layer, out_feature_class, store_id_field, link_field, {distance_type}, {units}, {cutoff}, {travel_direction}, {time_of_day}, {time_zone}, {create_report}, {report_title}, {report_folder}, {report_format})
NomExplicationType de données
in_stores_layer

Couche de points en entrée représentant l’emplacement des points de vente ou des installations.

Feature Layer
in_customers_layer

Couche de points en entrée représentant des clients ou usagers.

Feature Layer
out_feature_class

La classe d’entités obtenue qui va être ajoutée à la fenêtre Contents (Contenu).

Feature Class
store_id_field

Champ d’identifiant unique représentant l’emplacement d’un point de vente ou d’une installation.

Field
link_field

Champs d'ID utilisé pour affecter des clients individuels aux points de vente.

Field
distance_type
(Facultatif)

Méthode de calcul allant être utilisée pour calculer la distance. Ligne droite est définie par défaut.

Lorsque vous utilisez Portal for ArcGIS ou des sources de données locales, les options de mode de déplacement sont remplies de manière dynamique.

String
units
(Facultatif)

Type des unités de distance ou de mesure temporelle à utiliser pour calculer la distance minimale.

String
cutoff
(Facultatif)

Distance au-delà de laquelle les clients sont considérés comme environnants et exclus de la génération de la ligne de désir.

Double
travel_direction
(Facultatif)

Spécifie le sens de déplacement qui sera utilisé entre les points de vente et les points de demande.

  • TOWARD_STORESLa direction de déplacement va des points de demande vers les points de vente. Il s’agit de l’option par défaut.
  • AWAY_FROM_STORESLa direction de déplacement va des points de vente vers les points de demande.
String
time_of_day
(Facultatif)

Heure à laquelle le déplacement commence.

Date
time_zone
(Facultatif)

Spécifie le fuseau horaire qui sera utilisé pour le paramètre time_of_day.

  • UTCLe temps universel coordonné (UTC) est utilisé. Choisissez cette option pour choisir le meilleur emplacement à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouvent les points de vente ou les points de demande.
  • TIME_ZONE_AT_LOCATIONLe fuseau horaire dans lequel se trouvent les points de vente ou les points de demande est utilisé. Si la valeur de travel_direction est AWAY_FROM_STORES, il s’agit du fuseau horaire des points de vente. Si la valeur de travel_direction est TOWARD_STORES, il s’agit du fuseau horaire des points de demande. Il s’agit de l’option par défaut.
String
create_report
(Facultatif)

Indique si un rapport de rose des vents va être créé.

  • CREATE_REPORTUn rapport sera créé.
  • DO_NOT_CREATE_REPORTAucun rapport ne sera créé. Il s’agit de l’option par défaut.
Boolean
report_title
(Facultatif)

Titre du rapport de rose des vents.

String
report_folder
(Facultatif)

Répertoire en sortie contenant le rapport de rose des vents.

Folder
report_format
[report_format,...]
(Facultatif)

Un ou plusieurs formats de rapport en sortie. La valeur par défaut est PDF. Les formats disponibles supplémentaires sont les formats XLSX, HTML, CSV et PAGX.

String

Sortie obtenue

NomExplicationType de données
output_report

Fichier de rapport en sortie.

File

Exemple de code

Exemple d'utilisation du script DesireLines (script autonome)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction DesireLines.

import arcpy
arcpy.env.baDataSource = "ONLINE;US;"
arcpy.ba.DesireLines("Hubs", "grocery stores", r"C:\Temp\Output.gdb\Hubs_DesireLines", "Loc_name", "Loc_name", "STRAIGHT_LINE_DISTANCE", "MILES", 15, "TOWARD_STORES", None, "TIME_ZONE_AT_LOCATION")
Exemple d’utilisation du script DesireLines avec un rapport de rose des vents (script autonome)

Le script ci-dessous pour la fenêtre Python illustre la génération d’un rapport de rose des vents avec la fonction DesireLines.

import arcpy
arcpy.env.baDataSource = "ONLINE;US;"
arcpy.ba.DesireLines("grocery stores", "grocery customers", r"C:\Temp\Output.gdb\grocery stores_DesireLines", "USER_STORE_ID", "USER_STORE_ID", "STRAIGHT_LINE_DISTANCE", "MILES", None, "TOWARD_STORES", None, "TIME_ZONE_AT_LOCATION", "CREATE_REPORT", '', r"C:\Temp\Output.gdb\DesireLines", "PDF")

Informations de licence

  • Basic: Nécessite Business Analyst, ArcGIS Network Analyst extension
  • Standard: Nécessite Business Analyst, ArcGIS Network Analyst extension
  • Advanced: Nécessite Business Analyst, ArcGIS Network Analyst extension

Rubriques connexes