Lignes d'attraction

Disponible avec une licence Business Analyst.

Résumé

Crée 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.

Pour en savoir plus sur le fonctionnement de l'outil Lignes d'attraction

Illustration

Utilisation

• Dans la plupart des cas, la couche de points de vente en entrée sera une couche de points de vente Business Analyst.

• La couche de points de vente doit être une classe d'entités ponctuelles.

• Dans ArcMap, les lignes d'attraction sont tracées uniquement avec les points de clientèle qui se trouvent à l'intérieur de la zone d'étude ou de l'étendue d'analyse active. Si vous souhaitez tracer des lignes d'attraction avec tous les points de clientèle, vérifiez que tous les clients se trouvent à l'intérieur de l'étendue d'analyse.

• La création 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.

• Cochez la case Add Distance to Customer Layer (Ajouter la distance à la couche de clients) pour ajouter la distance entre le point de client et l’emplacement de point de vente associé pour chaque enregistrement client.

• Seuls les clients qui se trouvent à l'intérieur de la zone d'étude ou de l'étendue active sont utilisés dans cette analyse.

• Utilisez l'outil Attribuer par implantation la plus proche ou Attribuer par zone de chalandise dans le jeu d'outils Intégration des clients si vos clients ne sont pas déjà attribués à une implantation.

Syntaxe

arcpy.ba.DesireLines(InputFeatureLayer, IDField, All_Or_Single_Or_Selected, CustomerLayer, LinkField, DistanceCalculateMethod, MeasureUnitsForDistanceField, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site}, {UseSelectedFeatures}, {ExcludeOutlyingCustomers}, {CutOffDistance}, {MeasureUnits}, {AddDistanceToBusiness}, {WayToDefineDistanceField}, {DesireLinesDistanceField}, {NameField}, {BarrierFeatureClasses})

Paramètre	Explication	Type de données
InputFeatureLayer	Couche d'entités en entrée contenant les points centraux des lignes d'attraction. Les lignes d'attraction sont tracées à partir de ces entités.	Feature Layer
IDField	Champ identifiant de manière unique chaque point de vente.	Field
All_Or_Single_Or_Selected	Exécute une analyse de ligne d'attraction sur un ou plusieurs points de vente. ALL —Exécute une analyse sur tous les points de vente. Il s’agit de l’option par défaut. SINGLE —Exécute une analyse sur un seul point de vente.	String
CustomerLayer	Contient les points de clients pour les lignes d'attraction. Les lignes d'attraction sont tracées entre le point de vente et ces entités.	Feature Layer
LinkField	Champ ID de point de vente de la couche de clients qui attribue chaque client à un point de vente.	Field
DistanceCalculateMethod	Méthode utilisée pour dériver la longueur de chaque ligne d'attraction. DRIVE_TIME —Temps de trajet mesuré en unités de temps. DRIVE_DISTANCE —Distance de trajet mesurée en unités de distance. STRAIGHT_LINE_DISTANCE —Distance en ligne droite. Il s’agit de l’option par défaut.	String
MeasureUnitsForDistanceField	Unités utilisées avec les valeurs de distance. Decimal Degrees Feet Kilometers Meters Miles —Il s’agit de l’option par défaut. Nautical Miles Yards	String
OutputFeatureClass	Classe d'entités qui contiendront les lignes d'attraction.	Feature Class
ByID_Or_ByName (Facultatif)	Champ utilisé pour sélectionner un seul point. ID —Sélectionne un seul point à l'aide du champ d'ID de point de vente. Name —Sélectionne un seul point à l'aide du champ de nom de point de vente.	String
Single_Site (Facultatif)	ID ou nom du point de vente à utiliser comme point unique.	String
UseSelectedFeatures (Facultatif)	Utilise uniquement les entités sélectionnées pour générer les lignes d'attraction. True —Génère des lignes d'attraction sur les entités sélectionnées. False —Génère des lignes d'attraction sur toutes les entités.	Boolean
ExcludeOutlyingCustomers (Facultatif)	Permet de définir une distance limite pour supprimer les points environnants de l'analyse. True —Exclut les clients environnants. False —Inclut les clients environnants.	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. Decimal Degrees Feet Kilometers Meters Miles —Il s’agit de l’option par défaut. Nautical Miles Yards	String
AddDistanceToBusiness (Facultatif)	Ajoute un nouveau champ qui contiendra la distance calculée vers chaque point de vente pour chaque enregistrement de client. True —Ajoute un champ de distance à la couche de clients. False —N'ajoute pas de champ de distance à la couche de clients. Il s’agit de l’option par défaut.	Boolean
WayToDefineDistanceField (Facultatif)	Utilise un champ de distance existant dans la couche de clients pour stocker la longueur de chaque ligne d'attraction. CREATE_NEW —Crée un champ d'attribut pour la distance. Il s’agit de l’option par défaut. USE_EXISTING —Utilise un champ d'attribut existant pour la distance.	Boolean
DesireLinesDistanceField (Facultatif)	Champ qui contiendra la distance calculée dans l'analyse.	String
NameField (Facultatif)	Ce champ contient le nom du point de vente, qui est généralement au format chaîne.	Field
BarrierFeatureClasses [BarrierFeatureClasses,...] (Facultatif)	Permet à un utilisateur de placer des interruptions ponctuelles, linéaires ou polygonales lorsqu'il utilise des algorithmes de temps de trajet ou de distance à parcourir pour calculer des distances.	Feature Layer

Exemple de code

Exemple d'utilisation du script DesireLines (script autonome)

# Name: DesireLines.py
# Description: Creates a spider diagram between stores and customers in San Francisco using a straight line distance calculation.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox(r"C:\Program Files (x86)\ArcGIS\Desktop10.8\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business")
 
# Define the parameters for the Desire Lines tool
  InputFeatureLayer = "Default Group Layer/sf_stores"
  IDField =  "STORE_ID"
  All_Or_Single_Or_Selected = "ALL"
  CustomerLayer = "Default Group Layer/sf_custs"
  LinkField = "STORE_ID"
  DistanceCalculateMethod = "STRAIGHT_LINE_DISTANCE"
  MeasureUnitsForDistanceField = "Miles"
  OutputFeatureClass = "C:\My Output Data\Projects\Default Project\Analyses\DesireLines_4\StoreLayer_DesireLines.shp"
 
# Create Desire Line output file
  arcpy.DesireLines_ba(InputFeatureLayer, 
	IDField, 
	All_Or_Single_Or_Selected, 
	CustomerLayer,
	LinkField,					  
	DistanceCalculateMethod, 
	MeasureUnitsForDistanceField, 
	OutputFeatureClass)
 
# Release extension license 
arcpy.CheckInExtension("Business")

Environnements

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

Informations de licence

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