Polygone de répartition (Analyse)

Synthèse

Synthétise les attributs d’une couche surfacique en entrée en fonction de la superposition spatiale d’une couche surfacique cible et affecte les attributs synthétisés aux polygones cibles. Les polygones cibles comportent la somme des attributs numériques provenant des polygones en entrée sur lequel chacun se superpose. Ce processus est généralement connu sous le nom de répartition.

Cet outil peut servir à estimer la population d’une entité en fonction du pourcentage de l’entité en question, qui se superpose à une autre entité dont la population est connue.

Remarque :

  • L’outil Enrichir la couche utilise des paramètres d’agrégation et de répartition détaillés pour synchroniser les données.
  • L’outil Polygone de répartition est similaire à l’outil Enrichir la couche. Toutefois, l’outil Polygone de répartition utilise la répartition spécifiée tandis que l’outil Enrichir la couche utilise les points d’îlots de recensement ou les points de peuplement global des États-Unis pour la répartition. Pour plus d’information, reportez-vous à la rubrique Répartition des données.

Illustration

Illustration de l’outil Polygone de répartition
La somme partielle des attributs en entrée dans la cible est connue.

Utilisation

  • Par défaut, le pourcentage de la zone superposée détermine le pourcentage d’attributs transférés.

  • Un champ de pondération du polygone en entrée est normalisé et utilisé pour définir le pourcentage d’attributs transférés. Si le champ de pondération a la valeur 0, aucun attribut n’est réparti de l’entrée vers les cibles.

  • Si elle est spécifiée, la valeur du paramètre Entités d’estimation est utilisée pour déterminer comment les attributs sont transférés, au lieu de la surface. Les entités d’estimation doivent intersecter la valeur du paramètre Polygones en entrée pour être comptées. Si les entités d’estimation intersectent également la valeur du paramètre Polygones cibles, les attributs sont transférés depuis l’entité en entrée vers la cible.

  • Le paramètre Gérer la géométrie cible est utilisé pour inclure la géométrie cible ou l’intersection des géométries en entrée et cible dans la géométrie en sortie.

  • Cet outil respecte l’environnement Facteur de traitement parallèle. Si l’environnement n’est pas défini (valeur par défaut) ou s’il est défini sur 100, le traitement parallèle complet est activé et l’outil tente de répartir les tâches sur tous les cœurs logiques de la machine. Si vous définissez l’environnement sur 0, le traitement parallèle est désactivé. Si vous spécifiez un facteur compris entre 1 et 99, l’outil identifie le pourcentage de cœurs logiques à utiliser en appliquant la formule (Facteur de traitement parallèle / 100 * Cœurs logiques) arrondie à l’entier supérieur le plus proche. Si le résultat de cette formule est 0 ou 1, le traitement parallèle n’est pas activé.

Paramètres

ÉtiquetteExplicationType de données
Polygones en entrée

Entités surfaciques dotées d’attributs numériques à synthétiser dans les géométries surfaciques cibles.

Feature Layer
Champs à répartir

Les champs numériques des polygones en entrée qui seront synthétisés par chaque polygone cible et enregistrés dans la classe d’entités en sortie.

Field
Polygones cibles

Entités surfaciques et les champs répartis associés à copier dans la classe d’entités en sortie.

Feature Layer
Classe d’entités en sortie

La classe d’entités en sortie contenant l’attribut et les géométries des polygones cibles, ainsi que les champs de répartition spécifiés des polygones en entrée.

Feature Class
Méthode de répartition

Indique la méthode à utiliser pour répartir les champs des polygones en entrée vers les polygones cibles.

  • SurfaceLa contribution de chaque polygone en entrée dans les valeurs synthétisées pour chaque entité cible est déterminée par la zone superposée entre les deux entités. Si une entité en entrée chevauche deux entités cibles dans les mêmes proportions, les champs répartis sont divisés en deux et contribuent aux deux entités cibles par la moitié de la valeur totale. Il s’agit de l’option par défaut.
  • LongueurLes attributs des entités en entrée sont divisés en fonction du pourcentage de présence d’une ligne dans chaque entité cible. Seule la ligne qui intersecte l’entité en entrée est prise en compte dans le calcul. La ligne située en dehors de l’entité en entrée est exclue. Par exemple, si une entité cible couvre 750 mètres d’une ligne, et qu’une autre entité cible couvre 250  mètres d’une ligne, 75 % (750/1 000) des valeurs attributaires de l’entité en entrée sont agrégés dans la première entité cible, et 25 % (250/1 000) des valeurs attributaires de l’entité en entrée sont agrégés dans la seconde entité cible.
  • PointsLes attributs des entités en entrée sont divisés en fonction du nombre de points compris dans chaque entité cible chevauchant une entité en entrée. Les points situés en dehors de l’entité en entrée sont exclus. Il est possible de spécifier un champ de pondération de sorte que la pondération totale de tous les points dans chaque entité cible soit utilisée pour déterminer la façon de diviser les valeurs attributaires des entités en entrée. Par exemple, si deux entités cibles chevauchent une entité en entrée, et que deux points se trouvent dans la première entité cible et huit points dans la seconde, 20 % (2/10) des valeurs attributaires de l’entité en entrée sont agrégés dans la première entité cible, et 80 % (8/10) des valeurs attributaires de l’entité en entrée sont agrégés dans la seconde entité cible.
String
Entités d’estimation
(Facultatif)

Entités ponctuelles ou polylignes utilisées pour estimer le pourcentage des champs de répartition du polygone en entrée à répartir dans le polygone cible. Il s’agit de la proportion du point ou de la ligne comprise dans l’intersection, divisée par la proportion comprise dans l’entité en entrée pour calculer un pourcentage.

Feature Layer
Champ de pondération
(Facultatif)

Champ numérique de la couche de polygones cible utilisé pour définir les polygones cibles qui reçoivent les valeurs réparties les plus élevées à partir des champs des polygones en entrée à répartir. Les cibles de pondération supérieure reçoivent un ratio supérieur des valeurs de champ.

Si des entités d’estimation sont spécifiées, le champ de pondération est un champ numérique des entités d’estimation qui ajuste les valeurs attribuées aux polygones cibles coupant les entités d’estimation.

Field
Conserve la géométrie cible
(Facultatif)

Indique si la classe d’entités cible gère les géométries d’origine de la couche surfacique cible.

  • Activé : la classe d’entités cible gère les géométries d’origine de la couche surfacique cible. Il s’agit de l’option par défaut.
  • Désactivé : la classe d’entités en sortie sera une intersection géométrique des polygones cibles et des polygones en entrée. Seules les zones des polygones cibles qui se superposent à un polygone en entrée seront incluses dans la sortie.

Boolean

arcpy.analysis.ApportionPolygon(in_features, apportion_fields, target_features, out_features, method, {estimation_features}, {weight_field}, {maintain_geometries})
NomExplicationType de données
in_features

Entités surfaciques dotées d’attributs numériques à synthétiser dans les géométries surfaciques cibles.

Feature Layer
apportion_fields
[apportion_fields,...]

Les champs numériques des polygones en entrée qui seront synthétisés par chaque polygone cible et enregistrés dans la classe d’entités en sortie.

Field
target_features

Entités surfaciques et les champs répartis associés à copier dans la classe d’entités en sortie.

Feature Layer
out_features

La classe d’entités en sortie contenant l’attribut et les géométries des polygones cibles, ainsi que les champs de répartition spécifiés des polygones en entrée.

Feature Class
method

Indique la méthode à utiliser pour répartir les champs des polygones en entrée vers les polygones cibles.

  • AREALa contribution de chaque polygone en entrée dans les valeurs synthétisées pour chaque entité cible est déterminée par la zone superposée entre les deux entités. Si une entité en entrée chevauche deux entités cibles dans les mêmes proportions, les champs répartis sont divisés en deux et contribuent aux deux entités cibles par la moitié de la valeur totale. Il s’agit de l’option par défaut.
  • LENGTHLes attributs des entités en entrée sont divisés en fonction du pourcentage de présence d’une ligne dans chaque entité cible. Seule la ligne qui intersecte l’entité en entrée est prise en compte dans le calcul. La ligne située en dehors de l’entité en entrée est exclue. Par exemple, si une entité cible couvre 750 mètres d’une ligne, et qu’une autre entité cible couvre 250  mètres d’une ligne, 75 % (750/1 000) des valeurs attributaires de l’entité en entrée sont agrégés dans la première entité cible, et 25 % (250/1 000) des valeurs attributaires de l’entité en entrée sont agrégés dans la seconde entité cible.
  • POINTSLes attributs des entités en entrée sont divisés en fonction du nombre de points compris dans chaque entité cible chevauchant une entité en entrée. Les points situés en dehors de l’entité en entrée sont exclus. Il est possible de spécifier un champ de pondération de sorte que la pondération totale de tous les points dans chaque entité cible soit utilisée pour déterminer la façon de diviser les valeurs attributaires des entités en entrée. Par exemple, si deux entités cibles chevauchent une entité en entrée, et que deux points se trouvent dans la première entité cible et huit points dans la seconde, 20 % (2/10) des valeurs attributaires de l’entité en entrée sont agrégés dans la première entité cible, et 80 % (8/10) des valeurs attributaires de l’entité en entrée sont agrégés dans la seconde entité cible.
String
estimation_features
(Facultatif)

Entités ponctuelles ou polylignes utilisées pour estimer le pourcentage des champs de répartition du polygone en entrée à répartir dans le polygone cible. Il s’agit de la proportion du point ou de la ligne comprise dans l’intersection, divisée par la proportion comprise dans l’entité en entrée pour calculer un pourcentage.

Feature Layer
weight_field
(Facultatif)

Champ numérique de la couche de polygones cible utilisé pour définir les polygones cibles qui reçoivent les valeurs réparties les plus élevées à partir des champs des polygones en entrée à répartir. Les cibles de pondération supérieure reçoivent un ratio supérieur des valeurs de champ.

Si des entités d’estimation sont spécifiées, le champ de pondération est un champ numérique des entités d’estimation qui ajuste les valeurs attribuées aux polygones cibles coupant les entités d’estimation.

Field
maintain_geometries
(Facultatif)

Indique si la classe d’entités cible gère les géométries d’origine de la couche surfacique cible.

  • MAINTAIN_GEOMETRIESLa classe d’entités cible conserve les géométries d’origine de la couche surfacique cible. Il s’agit de l’option par défaut.
  • INTERSECT_GEOMETRIESLa classe d’entités en sortie sera une intersection géométrique des polygones cibles et des polygones en entrée. Seules les zones des polygones cibles qui se superposent à un polygone en entrée seront incluses dans la sortie.
Boolean

Exemple de code

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

Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction ApportionPolygon.

import arcpy
arcpy.env.workspace = "C:/data/MyAnalysis.gdb"
arcpy.analysis.ApportionPolygon(
        "CensusBlockGroups", "Pop2020", "StoreServiceArea", 
        "StoreServiceArea_w_Population", "AREA", "", "", "MAINTAIN_GEOMETRIES")
Exemple 2 d’utilisation de l’outil ApportionPolygon (script autonome)

Le script autonome suivant transfère la population pondéré d’une couche Census Block Groups (Groupes d’îlots de recensement) vers un polygone surfacique de service de stockage.

# Name: Store Service Area Get Population.py
# Description: Use apportionment to transfer population figures to different 
#              geometry.

# Import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/MyAnalysis.gdb"

# Perform apportionment
inputDataWithPop = "CensusBlockGroups"
popField = "Pop2020"
targetServiceAreas = "Store_ServiceAreas"
outputApp = "Store_ServiceAreas_w_Population"
apportionMethod = "AREA"
keepTargetGeom = "MAINTAIN_GEOMETRIES"
arcpy.analysis.ApportionPolygon(inputDataWithPop, popField, targetServiceAreas, 
                                outputApp, apportionMethod, "", "", 
                                keepTargetGeom)

# Summarize store service area populations by store admin region
outStats = "PopulationPerSalesRegion_tlb"
statsFields = [["Pop2020", "SUM"]]
regionField = "SalesRegion" # Values like North, North-East, etc.
arcpy.analysis.Statistics(outputApp, outStats, statsFields, regionField)

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes