Résumé
Combine des polygones entre eux à une distance spécifiée afin de former de nouveaux polygones.
Illustration
Utilisation
Cet outil est destiné à une agrégation et à une réduction d'échelle modérées lorsque les entités en entrée ne peuvent plus être représentées individuellement en raison de l'espace limité de la carte ou de la résolution requise pour les données. L'agrégation ne se produit qu'à l'endroit où deux limites de polygone se trouvent à une distance d'agrégation définie l'une de l'autre. Aucune auto-agrégation n'a lieu, ce qui signifie qu'aucune agrégation n'a lieu au sein d'une entité surfacique en entrée le long de sa propre limite, de même qu'aucune agrégation n'a lieu entre des parties d'une entité surfacique multi-parties.
L'option orthogonale permet de créer des entités en sortie de forme orthogonale. Cette option est particulièrement adaptée à une utilisation avec des entités en entrée possédant des tronçons à prédominance orthogonale. Dans certains cas, l'agrégation est moindre pour prendre cela en compte. Par exemple, deux bâtiments carrés situés en diagonale l'un par rapport à l'autre dans la distance d'agrégation ne peut pas être agrégés car aucune connexion évidente ne peut être établie en conservant le caractère orthogonal. L'option non orthogonale produit des résultats de forme plus organique.
Utilisez les entités interruptions pour empêcher l'agrégation de survenir à travers des limites. Les exemples permettent également d'empêcher l'occupation du sol d'effectuer une agrégation à travers des rivières ou d'agréger des bâtiments situés de part et d'autre d'une même rue. Les interruptions peuvent être des lignes ou des polygones, et plusieurs classes d'entités interruptions peuvent être utilisées simultanément.
Si la classe d'entités en entrée est une couche qui référence une représentation, et que des débrayages de forme sont présents sur les entités en entrée, ceux-ci sont évalués dans l'agrégation, pas dans la géométrie de l'entité.
La classe d'entités en sortie ne contiendra pas d'attributs géographiques des entités en entrée. Il est possible de créer en option une table de relations un vers plusieurs pour relier les polygones agrégés à leurs polygones source. Ce lien peut devenir incorrect lorsque l'une des entités en entrée ou en sortie est modifiée.
Si les entités en entrée contiennent des valeurs Z, ces dernières peuvent être conservées si elles sont spécifiées dans les paramètres d'environnement. Lorsque les sommets en sortie ne sont pas modifiés, les valeurs Z en entrée seront transférées aux sommets en sortie ; sinon, une valeur Z sera déduite pour les nouveaux sommets, d'après les valeurs Z existantes ou par interpolation.
Le traitement d'un jeu de données en entrée volumineux peut dépasser les limites de la mémoire. Dans ce cas, envisagez de traiter les données en entrée par partition en identifiant une classe d'entités surfaciques pertinente dans le paramètre d'environnement Partitions cartographiques. Les portions des données, définies par les limites des partitions, sont traitées séquentiellement. La classe d'entités en sortie résultante cohérent aux tronçons de partition, mais les entités en sortie traversant des partitions, sont fractionnées à la ligne de partition. Un champ appelé IS_SPLIT dans la classe d'entités en sortie porte la valeur 1 dans cette instance.
Syntaxe
AggregatePolygons_cartography (in_features, out_feature_class, aggregation_distance, {minimum_area}, {minimum_hole_size}, {orthogonality_option}, {barrier_features}, {out_table})| Paramètre | Explication | Type de données |
in_features | Entités surfaciques à agréger. Si cette couche référence une représentation et des débrayages de forme présents sur les entités en entrée, les formes remplacées, et non les formes de l'entité, sont prises en compte dans le traitement d'agrégation. | Feature Layer |
out_feature_class | Classe d'entités en sortie à créer. | Feature Class |
aggregation_distance | Distance à respecter entre les limites des polygones pour que l'agrégation puisse avoir lieu. Une distance supérieure à zéro doit être spécifiée. Vous pouvez choisir une unité préférée. Par défaut, l'unité de l'entité est spécifiée. | Linear unit |
minimum_area (Facultatif) | Superficie minimale pour qu'un polygone agrégé soit conservé. La valeur par défaut est de zéro, auquel cas tous les polygones sont conservés. Vous pouvez spécifier une unité préférée. Par défaut, l'unité de l'entité est spécifiée. | Areal unit |
minimum_hole_size (Facultatif) | Taille minimale d'un trou polygonal à conserver. La valeur par défaut est de zéro, auquel cas tous les trous polygonaux sont conservés. Vous pouvez spécifier une unité préférée : par défaut, l'unité utilisée est celle de l'entité. | Areal unit |
orthogonality_option (Facultatif) | Précise la caractéristique des entités en sortie à conserver lors de la création des limites agrégées.
| Boolean |
barrier_features (Facultatif) | Couches contenant les entités linéaires ou surfaciques qui constituent des interruptions d'agrégation pour les entités en entrée. Les entités ne seront pas agrégées à travers des entités interruptions. Les entités interruptions en conflit géométrique avec les entités en entrée sont ignorées. | Feature Layer |
out_table (Facultatif) | Table de relations un vers plusieurs reliant les polygones agrégés à leurs entités surfaciques source. Cette table contient deux champs, OUTPUT_FID et INPUT_FID, stockant respectivement les identifiants des entités agrégées et les identifiants des entités source correspondantes. Cette table permet de dériver les attributs nécessaires pour les entités en sortie de leurs entités source. Le nom par défaut de cette table est le nom de la classe d'entités en sortie, auquel on ajoute _tbl. Le chemin d'accès par défaut est le même que celui de la classe d'entités en sortie. Aucune table n'est créée lorsque ce paramètre est laissé vide. | Table |
Exemple de code
Exemple 1 d'utilisation de l'outil AggregatePolygons (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil AggregatePolygons en mode immédiat.
import arcpy
arcpy.env.cartographicPartitions = "C:/data/county.gdb/zipcodepoly"
buildings = "C:/data/county.gdb/bldgspoly"
roads = "C:/data/county.gdb/roadnetwork"
output = "C:/data/county.gdb/BldgAggBarrierPartition"
output_table = "C:/data/county.gdb/BldgAggBarrierPartition_Tbl"
arcpy.AggregatePolygons_cartography(buildings, output, "20 Meters", "5 SquareMeters", "0 SquareMeters", "ORTHOGONAL", roads, output_table)
Exemple 2 d'utilisation de l'outil AggregatePolygons (script autonome)
Le script autonome suivant montre comment utiliser la fonction AggregatePolygons.
# Name: AggregatePolygons_Example2.py
# Description: Aggregate grass features and then transfer attributes
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
import arcpy.cartography as CA
import arcpy.management as DM
import arcpy.analysis as AN
# Set environment settings
env.workspace = "C:/data/Portland.gdb/Vegetation"
# Set local variables
inGrassFeatures = "grass"
aggregatedFeatures = "C:/data/PortlandOutput.gdb/grassland"
aggregatedTable = "C:/data/PortlandOutput.gdb/grassland_Tbl"
frequencyTable = "C:/data/PortlandOutput.gdb/frequency_Tbl"
# Aggregate grass polygons.
CA.AggregatePolygons(inGrassFeatures, aggregatedFeatures, 50, 300, 300, "NON_ORTHOGONAL", "", aggregatedTable)
# Join the aggregatedTable with input and
# transfer the COUNT field to aggregatedTable.
DM.JoinField(aggregatedTable, "INPUT_FID", inGrassFeatures, "OBJECTID", "COUNT")
# Use Frequency on aggregatedTable and
# obtain sum for COUNT.
AN.Frequency(aggregatedTable, frequencyTable, "OUTPUT_FID", "COUNT")
# Join the aggregatedFeatures with frequencyTable
# and transfer the COUNT field to aggregatedFeatures.
DM.JoinField(aggregatedFeatures, "OBJECTID", frequencyTable, "OUTPUT_FID", "COUNT")
Environnements
Informations de licence
- ArcGIS Desktop Basic: Non
- ArcGIS Desktop Standard: Non
- ArcGIS Desktop Advanced: Oui
Rubriques connexes
- Vue d'ensemble du jeu d'outils Généralisation
- Présentation de la résolution des conflits et de la généralisation
- Automatisation de la résolution des conflits et des workflows de généralisation avec le géotraitement
- Simplifier des bâtiments
- Généralisation de grands jeux de données à l'aide de partitions
- Créer les partitions cartographiques
- Partitions cartographiques (paramètre d'environnement)