Agréger des points (Cartographie)

Synthèse

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.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Entités ponctuelles en entrée dont la proximité sera évaluée en vue de leur agrégation.	Feature Layer
Classe d'entités en sortie	Classe d'entités créée pour conserver les polygones qui représentent les agrégats de points.	Feature Class
Distance d’agrégation	Distance entre les points qui seront agrégés.	Linear Unit

Sortie obtenue

Étiquette	Explication	Type de données
Table de relations	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

Python

arcpy.cartography.AggregatePoints(in_features, out_feature_class, aggregation_distance)

Nom	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 obtenue

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

Résolution XY, Valeur Z en sortie par défaut, Valeurs Z en sortie, Étendue

Informations de licence

• Basic: Non
• Standard: Non
• Advanced: Oui