Polygone de répartition (Analyse)—ArcGIS Pro

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

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. Vous pouvez également utiliser le paramètre Entités d’estimation pour créer un pourcentage en utilisant la proportion de points ou la longueur de la ligne.
Par défaut, la statistique utilisée pour les attributs de répartition est l’addition. Les statistiques Moyenne et Médiane sont disponibles lorsque le paramètre Méthode de répartition est défini sur Surface.
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

Étiquette	Explication	Type 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. Les types de statistiques facultatifs sont les suivants : Somme : additionne les valeurs du champ spécifié. Il s’agit de l’option par défaut. Moyenne : calcule la moyenne du champ spécifié. Cette option est valide uniquement lorsque le paramètre Méthode de répartition est défini sur Surface. Median (Médiane) : calcule la médiane du champ spécifié. Cette option est valide uniquement lorsque le paramètre Méthode de répartition est défini sur Surface.	Value Table
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. Surface—La 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. Longueur—Les 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. Points—Les 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 conserve 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})

Nom	Explication	Type 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 [[field, {statistic_type}],...]	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. Les types de statistiques facultatifs sont les suivants : SUM : additionne les valeurs du champ spécifié. Il s’agit de l’option par défaut. MEAN : calcule la moyenne du champ spécifié. Cette option est valide uniquement lorsque le paramètre method est défini sur AREA. MEDIAN : calcule la médiane du champ spécifié. Cette option est valide uniquement lorsque le paramètre method est défini sur AREA.	Value Table
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. AREA—La 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. LENGTH—Les 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. POINTS—Les 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 conserve les géométries d’origine de la couche surfacique cible. MAINTAIN_GEOMETRIES—La 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_GEOMETRIES—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

Exemple de code

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

Le script ci-dessous 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.

# 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 such as North, North-East, etc.

arcpy.analysis.Statistics(outputApp, outStats, statsFields, regionField)

Exemple 3 d’utilisation de la fonction ApportionPolygon (script autonome)

Le script autonome suivant est un exemple d’utilisation de la moyenne et de la médiane pour estimer les champs de répartition.

# Import system modules 
import arcpy

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

# Perform apportionment
inputDataWithPop = "CensusBlockGroups"
popField = [["POP2000", "MEAN"], ["SUM_Incide", "MEDIAN"]]
targetServiceAreas = "Store_ServiceAreas"
outputApp = "Store_ServiceAreas_w_Population"
apportionMethod = "AREA"
keepTargetGeom = "MAINTAIN_GEOMETRIES"

arcpy.analysis.ApportionPolygon(inputDataWithPop, popField, targetServiceAreas, 
                                outputApp, apportionMethod, "", "", 
                                keepTargetGeom))

Environnements

Espace de travail courant, Espace de travail temporaire, Système de coordonnées en sortie, Étendue, Facteur de traitement parallèle

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?