Mesurer la cannibalisation (Business Analyst)

Disponible avec une licence Business Analyst.

Résumé

Calcule l’envergure de la superposition entre deux polygone ou plus. La superposition se réfère à l’étendue des polygones au-delà de l’intersection.

Il est possible de créer un rapport facultatif qui détaille les statistiques de superposition.

Illustration

Utilisation

• Les mesures décrivant les zones cannibalisées figurent sous forme d’attributs dans la classe d’entités en sortie et dans un rapport facultatif.

• Vous pouvez sélectionner des variables démographiques et de style de vie issues du navigateur de données pour renvoyer des champs supplémentaires dans la sortie qui définissent les proportions dans les polygones affectés.

• La table attributaire en sortie comprend un enregistrement pour chaque occurrence de superposition entre les polygones.

• Par défaut, quatre mesures comparent les proportions de la zone cannibalisée et sont renvoyées sous la forme de quatre champs individuels dans la sortie :

  • A1 - proportion de la zone : ID 1 par rapport à ID 2 (surface du polygone ID1 / surface du polygone ID2)
  • A2 - proportion de la zone dans la superposition (surface de l’intersection du polygone ID1 et du polygone ID2 / surface de l’union du polygone ID1 et du polygone ID2)
  • A3 - proportion de la zone : ID 1 dans ID 2 (surface de l’intersection du polygone ID1 et du polygone ID2 / surface du polygone ID1)
  • A4 - proportion de la zone : ID 2 dans ID 1 (surface de l’intersection du polygone ID1 et du polygone ID2 / surface du polygone ID2)

• Vous pouvez sélectionner des variables à partir du navigateur de données pour les inclure dans la sortie sous forme de mesures supplémentaires.

• Si des mesures supplémentaires sont sélectionnées, cinq champs en sortie supplémentaires sont renvoyés. Le premier champ contient la valeur de la variable dans la zone de superposition. Les quatre champs suivants respectent le modèle des mesures standard mais utilisent des valeurs de variable à la place d’une zone.

• Si on prend l’exemple de la population de l’année en cours, les cinq champs de mesure supplémentaires suivants seraient renvoyés :

  • populationtotals_totpop_cy : population dans la zone de superposition
  • populationtotals_totpop_cy_A1 : proportion de population : ID 1 par rapport à ID 2
  • populationtotals_totpop_cy_A2 : proportion de la population dans la superposition
  • populationtotals_totpop_cy_A3 : proportion de population : ID 1 dans ID 2
  • populationtotals_totpop_cy_A4 : proportion de population : ID 2 dans ID 2

• Si les polygones ne se superposent pas, la classe d’entités en sortie ne contient aucune géométrie, ni aucun enregistrement. La classe d’entités en sottie contient uniquement la géométrie superposée de l’entrée.

• Les polygones doivent provenir d’une seule classe d’entités. Il est possible de fusionner plusieurs classes d’entités en une seule classe d’entités grâce à l’outil Combiner.

Syntaxe

arcpy.ba.MeasureCannibalization(in_features, area_id_field, area_description_field, out_feature_class, {store_id_field}, {create_report}, {report_title}, {report_folder}, {report_format}, {variables})

Paramètre	Explication	Type de données
in_features	Entités surfaciques en entrée à analyser dans le but de déterminer la superposition.	Feature Layer
area_id_field	Champ qui identifie de manière unique chaque entité de la couche en entrée.	Field
area_description_field	Champ qui décrit chaque entité de la couche en entrée.	Field
out_feature_class	Classe d’entités en sortie qui contiendra les zones de superposition détectées dans la couche en entrée.	Feature Class
store_id_field (Facultatif)	ID unique qui associe un point de vente à chaque polygone lorsque les entrées sont des zones de chalandise.	Field
create_report (Facultatif)	Indique si un rapport sera généré. CREATE_REPORT —Un rapport sera généré. DO_NOT_CREATE_REPORT —Aucun rapport ne sera généré. Il s’agit de l’option par défaut.	Boolean
report_title (Facultatif)	Titre du rapport. La valeur par défaut est Measure Cannibalization (Mesurer la cannibalisation) (Measure Cannibalization dans Python).	String
report_folder (Facultatif)	Emplacement en sortie dans lequel le rapport sera enregistré.	Folder
report_format [report_format,...] (Facultatif)	Le ou les format(s) en sortie du rapport.	String
variables [variables,...] (Facultatif)	Une ou plusieurs variables servant à calculer des mesures de cannibalisation supplémentaires : par exemple, le nombre total de personnes et de ménages dans les zones d’intersection, ou le pourcentage du nombre total de personnes et de ménages dans une zone de chalandise située dans la zone de cannibalisation.	String

Sortie dérivée

Nom	Explication	Type de données
output_report	Le ou les fichier(s) de rapport en sortie.	Fichier

Exemple de code

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

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil MeasureCannibalization.

import arcpy
arcpy.ba.MeasureCannibalization("SF_Stores_Rings", "AREA_ID", "AREA_DESC",
                                r"C:\ MyProject1\MyProject1.gdb\SF_Stores_RIngs_MeasureCannibalization",
                                "STORE_ID", "CREATE_REPORT",
                                "Measure Cannibalization",
                                r"C:\ MyProject1\MeasureCannibalization", "PDF")

Environnements

Espace de travail courant, Source de données

Informations de licence

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