Modèle de Huff (Business Analyst)

Disponible avec une licence Business Analyst.

Synthèse

Créer une surface de probabilité visant à prévoir le potentiel de vente d’une zone en fonction de la distance et d’un facteur d’attractivité.

Utilisation

• La couche du paramètre Entités de ressource en entrée est une couche ponctuelle qui représente les concurrents ou les points de vente existants.

• La couche du paramètre Entités candidates en entrée est une couche ponctuelle qui représente la couche de points de vente potentiels à évaluer.

• L’outil Modèle de Huff prend en compte toutes les localisations de la couche du paramètre Entités de ressource en entrée, mais une seule entité de la couche du paramètre Entités candidates en entrée dans une analyse. Vous pouvez limiter les localisations incluses dans une analyse en sélectionnant soit la couche du paramètre Entités de ressource en entrée, soit la couche du paramètre Entités candidates en entrée.

• La valeur d’attractivité utilisée pour l’analyse doit correspondre au même champ dans les paramètres Entités de ressource en entrée et Entités candidates en entrée.

• La couche du paramètre Entités de potentiel de vente en entrée peut être une couche ponctuelle ou une couche surfacique incluant un champ numérique qui représente le potentiel de vente. Elle peut par exemple s’appuyer sur le revenu disponible, la population, ou toute autre variable.

• L’outil Enrichir la couche peut être utilisé pour dériver la couche du paramètre Entités de potentiel de vente en entrée.

• La distance géodésique est utilisée pour les calculs de distance.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités de ressource en entrée	Couche d’entités ponctuelles en entrée représentant la localisation des ressources existantes. Il s’agit de la première entité de la couche ou de l’entité sélectionnée lorsqu’une sélection est disponible.	Feature Layer
Champ ID de ressource	Champ d’ID unique pour les ressources existantes.	Field
Entités candidates en entrée	Couche d’entités ponctuelles en entrée représentant la localisation des nouvelles ressources candidates. Il s’agit de la première entité de la couche ou de l’entité sélectionnée lorsqu’une sélection est disponible.	Feature Layer
Champ ID candidat	Champ d’ID unique pour les ressources candidates.	Field
Entités de potentiel de vente en entrée	Couche d’entités ponctuelles ou surfaciques utilisée pour calculer le potentiel de vente. Il s’agit de toutes les entités d’une couche ou uniquement de celles qui sont sélectionnées lorsqu’une sélection est disponible.	Feature Layer
Champ ID de potentiel de vente	Champ d’ID unique pour les entités de potentiel de vente.	Field
Champ Potentiel de vente	Champ contenant les valeurs qui seront utilisées pour calculer le potentiel de vente.	Field
Classe d’entités en sortie	Classe d’entités en sortie qui contient les résultats de l’outil et représente la probabilité des ventes.	Feature Class
Variables d’attractivité	Champs attributaires qui indiquent l’attractivité de chaque concurrent. Il arrive fréquemment que la taille de la ressource remplace l’attractivité et qu’il s’agisse d’une table à plusieurs valeurs. Une variable d’attractivité supplémentaire est requise. Le champ Attractivité doit être présent sur les couches des ressources existantes (concurrents) et des ressources candidates. Existing Facilities Value : champ numérique de la couche du paramètre Entités de ressource en entrée qui représente l’attractivité. Candidates Location Value : champ numérique de la couche du paramètre Entités candidates en entrée qui correspond à la valeur d’attractivité issue de la couche du paramètre Entités de ressource en entrée. La distance ne nécessite pas de champ apparié. Exponent : valeur déterminant à quel point la variable est importante pour la valeur d’attractivité. La valeur par défaut est 1.	Value Table
Exposant de distance	Dans la mesure où l’attractivité diminue lorsque la distance augmente, l’exposant de distance est généralement un nombre négatif. La valeur par défaut est -1,5.	Double
Type de distance (Facultatif)	Type de distance qui sera utilisé, en fonction de la méthode de déplacement. La valeur par défaut est Straight Line.	String
Unités de distance (Facultatif)	Unités de mesure de la distance utilisées pour le calcul de la distance.	String
Matrice de distance en sortie (Facultatif)	Nom et emplacement de la table de la matrice de calcul des distances. Les ID des paramètres Entités de ressource en entrée et Entités candidates en entrée doivent être uniques.	Table
Sens de déplacement (Facultatif)	Spécifie le sens de déplacement qui sera utilisé entre les points de vente et les entités de potentiel de vente. Vers les points de vente—Le déplacement s’effectue des entités de potentiel de vente vers les points de vente. Il s’agit de l’option par défaut. Depuis les points de vente—Le déplacement s’effectue des points de vente vers les entités de potentiel de vente.	String
Date/heure du jour (Facultatif)	Date et heure utilisées pour le calcul de la distance.	Date
Fuseau horaire (Facultatif)	Spécifie le fuseau horaire qui sera utilisé pour le paramètre Date/heure du jour. Fuseau horaire de la localisation—Le fuseau horaire dans lequel se trouvent les secteurs est utilisé. Il s’agit de l’option par défaut. UTC—Le temps universel coordonné (UTC) est utilisé. Fuseau horaire de la localisation—Le fuseau horaire dans lequel se trouvent les secteurs est utilisé. Il s’agit de l’option par défaut. UTC—Le temps universel coordonné (UTC) est utilisé.	String

Sortie obtenue

Étiquette	Explication	Type de données
Ventes prévues	Modèle en sortie.	Double

Python

arcpy.ba.HuffModel(in_facility_features, facility_id_field, in_candidate_features, candidate_id_field, in_sales_potential_features, sales_potential_id_field, sales_potential_field, out_feature_class, attractiveness_variables, distance_exponent, {distance_type}, {distance_units}, {out_distance_matrix}, {travel_direction}, {time_of_day}, {time_zone})

Nom	Explication	Type de données
in_facility_features	Couche d’entités ponctuelles en entrée représentant la localisation des ressources existantes. Il s’agit de la première entité de la couche ou de l’entité sélectionnée lorsqu’une sélection est disponible.	Feature Layer
facility_id_field	Champ d’ID unique pour les ressources existantes.	Field
in_candidate_features	Couche d’entités ponctuelles en entrée représentant la localisation des nouvelles ressources candidates. Il s’agit de la première entité de la couche ou de l’entité sélectionnée lorsqu’une sélection est disponible.	Feature Layer
candidate_id_field	Champ d’ID unique pour les ressources candidates.	Field
in_sales_potential_features	Couche d’entités ponctuelles ou surfaciques utilisée pour calculer le potentiel de vente. Il s’agit de toutes les entités d’une couche ou uniquement de celles qui sont sélectionnées lorsqu’une sélection est disponible.	Feature Layer
sales_potential_id_field	Champ d’ID unique pour les entités de potentiel de vente.	Field
sales_potential_field	Champ contenant les valeurs qui seront utilisées pour calculer le potentiel de vente.	Field
out_feature_class	Classe d’entités en sortie qui contient les résultats de l’outil et représente la probabilité des ventes.	Feature Class
attractiveness_variables [[existing_facilities_value, candidates_location_value, exponent],...]	Champs attributaires qui indiquent l’attractivité de chaque concurrent. Il arrive fréquemment que la taille de la ressource remplace l’attractivité et qu’il s’agisse d’une table à plusieurs valeurs. Une variable d’attractivité supplémentaire est requise. Le champ Attractivité doit être présent sur les couches des ressources existantes (concurrents) et des ressources candidates. existing_facilities_value : champ numérique de la couche du paramètre in_facility_features qui représente l’attractivité. candidates_location_value : champ numérique de la couche du paramètre in_candidate_features qui correspond à la valeur d’attractivité issue de la couche du paramètre in_facility_features. La distance ne nécessite pas de champ apparié. exponent : valeur déterminant à quel point la variable est importante pour la valeur d’attractivité. La valeur par défaut est 1.	Value Table
distance_exponent	Dans la mesure où l’attractivité diminue lorsque la distance augmente, l’exposant de distance est généralement un nombre négatif. La valeur par défaut est -1,5.	Double
distance_type (Facultatif)	Type de distance qui sera utilisé, en fonction de la méthode de déplacement. La valeur par défaut est Straight Line.	String
distance_units (Facultatif)	Unités de mesure de la distance utilisées pour le calcul de la distance.	String
out_distance_matrix (Facultatif)	Nom et emplacement de la table de la matrice de calcul des distances. Les ID des paramètres in_facility_features et in_candidate_features doivent être uniques.	Table
travel_direction (Facultatif)	Spécifie le sens de déplacement qui sera utilisé entre les points de vente et les entités de potentiel de vente. TOWARD_STORES—Le déplacement s’effectue des entités de potentiel de vente vers les points de vente. Il s’agit de l’option par défaut. AWAY_FROM_STORES—Le déplacement s’effectue des points de vente vers les entités de potentiel de vente.	String
time_of_day (Facultatif)	Date et heure utilisées pour le calcul de la distance.	Date
time_zone (Facultatif)	Spécifie le fuseau horaire qui sera utilisé pour le paramètre time_of_day. TIME_ZONE_AT_LOCATION—Le fuseau horaire dans lequel se trouvent les secteurs est utilisé. Il s’agit de l’option par défaut. UTC—Le temps universel coordonné (UTC) est utilisé.	String

Sortie obtenue

Nom	Explication	Type de données
out_predicted_sales	Modèle en sortie.	Double

Exemple de code

Exemple d’utilisation de la fonction HuffModel (fenêtre Python)

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

import arcpy
arcpy.ba.HuffModel("starbucks_layer", "IDField", "potential_store_layer", "IDField", "HuffModelTestData.gdb\CT", "IDField", "TOTPOP_CY", "Starbucks_HuffModel", "SALES # 1", -1.5, "STRAIGHT_LINE_DISTANCE", "MILES", None, "TOWARD_STORES", None, "TIME_ZONE_AT_LOCATION")

Environnements

Espace de travail courant, Source de données, Source de réseau

Informations de licence

• Basic: Nécessite Business Analyst
• Standard: Nécessite Business Analyst
• Advanced: Nécessite Business Analyst