Grouper par proximité (GeoAnalytics)

Synthèse

Permet de grouper des entités selon une proximité spatiale ou spatiotemporelle entre elles.

Voici quelques exemples de questions auxquelles les processus de l’outil Grouper par proximité peuvent répondre :

• Quelles routes sont connectées ?
• Où se trouvent les groupes de crimes se produisant à une distance géographique et temporelle proche ?
• Existe-t-il des groupes de polygones qui se superposent ?

Illustration

Utilisation

• Cet outil de géotraitement est disponible avec ArcGIS Enterprise 10.9.1 ou version ultérieure.

• Le résultat en sortie est une copie de l’entrée avec un nouveau champ nommé group_id. Le champ group_id représente le groupement d’entités. Les entités qui possèdent la même valeur group_id figurent dans le même groupe. Les numéros de groupe représentent l’appartenance à un groupe spécifique et ne correspondent à aucune valeur. Il se peut que les numéros de groupe ne soient pas séquentiels ou que le même numéro soit utilisé plusieurs fois lors d’utilisations répétées de l’outil. Les résultats sont symbolisés avec huit groupes. Si le résultat comprend plus de huit groupes, tous les groupes sont symbolisés avec huit couleurs par défaut. Vous pouvez modifier la symbologie pour afficher chaque groupe unique en procédant à la symbolisation avec des symboles uniques dans le champ group_id.

• L’outil prend en charge les combinaisons de relations suivantes :

  • Une relation spatiale
  • Une relation spatiale et une relation temporelle
  • Une relation spatiale et une relation attributaire
  • Une relation spatiale, une relation temporelle et une relation attributaire
  Les entités sont regroupées lorsque toutes les relations spécifiées existent.

• Les relations spatiales et les géométries en entrée prises en charge sont décrites dans le tableau suivant :

  Type de géométrie en entrée	Intersecte	Touche	Proche géodésique	Proche plan
  Point
  Polyligne
  Polygone

  Overlay method (Méthode de superposition)	Description
  Intersecte	Les entités s’intersectent lorsque des entités ou des portions d’entités se superposent. Il s’agit de l’option par défaut.
  Touche	Les entités touchent une autre entité si elles s’intersectent en un sommet, mais qu’elles ne sont pas superposées.
  Proche géodésique	Les entités sont proches si un sommet ou un tronçon se situe dans une distance géodésique donnée d’une autre entité.
  Proche plan	Les entités sont proches si un sommet ou un tronçon se situe dans une distance planaire donnée d’une autre entité.

• Pour que vous puissiez utiliser l’option Planar Near (Planaire à proximité) du paramètre Spatial Relationship (Relation spatiale), la valeur de Input Layer (Couche en entrée) doit être projetée ou le système de coordonnnées en sortie doit être défini sur un système de coordonnées projetées.

• Les relations temporelles et les types temporels pris en charge sont décrits dans le tableau suivant :

  Type temporel en entrée	Intersecte	Proche
  Aucun
  Instant
  Intervalle

  Méthode de relation temporelle	Description
  Intersecte	Des entités s’intersectent lorsque n’importe quelle portion temporelle d’une entité se superpose à une autre entité.
  Proche	Les entités sont proches les unes des autres si les données temporelles d’une entité se situent dans une distance temporelle donnée d’une autre entité.

• Les expressions attributaires sont une opération symétrique. L’outil prend une seule couche en entrée qui est comparée à elle-même lors du regroupement. C’est pourquoi, la couche en entrée est indiquée en tant que a et b dans l’expression ArcGIS Arcade et toutes les expressions doivent inclure à la fois a et b. Par exemple, pour regrouper tous les enregistrements lorsque le champ Amount a la même valeur, utilisez l’expression suivante : $a["Amount"] == $b["Amount"].

• Vous pouvez améliorer les performances de l’outil Grouper par proximité en effectuant une ou plusieurs des opérations suivantes :

  • Définissez l’environnement de l’étendue de manière à analyser uniquement des données d’intérêt.
  • Lorsque vous utilisez l’option Planar Near (Proche planaire) ou Geodesic Near (Proche géodésique) du paramètre Spatial Relationship (Relation spatiale), utilisez une valeur plus petite pour le paramètre Spatial Near Distance (Distance de proximité spatiale).
  • Lorsque vous utilisez le paramètre Spatial Relationship (Relation spatiale), l’option Planar Near (Proche planaire) est plus rapide que l’option Geodesic Near (proche géodésique).
  • Lorsque vous utilisez l’option Near (Proche) du paramètre Temporal Relationship (Relation temporelle), utilisez une valeur plus petite pour le paramètre Temporal Near Distance (Distance de proximité temporelle).
  • Utilisez les données locales de l’environnement de l’analyse.

• Cet outil de géotraitement est mis en œuvre 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

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Couche en entrée	Entités ponctuelles, linéaires ou surfaciques qui sont groupées.	Feature Set
Nom en sortie	Nom du service d’entités en sortie. Nom du service d’entités en sortie comportant les entités groupées représenté par un nouveau champ nommé group_id	String
Relation spatiale	Spécifie le type de relation déterminant le groupement des entités. Intersecte—Les entités sont groupées lorsque des entités ou des portions d’entités se superposent. Il s’agit de l’option par défaut. Touche—Les entités sont groupées avec une autre entité si elles s’intersectent en un sommet, mais qu’elles ne sont pas superposées. Proche plan—Les entités sont groupées si un sommet ou un tronçon se situe dans une distance planaire donnée d’une autre entité. Proche géodésique—Les entités sont groupées si un sommet ou un tronçon se situe dans une distance géodésique donnée d’une autre entité.	String
Distance de proximité spatiale (Facultatif)	Distance utilisée pour grouper les entités proches. Ce paramètre est utilisé uniquement lorsque le paramètre Spatial Relationship (Relation spatiale) a pour valeur Planar Near (proche planaire) ou Geodesic Near (Proche géodésique).	Linear Unit
Relation temporelle (Facultatif)	Spécifie les critères temporels utilisés pour apparier les entités. Lorsque le paramètre est défini sur Intersects (Intersecte) ou Near (Proche), les entités sont groupées lorsque les critères spatiaux et temporels sont remplis. Les données temporelles doivent être activées sur l’entrée pour que cette option soit prise en charge. Intersecte—Les entités sont groupées lorsque n’importe quelle portion des données temporelles d’une entité se superpose à une autre entité. Il s’agit de l’option par défaut. Proche—Les entités sont groupées lorsque les données temporelles d’une entité se situent dans une plage de temps donnée d’une autre entité. Aucun—Les données temporelles ne sont pas utilisées pour grouper les entités.	String
Distance de proximité temporelle (Facultatif)	Distance temporelle utilisée pour grouper des entités proches. Ce paramètre est utilisé uniquement lorsque le paramètre Temporal Relationship (Relation temporelle) a pour valeur Near (Proche).	Time Unit
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
Relation attributaire (Facultatif)	Expression ArcGIS Arcade utilisée pour regrouper les entités. Par exemple, $a["Amount"] == $b["Amount"] regroupe les entités lorsque le champ Amount a la même valeur.	String

Sortie obtenue

Étiquette	Explication	Type de données
Couche d’entités en sortie	Nouvelle classe d’entités comportant les entités groupées représentée par un nouveau champ nommé group_id.	Feature Set

Python

arcpy.geoanalytics.GroupByProximity(input_layer, output_name, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {data_store}, {attribute_relationship})

Nom	Explication	Type de données
input_layer	Entités ponctuelles, linéaires ou surfaciques qui sont groupées.	Feature Set
output_name	Nom du service d’entités en sortie. Nom du service d’entités en sortie comportant les entités groupées représenté par un nouveau champ nommé group_id	String
spatial_relationship	Spécifie le type de relation déterminant le groupement des entités. INTERSECTS—Les entités sont groupées lorsque des entités ou des portions d’entités se superposent. Il s’agit de l’option par défaut. TOUCHES—Les entités sont groupées avec une autre entité si elles s’intersectent en un sommet, mais qu’elles ne sont pas superposées. NEAR_PLANAR—Les entités sont groupées si un sommet ou un tronçon se situe dans une distance planaire donnée d’une autre entité. NEAR_GEODESIC—Les entités sont groupées si un sommet ou un tronçon se situe dans une distance géodésique donnée d’une autre entité.	String
spatial_near_distance (Facultatif)	Distance utilisée pour grouper les entités proches. Ce paramètre est utilisé uniquement lorsque le paramètre spatial_relationship a pour valeur NEAR_PLANAR ou NEAR_GEODESIC.	Linear Unit
temporal_relationship (Facultatif)	Spécifie les critères temporels utilisés pour apparier les entités. Lorsque le paramètre est défini sur INTERSECTS ou NEAR, les entités sont groupées lorsque les critères spatiaux et temporels sont remplis. Les données temporelles doivent être activées sur l’entrée pour que cette option soit prise en charge. INTERSECTS—Les entités sont groupées lorsque n’importe quelle portion des données temporelles d’une entité se superpose à une autre entité. Il s’agit de l’option par défaut. NEAR—Les entités sont groupées lorsque les données temporelles d’une entité se situent dans une plage de temps donnée d’une autre entité. NONE—Les données temporelles ne sont pas utilisées pour grouper les entités.	String
temporal_near_distance (Facultatif)	Distance temporelle utilisée pour grouper des entités proches. Ce paramètre est utilisé uniquement lorsque le paramètre temporal_relationship a pour valeur Near.	Time Unit
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
attribute_relationship (Facultatif)	Expression ArcGIS Arcade utilisée pour regrouper les entités. Par exemple, $a["Amount"] == $b["Amount"] regroupe les entités lorsque le champ Amount a la même valeur.	String

Sortie obtenue

Nom	Explication	Type de données
output	Nouvelle classe d’entités comportant les entités groupées représentée par un nouveau champ nommé group_id.	Feature Set

Exemple de code

Exemple d’utilisation de l’outil GroupByProximity (script autonome)

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

# Name: GroupByProximity.py
# Description: Group roads together that touch
#
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://myGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_cityData/BigDataCatalogServer/roads"
outFS = "groupedRoads"
overlayType = "TOUCHES"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Group By Proximity
result = arcpy.geoanalytics.GroupByProximity(inFeatures, outFS, 
                                 overlayType, data_store=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 stockage des données spatio-temporelles dans WGS84.

Informations de licence

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