Calibrage du modèle de Huff par données réelles—Aide

Disponible avec une licence Business Analyst.

Résumé
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Résumé

Calibre statistiquement le modèle de Huff à l'aide des données clients observées pour l'emplacement de chaque point de vente dans la zone d'étude.

Pour en savoir plus sur l'outil Calibrage du modèle de Huff par données réelles

Utilisation

Lors de l'exécution de cet outil, la première étape consiste à définir une zone d'étude qui englobe toutes les zones de chalandise de tous les points de vente concurrents en cours d'analyse.
La sortie de calibrage de cet outil est utilisé en entrée pour le modèle avancé de Huff.
Les données clients doivent contenir des informations issues d'un échantillon de ménages dans chaque sous-région de la zone d'étude. Des données clients doivent être présentes pour l'emplacement de chaque point de vente existant et concurrent dans la zone d'étude. Les informations clients sont converties dans le modèle selon les proportions de chaque sous-région.
La valeur du paramètre Niveau géographique des clients potentiels correspond généralement à des entités surfaciques représentant les zones secondaires où vivent les clients potentiels. Vous pouvez également utiliser des entités ponctuelles, par exemple des centroïdes d'îlots auxquels des données démographiques sont associées.
La couche de points de vente concurrents doit inclure les emplacements de tous les concurrents dans une zone d'étude donnée. Cette couche doit également comprendre les emplacements de vos points de vente existants dans la zone d'étude, car ils agiront comme des concurrents face à l'implantation d'un nouveau point de vente. Dans la plupart des cas, la couche de points de vente concurrents sera une couche de points de vente Business Analyst.
Les emplacements des points de vente concurrents peuvent être extraits à partir de la fonction Ajouter des listes d'entreprises existante dans Business Analyst.Pour en savoir plus sur l'ajout de listes d'entreprises
Les champs d'attraction du point de vente, également connus comme valeurs prédictives, incluent souvent les attributs d'un point de vente, tels que la surface, le nombre de places de stationnement, la publicité, les heures d'ouverture, les prix, l'âge, l'apparence, la signalisation, l'accessibilité et ainsi de suite.

Syntaxe

HuffModelCalibrationByRealData_ba (PotenCustGeogLevel, GeogIDField, CustomersWithAssignedStoreID, AssociatedStoreID, StoreLayer, StoreIDField, StoreAttractionFields, DistanceCalculationMethod, OutputCalibrationFolder, {AnalizeSelectedCustomersOnly}, {ExcludeOutlyingCustomers}, {CutoffDistance}, {MeasureUnits}, {NeedReportOutput}, {ReportTitle}, {ReportFile}, {ReportFormats})

Paramètre	Explication	Type de données
PotenCustGeogLevel	Entités surfaciques représentant les zones secondaires où vivent les clients potentiels. Des entités ponctuelles (par exemple, des centroïdes d'îlots) auxquelles des données démographiques sont associées peuvent également être utilisées.	Feature Layer
GeogIDField	Identifiant unique du niveau géographique Clients potentiels.	Field
CustomersWithAssignedStoreID	Entités ponctuelles (généralement, un fichier de clients Business Analyst) contenant des données et un ID point de vente associé.	Feature Layer
AssociatedStoreID	Champ ID de point de vente de la couche de clients qui attribue chaque client à un point de vente.	Field
StoreLayer	Couche contenant les points concurrents (généralement des points de vente) utilisés pour déterminer comment les ventes sont influencées et réparties sur toute la zone d'analyse.	Feature Layer
StoreIDField	Identifiant unique de la couche de points de vente concurrents.	Field
StoreAttractionFields [StoreAttractionFields,...]	Valeurs mesurant le niveau d'attractivité d'un point de vente aux yeux des consommateurs.	Field
DistanceCalculationMethod	Alloue la méthode utilisée pour calculer les distances entre les zones géographiques définies par le paramètre de la couche des clients potentiels et les points de vente issus de la couche de points de vente concurrents. STRAIGHT_LINE_DISTANCE —Approche euclidienne (distance à vol d'oiseau). DRIVE_DISTANCE —Distance de trajet mesurée en unités de distance. DRIVE_TIME —Temps de trajet mesuré en unités de temps.	String
OutputCalibrationFolder	Dossier en sortie qui contiendra le fichier de résultat du calibrage du modèle de Huff.	Folder
AnalizeSelectedCustomersOnly (Facultatif)	Utilise uniquement les entités sélectionnées pour générer le calibrage du modèle de Huff par données réelles. True —Génère le calibrage du modèle de Huff sur les entités sélectionnées dans la couche de clients. False —Génère le calibrage du modèle de Huff sur toutes les entités dans la couche de clients.	Boolean
ExcludeOutlyingCustomers (Facultatif)	Définit facultativement une distance limite pour supprimer les points environnants du modèle. True —Exclut les clients environnants. False —Inclut tous les clients dans l'analyse.	Boolean
CutoffDistance (Facultatif)	Seuil auquel exclure les clients environnants de l'analyse.	Double
MeasureUnits (Facultatif)	Unités utilisées avec les valeurs de distance. Par défaut, les unités définies dans les préférences de Business Analyst seront sélectionnées. Minutes Decimal Degrees Feet Kilometers Meters Miles Nautical Miles Yards	String
NeedReportOutput (Facultatif)	Génère un rapport de calibrage du modèle de Huff en fonction des données réelles. True —Génère le rapport de calibrage du modèle de Huff. False —Ne génère pas le rapport de calibrage du modèle de Huff.	Boolean
ReportTitle (Facultatif)	Titre du rapport de calibrage.	String
ReportFile (Facultatif)	Nom de fichier du rapport de calibrage.	String
ReportFormats [ReportFormats,...] (Facultatif)	Format du rapport en sortie. Vous pouvez sélectionner plusieurs formats. Simple XML PDF HTML CSV ZIP XLSX Stripped XLSX	String

Exemple de code

Exemple d'utilisation du script HuffModelCalibrationByRealData (script autonome)

# Name: HuffModelCalibrationByRealData.py
# Description: Generates a calibrated model around two San Francisco stores using Sales as a predictor.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.6\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")


try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business")
  arcpy.CheckOutExtension("Network") 
 
 
# Define input and output parameters for the Huff Model Calibration by Real Data tool
  Potential = "C:/ArcGIS/Business Analyst/US_2017/Data/BDS/esri_bg.bds"
  SalesId = "ID"
  Cust = "C:/temp/sf_cust.shp"
  AssocStoreId = "STORE_ID"
  Store = "C:/temp/sf_stores.shp"
  StoreId = "STORE_ID"
  AttractionField = "SALES"
  DistanceCalc = "DRIVE_TIME"
  OutPath = "C:/temp/Calibration_Realdata"
 
# Create Huff Model Calibration by Real Data
  arcpy.HuffModelCalibrationByRealData_ba(Potential,
	  SalesId,
	  Cust,
	  AssocStoreId,
	  Store,
	  StoreId,
	  AttractionField,
	  DistanceCalc,
	  OutPath)
 
# Release extension license 
  arcpy.CheckInExtension("Business")
  arcpy.CheckInExtension("Network")
 
except:
  print arcpy.GetMessages(2)

Environnements

Cet outil n'utilise pas d'environnement de géotraitement.

Informations de licence

ArcGIS Desktop Basic: Requiert Business Analyst
ArcGIS Desktop Standard: Requiert Business Analyst
ArcGIS Desktop Advanced: Requiert Business Analyst

Rubriques connexes

Vue d'ensemble du jeu d'outils Modélisation de Business Analyst