Agréger les points (GeoAnalytics)

Synthèse

Agrège des points dans des entités surfaciques ou des groupes. Un polygone est renvoyé, accompagné d’un nombre de points ainsi que de statistiques facultatives pour toutes les localisations qui comportent des points.

En savoir plus sur le fonctionnement des intervalles temporels

Illustration

Des exemples d’agrégation de points en polygones (première ligne), de points temporels en polygones avec intervalles temporels (deuxième ligne), de points en groupes (troisième ligne) et de points en groupes avec intervalles temporels (quatrième ligne) sont illustrés.

Utilisation

• Vous pouvez spécifier les zones dans lesquelles les points seront agrégés de l’une des façons suivantes :

  • Utilisation d'une couche de polygones.
  • Utilisation d’un groupe carré, hexagonal ou H3 d’une taille spécifiée généré lors de l’exécution de l’analyse.

  Vous pouvez fournir la couche surfacique à utiliser pour l’analyse ou générer des groupes d’une taille et d’une forme (hexagonale, carrée ou H3) spécifiques dans lesquels les points seront agrégés. La taille de groupe détermine l’ampleur des groupes carrés et hexagonaux.

  • Si vous optez pour l’agrégation dans des hexagones, la taille correspond à la hauteur de chaque hexagone et la largeur de l’hexagone obtenu est de deux fois la hauteur divisée par la racine carrée de 3.
  • Si vous optez pour l'agrégation dans des carrés, la taille des groupes correspond à la hauteur du carré, qui est égale à la largeur.
  • Si vous optez pour l’agrégation dans des groupes H3, la taille des groupes est déterminée par la résolution du groupe H3 spécifié. La résolution du groupe H3 peut être une valeur comprise entre 0 et 15, la valeur 0 produisant les groupes les plus grands et la valeur 15 les groupes les plus petits.

  

• L’agrégation de points implique de projeter la valeur du paramètre Point Layer (Couche ponctuelle) ou de définir le système de coordonnées en sortie sur un système de coordonnées projetées lors de l’agrégation dans des groupes hexagonaux ou carrés. Si les données ne se trouvent pas dans un système de coordonnées projetées lors de l’agrégation dans des groupes hexagonaux ou carrés et que vous ne définissez pas de système de coordonnées de traitement projetées, une projection est attribuée en fonction de l’étendue des données que vous analysez. Lors de l’agrégation des groupes H3, la valeur du paramètre Point Layer (Couche ponctuelle) doit être dans World Geodetic System 1984 (WKID 4326) et sera transformée dans ce système de coordonnées le cas échéant.

• La couche d’entités en sortie est toujours une couche de polygones. Seuls les polygones contenant des points sont renvoyés et les polygones obtenus sont entièrement supprimés de la couche de résultat.

  

  Les entités ponctuelles et de polygones en entrée sont présentées dans la première image, les entités surfaciques obtenues avec l’outil Aggregate Points (Agréger les points) étant présentées dans la seconde image.

• Les agrégations les plus élémentaires calculent le nombre de points dans chaque polygone. Les statistiques (total, somme, minimum, maximum, plage, moyenne, écart type et variance) peuvent également être calculées dans des champs numériques et les statistiques (total, tout) peuvent être calculées dans des champs de type chaîne. Les statistiques sont calculées séparément sur chaque surface. Si vous spécifiez une statistique qui n’est pas valide (la moyenne d’un champ de type chaîne, par exemple), elle sera ignorée.

  Remarque :

  Lorsque total est appliqué à un champ, il renvoie le total des valeurs non nulles présentes dans le champ. Lorsque tout est appliqué à un champ de type chaîne, il renvoie une seule chaîne présente dans le champ.

• Si le temps est activé dans la sortie, vous pouvez appliquer des intervalles temporels à l’analyse. Chaque intervalle temporel est analysé indépendamment des entités en dehors de l’intervalle temporel. Pour que vous puissiez utiliser la discrétisation temporelle, les données en entrée doivent être temporelles et représenter un instant dans le temps. Lorsque la discrétisation temporelle est appliquée, les entités en sortie sont des intervalles temporels représentés par les champs START_DATETIME et END_DATETIME.

  En savoir plus sur les intervalles temporels

• Si vous spécifiez un intervalle temporel, une répétition d’intervalle temporel ou une référence temporelle et que le temps n’est pas activé pour les données, une erreur se produit.

• Le paramètre Time Step Reference (Référence de l’intervalle temporel) peut être une valeur de date et d’heure ou simplement une valeur de date, mais pas uniquement une valeur d’heure.

• Les champs suivants sont inclus dans les entités en sortie :

  Nom du champ	Description
  count	Nombre d’entités dans chaque polygone.
  statistic_fieldname	Les statistiques spécifiées créent chacune un champ attributaire, dont le nom se présente au format suivant : statistic_fieldname. Par exemple, l’écart maximal et l’écart type du champ id sont respectivement MAX_id et SD_id.
  start_date	Si l’intervalle temporel est spécifié, les polygones en sortie présenteront un intervalle temporel. Ce champ représente l’heure de début.
  end_date	Si l’intervalle temporel est spécifié, les polygones en sortie présenteront un intervalle temporel. Ce champ représente l’heure de fin.
  bin_id	ID du groupe H3 numérique. Ce champ est uniquement inclus lors de l’agrégation dans des groupes H3.

• Vous pouvez améliorer les performances de l’outil Aggregate Points (Agréger les points) en utilisant une ou plusieurs des astuces suivantes :

  • Définissez l’environnement d’étendue de manière à n’analyser que les données présentant un intérêt.
  • Les performances de grands groupes sont meilleures que celles de petits groupes. Si vous n’êtes pas sûr de la taille à utiliser, commencez par un groupe plus grand comme prototype.
  • Comme les groupes, des intervalles temporels plus importants se comportent mieux que des intervalles temporels plus petits.
  • Utilisez les données locales de l’environnement de l’analyse.

• Cet outil de géotraitement est optimisé par ArcGIS GeoAnalytics Server. L’analyse est réalisée sur GeoAnalytics Server et les résultats sont stockés dans votre contenu dans ArcGIS Enterprise.

• Lors de l’exécution des outils GeoAnalytics Server, l’analyse est réalisée sur GeoAnalytics Server. Pour des performances optimales, GeoAnalytics Server doit pouvoir accéder aux données via les couches d’entités hébergées sur votre portail ArcGIS Enterprise ou les partages de fichiers Big Data. Les données qui ne sont pas locales pour GeoAnalytics Server sont transférées sur GeoAnalytics Server avant le début de l’analyse. Autrement dit, l’exécution d’un outil prend plus de temps et, dans certains cas, le transfert des données depuis ArcGIS Pro vers GeoAnalytics Server peut échouer. Le seuil d’échec dépend aussi bien des débits du réseau que de la taille et de la complexité des données. Il est recommandé de toujours partager les données ou de créer un partage de fichiers Big Data.

  Pour en savoir plus sur le partage des données dans votre portail.

  En savoir pus sur la création d’un partage de fichiers Big Data via ArcGIS Server Manager

• Une analyse similaire peut être réalisée à l’aide de l’outil Aggregate Points (Agréger les points) dans la boîte à outils Standard Feature Analysis (Analyse d’entités standard).

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Couche ponctuelle	Entités ponctuelles qui seront agrégées dans des polygones ou des groupes.	Feature Set
Nom en sortie	Nom du service d’entités en sortie.	String
Polygone ou groupe	Spécifie comment la valeur de paramètre Point Layer (Couche ponctuelle) sera agrégée. Polygone—La couche ponctuelle sera agrégée dans un jeu de données surfaciques. Groupe—La couche ponctuelle sera agrégée dans des groupes carrés ou hexagonaux générés lors de l’exécution de l’outil.	String
Couche surfacique (Facultatif)	Entités surfaciques dans lesquelles les points en entrée seront agrégés.	Feature Set
Type de groupe (Facultatif)	Spécifie la forme du groupe générée pour contenir les points agrégés. Carré—Des groupes carrés seront générés dans lesquels la valeur Bin Size (Taille du groupe) représente la hauteur d’un carré. Il s’agit de l’option par défaut. Hexagone—Des groupes hexagonaux seront générés dans lesquels la valeur Bin Size (Taille de groupe) représente la hauteur entre deux côtés parallèles. H3—Des groupes H3 seront générés. La taille du groupe sera déterminée par la valeur de paramètre Bin Resolution (Résolution du groupe).	String
Taille du groupe (Facultatif)	Intervalle de distance qui représente la taille du groupe et les unités dans lesquelles la valeur Point Layer (Couche ponctuelle) sera agrégée. L'intervalle de distance doit être une unité linéaire. L'intervalle de distance qui représente la taille du groupe et les unités utilisées pour la couche de points agrégée. L'intervalle de distance doit être une unité linéaire.	Linear Unit
Intervalle temporel (Facultatif)	Valeur qui spécifie la durée de l'intervalle de temps. Ce paramètre n’est disponible que si les points en entrée sont temporels et représentent un instant dans le temps. Une discrétisation temporelle peut être appliquée uniquement si le temps est activé sur les données en entrée.	Time Unit
Répétition de l’intervalle temporel (Facultatif)	Valeur qui spécifie la fréquence à laquelle l'intervalle de temps intervient. Ce paramètre n’est disponible que si les points en entrée sont temporels et représentent un instant dans le temps.	Time Unit
Référence de l’intervalle temporel (Facultatif)	Une date qui indique l'heure de référence sur laquelle aligner les intervalles temporels. La valeur par défaut est le 1er janvier 1970 à 12 h 00. Ce paramètre n’est disponible que si les points en entrée sont temporels et représentent un instant dans le temps.	Date
Champs de récapitulation (Facultatif)	Statistiques qui seront calculées sur les champs spécifiés.	Value Table
Data store (Facultatif)	Indique l’instance ArcGIS Data Store dans laquelle la sortie est enregistrée. La valeur par défaut est Stockage de Big Data spatio-temporelles. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées. Stockage de Big Data spatio-temporelles—La sortie sera stockée dans un stockage de Big Data spatio-temporelles. Il s’agit de l’option par défaut. Stockage des données relationnelles—La sortie sera stockée dans un data store relationnel.	String
Résolution du groupe (Facultatif)	Résolution des groupes H3. Il s’agit d’une valeur comprise entre 0 et 15, la valeur 0 produisant les groupes les plus grands et la valeur 15 les groupes les plus petits.	Long

Sortie obtenue

Étiquette	Explication	Type de données
Couche d’entités en sortie	Groupes ou entités surfaciques agrégés.	Feature Set

Python

arcpy.geoanalytics.AggregatePoints(point_layer, output_name, polygon_or_bin, {polygon_layer}, {bin_type}, {bin_size}, {time_step_interval}, {time_step_repeat}, {time_step_reference}, {summary_fields}, {data_store}, {bin_resolution})

Nom	Explication	Type de données
point_layer	Entités ponctuelles qui seront agrégées dans des polygones ou des groupes.	Feature Set
output_name	Nom du service d’entités en sortie.	String
polygon_or_bin	Spécifie comment la valeur de paramètre point_layer sera agrégée. POLYGON—La couche ponctuelle sera agrégée dans un jeu de données surfaciques. BIN—La couche ponctuelle sera agrégée dans des groupes carrés ou hexagonaux générés lors de l’exécution de l’outil.	String
polygon_layer (Facultatif)	Entités surfaciques dans lesquelles les points en entrée seront agrégés.	Feature Set
bin_type (Facultatif)	Spécifie la forme du groupe générée pour contenir les points agrégés. SQUARE—Des groupes carrés seront générés dans lesquels la valeur bin_size représente la hauteur d’un carré. Il s’agit de l’option par défaut. HEXAGON—Des groupes hexagonaux seront générés dans lesquels la valeur bin_size représente la hauteur entre deux côtés parallèles. H3—Des groupes H3 seront générés. La taille du groupe sera déterminée par la valeur de paramètre bin_resolution.	String
bin_size (Facultatif)	Intervalle de distance qui représente la taille du groupe et les unités dans lesquelles la valeur point_layer sera agrégée. L'intervalle de distance doit être une unité linéaire.	Linear Unit
time_step_interval (Facultatif)	Valeur qui spécifie la durée de l'intervalle de temps. Ce paramètre n’est disponible que si les points en entrée sont temporels et représentent un instant dans le temps. Une discrétisation temporelle peut être appliquée uniquement si le temps est activé sur les données en entrée.	Time Unit
time_step_repeat (Facultatif)	Valeur qui spécifie la fréquence à laquelle l'intervalle de temps intervient. Ce paramètre n’est disponible que si les points en entrée sont temporels et représentent un instant dans le temps.	Time Unit
time_step_reference (Facultatif)	Une date qui indique l'heure de référence sur laquelle aligner les intervalles temporels. La valeur par défaut est le 1er janvier 1970 à 12 h 00. Ce paramètre n’est disponible que si les points en entrée sont temporels et représentent un instant dans le temps.	Date
summary_fields [summary_fields,...] (Facultatif)	Statistiques qui seront calculées sur les champs spécifiés. COUNT : nombre de valeurs non nulles. Il peut être utilisé sur des champs numériques ou des chaînes. Le nombre de [null, 0, 2] est 2. SUM : somme des valeurs numériques dans un champ. La somme des [null, null, 3] est 3. MEAN : moyenne des valeurs numériques. La moyenne des [0,2, null] est 1. MIN : valeur minimale d’un champ numérique. Le minimum de [0, 2, null] est 0. MAX : valeur maximale d’un champ numérique. La valeur maximale de [0, 2, null] est 2. STDDEV : écart type d’un champ numérique. L’écart type de [1] est null. L’écart type de [null, 1,1,1] est null. VAR : variance d’un champ numérique dans une trace. La variance de [1] est null. La variance de [null, 1,1,1] est null. RANGE : plage d’un champ numérique. Elle est calculée comme la valeur minimale soustraite de la valeur maximale. La plage de [0, null, 1] est 1. La plage de [null, 4] est 0. ANY : exemple de chaîne provenant d’un champ de type chaîne.	Value Table
data_store (Facultatif)	Indique l’instance ArcGIS Data Store dans laquelle la sortie est enregistrée. La valeur par défaut est SPATIOTEMPORAL_DATA_STORE. Tous les résultats stockés dans un répertoire de données Big Data spatio-temporelles seront stockés en WGS84. Les résultats stockés dans un répertoire de données relationnelles conservent leur système de coordonnées. SPATIOTEMPORAL_DATA_STORE—La sortie sera stockée dans un stockage de Big Data spatio-temporelles. Il s’agit de l’option par défaut. RELATIONAL_DATA_STORE—La sortie sera stockée dans un data store relationnel.	String
bin_resolution (Facultatif)	Résolution des groupes H3. Il s’agit d’une valeur comprise entre 0 et 15, la valeur 0 produisant les groupes les plus grands et la valeur 15 les groupes les plus petits.	Long

Sortie obtenue

Nom	Explication	Type de données
output	Groupes ou entités surfaciques agrégés.	Feature Set

Exemple de code

AggregatePoints ( fenêtre Python)

Le script de fenêtre Python suivant illustre l’utilisation de la fonction AggregatePoints.

# Name: AggregatePoints.py
# Description: Aggregate 311 events into 1 KM Bins.
#
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/SF311/FeatureServer/0"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
outFS = "AggregateWildfires"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Aggregate Points
arcpy.geoanalytics.AggregatePoints(inFeatures, outFS, "BIN", None, "HEXAGON", 
                                   "1 Kilometers", None, None, None, None, 
                                   dataStore)

Environnements

Système de coordonnées en sortie, Étendue, Espace de travail courant

Cas particuliers

Système de coordonnées en sortie

Système de coordonnées qui sera utilisé pour l'analyse. L’analyse sera réalisée dans le système de coordonnées en entrée, à moins que ce paramètre en spécifie un autre. Pour GeoAnalytics Tools, les résultats finaux sont stockés dans le Spatiotemporal Data Store dans WGS84.

Informations de licence

• Basic: Nécessite ArcGIS GeoAnalytics Server
• Standard: Nécessite ArcGIS GeoAnalytics Server
• Advanced: Nécessite ArcGIS GeoAnalytics Server