Résumé
Crée des entités surfaciques autour d'agrégats d'entités ponctuelles proches.
Utilisation
Les polygones sont créés autour d'agrégats d'au moins trois points dans la distance d'agrégation.
Une table de relations un vers plusieurs (portant le nom de la classe d'entités en sortie auquel _Tbl est ajouté) sera créée, ce qui permettra d'établir un lien entre les polygones agrégés et leurs entités ponctuelles source. Cette table se trouve au même emplacement que la classe d’entités en sortie et 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. Ce lien peut devenir incorrect lorsque l'une des entités en entrée ou en sortie est modifiée. Avec cette table, vous pouvez déduire les attributs requis pour les entités en sortie de leurs entités source à l'aide des outils de géotraitement appropriés.
L'agrégation de points peut introduire des trous de polygone ou des surfaces à l'endroit où les limites de polygone adjacentes se rencontrent à un sommet.
Syntaxe
arcpy.cartography.AggregatePoints(in_features, out_feature_class, aggregation_distance)
Paramètre | Explication | Type de données |
in_features | Entités ponctuelles en entrée dont la proximité sera évaluée en vue de leur agrégation. | Feature Layer |
out_feature_class | Classe d'entités créée pour conserver les polygones qui représentent les agrégats de points. | Feature Class |
aggregation_distance | Distance entre les points qui seront agrégés. | Linear Unit |
Sortie dérivée
Nom | Explication | Type de données |
out_table | Une table de relations un vers plusieurs (portant le nom de la classe d’entités en sortie auquel _Tbl est ajouté) sera créée, ce qui permettra d’établir un lien entre les polygones agrégés et leurs entités ponctuelles source. | Tableau |
Exemple de code
Exemple 1 d’utilisation de l’outil AggregatePoints (fenêtre Python)
Le script de fenêtre Python suivant montre comment utiliser l'outil AggregatePoints en mode immédiat.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.AggregatePoints_cartography("C:/data/cartography.gdb/crime/robberies",
"C:/data/cartography.gdb/crime/clustered_robberies",
"100 meters")
Exemple 2 d’utilisation de l’outil AggregatePoints (script autonome)
Ce script autonome montre un exemple d'utilisation de l'outil AggregatePoints.
# Name: AggregatePoints_standalone_script.py
# Description: Creates polygon features around clusters of proximate point features.
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
in_point_features = "C:/data/cartography.gdb/crime/robberies"
out_feature_class = "C:/data/cartography.gdb/crime/clustered_robberies"
aggregation_distance = "100 meters"
# Execute Aggregate Points
arcpy.AggregatePoints_cartography(in_point_features, out_feature_class, aggregation_distance)
Environnements
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui