Taux de pénétration—Aide

Disponible avec une licence Business Analyst.

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

Résumé

Calcule le taux de pénétration en fonction des données clients au sein d'une zone.

En savoir plus sur le fonctionnement du taux de pénétration

Utilisation

La référence spatiale de la classe d'entités en sortie sera la même que celle de la couche qui permet de calculer le taux de pénétration.
La couche permettant de calculer le taux de pénétration doit être une couche de zones de chalandise ou être composée de données Business Analyst.
La couche de clients doit être une classe d'entités ponctuelles.
Dans la plupart des cas, la couche d'entités en entrée Couche de clients sera une couche de clients Business Analyst.
Lors du calcul du taux de pénétration, les pourcentages finaux découlent directement du nombre de clients utilisés dans l'outil. Si vous comparez le taux de pénétration de vos clients (en vous basant sur 1 000 clients) dans une grande agglomération à la population totale, le taux de pénétration (pourcentage) sera très faible. Ces pourcentages constituent toutefois un outil précieux si l'on prend en compte le marché que vous tentez de pénétrer.
Vous pouvez utiliser cet outil avec les zones de chalandise pour calculer les performances et le taux de pénétration des zones de chalandise de vos points de vente. Dans ce cas, définissez le paramètre Couche pour le calcul du taux de pénétration sur votre couche de zones de chalandise.
Vous pouvez également calculer le taux de pénétration en fonction d'un champ de pondération dans la couche de clients au lieu du nombre de clients. Par exemple, vous pouvez calculer le taux de pénétration en fonction des ventes totales par ménage pour chaque code postal.
Lorsque vous utilisez cet outil dans Python, les paramètres MarketPenetrationTMCField (Champ de potentiel de marché), InputGeographyLevel (Niveau géographique) et MarketPenetrationTMCSummarization (Champ de récapitulatif) ne sont pas facultatifs, mais ils peuvent être ignorés en attribuant la valeur # aux paramètres que vous ne souhaitez pas configurer.

Syntaxe

MarketPenetration_ba (MarketPenetrationLayer, MarketPenetrationAreaID, IN_MP_AREA_DESCR, CustomerLayer, MarketPenetrationTMCType, OutputFeatureClass, {MarketPenetrationUseSelectedMPAreas}, IN_MP_STORE_ID, {UseSelectedCustomers}, {CustomerWeightField}, {MarketPenetrationTMCField}, {InputGeographyLevel}, {MarketPenetrationTMCSummarization}, {IN_CL_STORE_ID}, {ReportTitle}, {MarketPenetrationReportDirectory}, {ReportFormats}, {CreateReport})

Paramètre	Explication	Type de données
MarketPenetrationLayer	Classe d'entités en entrée utilisée pour calculer les valeurs du taux de pénétration.	Feature Layer
MarketPenetrationAreaID	Champ ID unique dans la couche du taux de pénétration.	Field
IN_MP_AREA_DESCR	Champ utilisé pour décrire ou nommer chaque entité dans la couche du taux de pénétration.	Field
CustomerLayer	Classe d'entités en entrée (généralement une couche de clients) qui sera utilisée pour déterminer le taux de pénétration.	Feature Layer
MarketPenetrationTMCType	Méthode qui sera utilisée pour calculer les valeurs du taux de pénétration. In the layer attribute table —Calcule le taux de pénétration en fonction d'un champ existant dans la couche en entrée. Calculate using geography level —Calcule le taux de pénétration en fonction des données Business Analyst. Calculate using online data —Calcule le taux de pénétration en fonction des données ArcGIS Online.	String
OutputFeatureClass	Classe d'entités devant contenir les entités du taux de pénétration.	Feature Class
MarketPenetrationUseSelectedMPAreas (Facultatif)	Entités utilisées pour calculer le taux de pénétration. TRUE —Utilise les entités sélectionnées pour calculer le taux de pénétration. FALSE —Calcule le taux de pénétration sur toutes les entités. Il s'agit de l'option par défaut.	Boolean
IN_MP_STORE_ID	Identifiant unique associé à chaque point de vente.	Field
UseSelectedCustomers (Facultatif)	Entités de la couche de clients permettant de calculer les valeurs du taux de pénétration. TRUE —Utilise les entités sélectionnées de la couche de clients pour calculer les valeurs du taux de pénétration. FALSE —Calcule les valeurs du taux de pénétration en fonction de tous les points de clients. Il s'agit de l'option par défaut.	Boolean
CustomerWeightField (Facultatif)	Utilise un champ de pondération dans la couche de clients au lieu du nombre de clients pour calculer les valeurs du taux de pénétration. Par exemple, vous pouvez calculer le taux de pénétration en fonction des ventes totales par ménage pour chaque code postal.	Field
MarketPenetrationTMCField (Facultatif)	Champ attributaire contenant les valeurs du calcul du taux de pénétration.	Field
InputGeographyLevel (Facultatif)	Niveau géographique contenant le nombre de marchés pour le taux de pénétration.	Feature Layer
MarketPenetrationTMCSummarization (Facultatif)	Attribut qui servira à calculer le nombre total de marchés dans le niveau géographique standard.	Field
IN_CL_STORE_ID (Facultatif)	ID unique servant de liaison entre le fichier des clients et le fichier des points de vente.	Field
ReportTitle (Facultatif)	Titre du rapport.	String
MarketPenetrationReportDirectory (Facultatif)	Le rapport est créé dans ce dossier en sortie.	Folder
ReportFormats [ReportFormat,...,...] (Facultatif)	Un ou plusieurs formats dans lesquels le rapport sera généré. Si vous utilisez l'appel de fonction Python, entrez les valeurs sous forme de chaîne au format suivant : "PremierFormat; DeuxièmeFormat; TroisièmeFormat", etc. Par exemple : "html;pdf;s.xlsx;s.xml;xlsx" (Une chaîne des noms de format souhaités délimités par des points-virgules.) Simple XML —Entrez "s.xml" pour le format XML simple PDF —Entrez "pdf" pour le format PDF HTML —Entrez "html" pour le format HTML CSV —Entrez "csv" pour le format CSV ZIP —Entrez "zip" pour le format ZIP XLSX —Entrez "xlsx" pour le format XLSX Stripped XLSX —Entrez "s.xlsx" pour le format XLSX simplifié	String
CreateReport (Facultatif)	Génère un rapport. True —Un rapport d'agrégation des points sera généré. Il s'agit de l'option par défaut. False —Aucun rapport d'agrégation des points ne sera généré.	Boolean

Exemple de code

Exemple d'utilisation du script MarketPenetration (script autonome)# Name: MarketPenetration.py
# Description: Calculates how well customers in the San Francisco penetrate the households in that market.
# 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")
  
# Acquire extension license 
arcpy.CheckOutExtension("Business") 
 
# Define input and output parameters for the Market Penetration tool
MarketPenetrationLayer = "C:/ArcGIS/Business Analyst/US_2017/Data/Demographic Data/esri_bg.bds"
MarketPenetrationAreaID="ID" 
IN_MP_AREA_DESCR="NAME" 
CustomerLayer = "C:/temp/sf_cust.shp"
MarketPenetrationTMCType = "In the layer attribute table" 
OutputFeatureClass = "C:/temp/Marketpenetration.shp"
MarketPenetrationUseSelectedMPAreas = "false"  
IN_MP_STORE_ID = "STATE_NAME"  
UseSelectedCustomers = "false"  
CustomerWeightField = ""  
IN_CL_STORE_ID = ""  
MarketPenetrationTMCField = "TOTHH_CY"
OutputFeatureClass = "C:/temp/Marketpenetration.shp"
InputGeographyLevel = ""  
MarketPenetrationTMCSummarization = ""  
ReportTitle = "Determine Market Penetration"  
MarketPenetrationReportDirectory = "C:/My Output Data/Projects/Default Project/Reports/MarketPenetration"  
ReportFormats = "pdf;xlsx;zip;s.xlsx"
 
# Create a Market Penetration output    
arcpy.MarketPenetration_ba(MarketPenetrationLayer,
						MarketPenetrationAreaID,
						IN_MP_AREA_DESCR, 
						CustomerLayer,
						MarketPenetrationTMCType, 
						OutputFeatureClass,
						MarketPenetrationUseSelectedMPAreas,
						IN_MP_STORE_ID,
						UseSelectedCustomers,  
						CustomerWeightField,  
						IN_CL_STORE_ID, 
						MarketPenetrationTMCField,
						OutputFeatureClass,
						InputGeographyLevel,  
						MarketPenetrationTMCSummarization, 
						ReportTitle,  
						MarketPenetrationReportDirectory,  
						ReportFormats)

# Release extension license 
arcpy.CheckInExtension("Business")

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 Zones de chalandise