Modèle de Huff (Business Analyst)

Disponible avec une licence Business Analyst.

Résumé

Crée 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 Input Facility Features (Entités de ressource en entrée) est une couche de points qui représente les concurrents ou les points de vente existants.

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

  • L’outil Huff Model (Modèle de Huff) prend en compte tous les emplacements de la couche du paramètre Input Facility Features (Entités de ressource en entrée), mais une seule entité de la couche du paramètre Input Candidate Features (Entités candidates en entrée) dans une analyse. Vous pouvez limiter les emplacements inclus dans une analyse en sélectionnant la couche du paramètre Input Facility Features (Entités de ressource en entrée) ou Input Candidate Features (Entités candidates en entrée).

  • La valeur d’attractivité utilisée pour l’analyse doit être le même champ dans les paramètres Input Facility Features (Entités de ressource en entrée) et Input Candidate Features (Entités candidates en entrée).

  • La couche du paramètre Input Sales Potential Features (Entités de potentiel de vente en entrée) peut être une couche de points ou une couche de polygones 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 Enrich Layer (Enrichir la couche) peut être utilisé pour dériver la couche du paramètre Input Sales Potential Features (Entités de potentiel de vente en entrée).

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

Syntaxe

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})
ParamètreExplicationType de données
in_facility_features

Couche d’entités ponctuelles en entrée représentant l’emplacement 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 l’emplacement 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 Attractiveness (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é 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 (Ligne droite).

String
distance_units
(Facultatif)

Unités de mesure de la distance à utiliser pour calculer 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 Input Facility Features (Entités de ressource en entrée) et Input Candidate Features (Entités candidates en entrée) 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_STORESLe déplacement va des entités de potentiel de vente aux points de vente. Il s’agit de l’option par défaut.
  • AWAY_FROM_STORESLe déplacement va des points de vente aux 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 (Heure du jour).

  • TIME_ZONE_AT_LOCATIONLe fuseau horaire dans lequel se trouvent les secteurs est utilisé. Il s’agit de l’option par défaut.
  • UTCLe temps universel coordonné (UTC) est utilisé.
String

Sortie dérivée

NomExplicationType de données
out_predicted_sales

Modèle en sortie.

Double

Exemple de code

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

Le script de fenêtre Python ci-dessous 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")

Informations de licence

  • Basic: Requiert Business Analyst
  • Standard: Requiert Business Analyst
  • Advanced: Requiert Business Analyst

Rubriques connexes