Mesurer la cannibalisation (Business Analyst)

Disponible avec une licence Business Analyst.

Synthèse

Calculer l’envergure de la superposition entre deux polygones 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

Illustration de l’outil Mesurer la cannibalisation

Utilisation

  • Les mesures décrivant les zones de superposition 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 mode 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 concernés.

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

  • Par défaut, quatre mesures comparent les proportions de la zone de superposition 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 autres champs respectent le modèle des mesures standards mais utilisent des valeurs de variable au lieu d’une zone.

    Si l’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 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 sortie contient uniquement la géométrie superposée de l’entrée.

  • Les polygones doivent provenir d’une seule classe d’entités. Plusieurs classes d’entités peuvent être fusionnées en une classe d’entités unique à l’aide de l’outil Fusionner.

  • Le document Interpréter un rapport Mesurer la cannibalisation est un document PDF que vous pouvez utiliser pour comprendre les différentes sections et les différents éléments du rapport Mesurer la cannibalisation.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Entités surfaciques en entrée qui sont analysées pour détecter les superpositions.

Feature Layer
ID de la zone de chalandise

Champ qui identifie de manière unique chaque entité de la couche en entrée.

Field
Description de la zone de chalandise

Champ qui décrit chaque entité de la couche en entrée.

Field
Classe d’entités en sortie

Classe d’entités en sortie qui contient les zones de superposition détectées dans la couche en entrée.

Feature Class
Champ ID du point de vente
(Facultatif)

ID unique qui associe un point de vente à chaque polygone lorsque les entrées sont des zones de chalandise.

Field
Créer un rapport
(Facultatif)

Indique si un rapport sera généré.

  • Activé : un rapport sera généré.
  • Désactivé : aucun rapport ne sera généré. Il s’agit de l’option par défaut.
Boolean
Titre du rapport
(Facultatif)

Titre du rapport. La valeur par défaut est Measure Cannibalization.

String
Dossier du rapport en sortie
(Facultatif)

Emplacement en sortie dans lequel le rapport sera enregistré.

Folder
Formats en sortie du rapport
(Facultatif)

Le ou les formats en sortie du rapport.

String
Variables
(Facultatif)

Une ou plusieurs variables servant à calculer des mesures de superposition 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 superposition.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Rapport en sortie

Le ou les fichiers de rapport en sortie.

File

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})
NomExplicationType de données
in_features

Entités surfaciques en entrée qui sont analysées pour détecter les superpositions.

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 contient 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_REPORTUn rapport sera généré.
  • DO_NOT_CREATE_REPORTAucun 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.

String
report_folder
(Facultatif)

Emplacement en sortie dans lequel le rapport sera enregistré.

Folder
report_format
[report_format,...]
(Facultatif)

Le ou les formats en sortie du rapport.

String
variables
[variables,...]
(Facultatif)

Une ou plusieurs variables servant à calculer des mesures de superposition 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 superposition.

String

Sortie obtenue

NomExplicationType de données
output_report

Le ou les fichiers de rapport en sortie.

File

Exemple de code

Exemple d’utilisation de la fonction MeasureCannibalization (fenêtre Python)

Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction 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")

Informations de licence

  • Basic: Nécessite Business Analyst
  • Standard: Nécessite Business Analyst
  • Advanced: Nécessite Business Analyst

Rubriques connexes