Agréger des polygones (Cartographie)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Combine des polygones entre eux à une distance spécifiée afin de former de nouveaux polygones.

Illustration

Illustration de l'outil Agréger des polygones

Utilisation

Syntaxe

AggregatePolygons_cartography (in_features, out_feature_class, aggregation_distance, {minimum_area}, {minimum_hole_size}, {orthogonality_option}, {barrier_features}, {out_table})
ParamètreExplicationType 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.

  • NON_ORTHOGONALDes entités en sortie de forme organique sont créées. Cette option est adaptée aux entités naturelles, telles que la végétation ou les polygones de sol. Il s'agit du paramétrage par défaut.
  • ORTHOGONALDes entités en sortie de forme orthogonale sont créées. Cette option est adaptée pour conserver la caractéristique géométrique d'entités anthropogéniques en entrée, telles que les tracés de bâtiment.
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

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Annuler
ArcGIS for Desktop Standard: Annuler
ArcGIS for Desktop Advanced: Oui
6/5/2014