É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. | 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.
| 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 |
Gérer 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.
| Boolean |
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 qui découlent 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
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 zone. 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
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 [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.
| 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.
| Boolean |
Exemple de code
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.ApportionPolygon_analysis(
"CensusBlockGroups", "Pop2020", "StoreServiceArea",
"StoreServiceArea_w_Population", "AREA", "", "", "MAINTAIN_GEOMETRIES")
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.ApportionPolygon_analysis(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.Statistics_analysis(outputApp, outStats, statsFields, regionField)
Environnements
Cas particuliers
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?