Rechercher des emplacements similaires (GeoAnalytics)

Synthèse

Identifie les entités candidates les plus semblables (ou dissemblables) à une ou plusieurs entités en entrée en fonction d’attributs d’entités.

Illustration

Utilisation

• Des entités tabulaires, ponctuelles, linéaires ou surfaciques peuvent être utilisées.

• Une couche de recherche (candidate) en entrée est requise. Les entités contenues dans la couche de recherche sont classées selon leur similarité avec les emplacements (de référence) en entrée.

• Si une ou plusieurs entités se trouvent dans la couche en entrée, l'appariement est effectué en calculant la moyenne des valeurs de la couche en entrée. Par exemple, s’il existe deux entités Input Layer (Couche en entrée) et que l’un des attributs Analysis Fields (Champs d’analyse) contient une variable liée à la population, l’outil va rechercher les couches de recherche (Search Layers) dont la population s’approche le plus des valeurs de population moyennes. Si les valeurs de population sont de 100 et 102, par exemple, l’outil recherche des candidats dont la population avoisine 101.

  Remarque :

  S’il existe plus d’une couche en entrée (Input Layer), choisissez les attributs Analysis Fields (Champs d’analyse) dont les valeurs sont les plus proches. Si, par exemple, la valeur de population de l’une des entrées est de 100 et que l’autre entrée est de 100 000, l’outil recherche des correspondances dont la population avoisine la moyenne de ces deux valeurs, à savoir 50 050. Vous remarquerez que cette moyenne ne correspond à la valeur de population d’aucune couche en entrée (Input Layer).

• Utilisez le paramètre Most Or Least Similar (Les plus ou les moins similaires) pour rechercher les entités qui sont les plus similaires ou les moins similaires aux entités Input Layer (Couche en entrée) en utilisant respectivement l’option Most similar (Le plus similaire) ou Least similar (Le moins similaire). Dans certains cas, vous pouvez avoir besoin de consulter les deux paramètres. Si la valeur du paramètre Number of Results (Nombre de résultats) est égale à 3 et que la valeur du paramètre Most Or Least Similar (Les plus ou les moins similaires) est définie sur Both (Les deux), par exemple, l’outil renvoie les trois entités candidates les plus similaires et les trois entités candidates les moins similaires.

• Les solutions données dans Output Features (Entités en sortie) sont soit la solution la plus similaire, soit la moins similaire à Input Layer (Couche en entrée) cibles. Une seule solution ne peut pas être les deux à la fois (et les solutions ne sont pas dupliquées dans Output Features (Entités en sortie)). En conséquence, lorsque la valeur du paramètre Most Or Least Similar (Les plus ou les moins similaires) est Both (Les deux), le nombre maximal de résultats possibles (Number of Results (Nombre de résultats)) correspond à la moitié du nombre de la valeur Search Layer (Couche de recherche).

• Un maximum de 10 000 entités de la couche de recherche peuvent être renvoyées.

• Le paramètre Match Method (Méthode d’appariement) comporte les options de valeurs suivantes :

  • Attribute values (Valeurs attributaires) : les candidats les plus similaires auront la plus petite somme des différences au carré pour tous les attributs Analysis Fields (Champs d’analyse). Toutes les valeurs sont normalisées avant le calcul des différences.
  • Attribute profiles (Profils attributaires) : la similarité cosinusoïdale est mesurée. La similarité cosinusoïdale recherche les relations identiques parmi les valeurs attributaires normalisées au lieu de se préoccuper de l’appariement des amplitudes des attributs. Supposons par exemple qu’il existe trois Analysis Fields (Champs d’analyse) nommés A1, A2 et A3. A2 est deux fois plus grand qu'A1 et A3 est presque identique à A2. Si la valeur du paramètre Match Method (Méthode d’appariement) est Attribute profiles (Profils attributaires), l’outil va rechercher les candidats présentant les mêmes relations attributaires : A2 deux fois plus grand qu’A1 et A3 presque égal à A2. Comme cette méthode recherche des relations entre les attributs, vous devez spécifier un minimum de deux attributs Analysis Fields (Champs d’analyse). Vous pouvez utiliser la méthode de similarité cosinusoïdale (c’est-à-dire l’option Attribute profiles (Profils attributaires)) pour trouver des sites similaires à Los Angeles, mais à une échelle différente. Par exemple, vous pouvez vous intéresser au profil de la population par rapport au nombre de voitures et au nombre d’habitants de moins de 20 ans. L'index de similarité cosinusoïdale s'étend de 1,0 (similarité parfaite) à -1,0 (dissemblance parfaite). L'index de similarité cosinusoïdale est indiqué dans le champ simindex (similarité cosinusoïdale) des Output Features (Entités en sortie).

• Le paramètre Analysis Fields (Champs d’analyse) doit être numérique et présenter les mêmes nom et type de champ dans les jeux de données Input Layer (Couche en entrée) et Search Layer (Couche de recherche). Si l’outil ne trouve aucun champ correspondant pour Search Layer (Couche de recherche), un avertissement indique que les attributs manquants ont été ignorés dans l’analyse.

• Tous les attributs utilisés pour l'appariement sont inscrits dans la sortie. Le paramètre Append Fields (Ajouter des champs) vous permet d’indiquer les champs à ajouter à la table en sortie. Par défaut, tous les champs sont ajoutés. Utilisez le paramètre Append Fields (Ajouter des champs) pour sélectionner des champs dans la couche de recherche (Search Layer) que vous souhaitez ajouter.

• Le paramètre Input Layer (Couche en entrée) et les solutions correspondantes sont inscrits dans les entités en sortie ainsi que dans les paramètres Analysis Fields (Champs d’analyse) et Append Fields (Ajouter des champs). De plus, les champs suivants sont inclus dans les entités en sortie :

  Nom du champ	Description	Remarques
  location_type	Chaîne indiquant si les entités sont une couche de référence (entrée) ou une couche candidate (recherche).
  simrank	Lorsque vous sélectionnez Most Similar (Le plus similaire) ou Both (Les deux) comme valeur du paramètre Most Or Least Similar (Les plus ou les moins similaires), toutes les solutions sont classées des plus similaires aux moins similaires. La valeur de classement de la solution la plus similaire est de 1.	Ce champ est inclus uniquement dans les entités en sortie lorsque vous sélectionnez Most Similar (Le plus similaire) ou Both (Les deux) comme valeur du paramètre Most Or Least Similar (Les plus ou les moins similaires).
  dissimrank	Lorsque vous sélectionnez Least Similar (Le moins similaire) ou Both (Les deux) comme valeur du paramètre Most Or Least Similar (Les plus ou les moins similaires), toutes les solutions sont classées des moins similaires aux plus similaires. La valeur de classement de la solution la moins similaire est de 1.	Ce champ est inclus uniquement dans les entités en sortie (Output Features) lorsque vous sélectionnez Least Similar (Le moins similaire) ou Both (Les deux) comme valeur du paramètre Most Or Least Similar (Les plus ou les moins similaires).
  simindex	Ce champ quantifie la similarité de chaque solution par rapport à l'entité cible. Lorsque vous spécifiez Attribute values (Valeurs attributaires) comme valeur du paramètre Match Method (Méthode d’appariement), cette valeur représente la somme des différences des valeurs au carré. Pour en savoir plus sur le calcul de cet index, reportez-vous à la rubrique Fonctionnement de Recherche de similarités.	Ce champ est inclus uniquement dans les entités en sortie (Output Features) lorsque vous sélectionnez Attribute values (Valeurs attributaires) comme valeur du paramètre Match Method (Méthode d’appariement).
  cosimindex	Ce champ quantifie la similarité de chaque solution par rapport à l'entité cible. Lorsque vous spécifiez Attribute profiles (Profils attributaires) comme valeur du paramètre Match Method (Méthode d’appariement), cette valeur représente la similarité cosinusoïdale. Pour en savoir plus sur le calcul de cet index, reportez-vous à la rubrique Fonctionnement de Recherche de similarités.	Ce champ est inclus uniquement dans les entités en sortie (Output Features) lorsque vous sélectionnez Attribute profiles (Profils attributaires) comme valeur du paramètre Match Method (Méthode d’appariement).
  labelrank	Ce champ est fourni uniquement à des fins d’affichage. L'outil utilise ce champ pour fournir le rendu par défaut des résultats d'analyse.
  reference_id	Valeur d’ID unique pour les entités de référence. Les entités de recherche reçoivent une valeur nulle.	Ce champ est disponible dans la version ArcGIS Enterprise 10.6.1 ou ultérieure.
  search_id	Valeur d’ID unique des entités de recherche. Les entités de référence reçoivent une valeur nulle.	Ce champ est disponible dans la version ArcGIS Enterprise 10.6.1 ou ultérieure.

• La classe d’entités en sortie est ajoutée automatiquement à la table des matières, le rendu par défaut étant appliqué au champ labelrank.

• Vous pouvez améliorer les performances de l’outil Rechercher des emplacements similaires en suivant les conseils ci-après :

  • Définissez l’environnement de l’étendue de manière à analyser uniquement des données d’intérêt.
  • Sélectionnez seulement quelques entités dans la couche de référence.
  • 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

• Une analyse semblable peut également être réalisée à l’aide de l’outil Similarity Search (Recherche de similarités) de la boîte d’outils Statistiques spatiales dans ArcGIS Pro.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Couche en entrée	Couche de référence (ou une sélection sur une couche) contenant les entités à apparier. L’outil recherche d’autres entités similaires à ces entités. Lorsque plusieurs entités sont fournies, l'appariement repose sur la moyenne des attributs.	Record Set
Rechercher dans la couche	Couche candidate (ou une sélection sur une couche) contenant les entités correspondant aux entités candidates. L’outil recherche les entités les plus similaires (ou dissemblables) au paramètre Input Layer (Couche en entrée) parmi ces candidats.	Record Set
Nom en sortie	Nom de la classe d’entités en sortie. La classe d’entités en sortie contient un enregistrement pour chacun des paramètres Input Layer (Couche en entrée) et pour toutes les solutions trouvées.	String
Champs d'analyse	Une liste d'attributs numériques représentant les critères d'appariement.	String
Les plus ou les moins similaires	Indique si les entités à rechercher sont les plus similaires ou les moins similaires au paramètre Input Layer (Couche en entrée). Le plus similaire—Recherche les entités les plus similaires. Le moins similaire—Recherche les entités les moins similaires. Les deux—Recherche à la fois les entités qui sont les plus similaires et les entités qui sont les moins similaires.	String
Méthode d'appariement	Indique si les appariements doivent reposer sur des valeurs ou des relations cosinusoïdales. Valeurs attributaires—La similarité et la dissemblance reposent sur la somme des différences des valeurs attributaires standardisées au carré de tous les attributs Analysis Fields (Champs d’analyse). Profils attributaires—La similarité et la dissemblance sont calculées comme une fonction de la similarité cosinusoïdale de tous les attributs Analysis Fields (Champs d’analyse).	String
Nombre de résultats	Nombre de solutions à trouver. Pour classer toutes les entités candidates, et 10 000 au maximum, entrez zéro ou un nombre supérieur au nombre total d’entités de type Search Layer (Couche de recherche).	Long
Champs d’ajout (Facultatif)	Une liste facultative d’attributs à inclure avec la sortie. Vous pouvez inclure un identifiant de nom, un champ de catégorie ou un champ de date, par exemple. Ces champs ne sont pas utilisés pour déterminer la similarité. Ils sont inclus uniquement dans les attributs du paramètre en sortie à titre de référence. Par défaut, tous les champs sont ajoutés.	Field
Stockage des données (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

Sortie obtenue

Étiquette	Explication	Type de données
Classe d'entités en sortie	Entités de l’entrée et pour toutes les solutions trouvées.	Jeu d'enregistrements

Python

arcpy.geoanalytics.FindSimilarLocations(input_layer, search_layer, output_name, analysis_fields, most_or_least_similar, match_method, number_of_results, {append_fields}, {data_store})

Nom	Explication	Type de données
input_layer	Couche de référence (ou une sélection sur une couche) contenant les entités à apparier. L’outil recherche d’autres entités similaires à ces entités. Lorsque plusieurs entités sont fournies, l'appariement repose sur la moyenne des attributs.	Record Set
search_layer	Couche candidate (ou une sélection sur une couche) contenant les entités correspondant aux entités candidates. L’outil recherche les entités les plus similaires (ou dissemblables) au paramètre input_layer parmi ces candidats.	Record Set
output_name	Nom du service d’entités en sortie. Le service d’entités en sortie contient un enregistrement pour chacun des paramètres input_layer et pour toutes les solutions trouvées.	String
analysis_fields [analysis_fields,...]	Une liste d'attributs numériques représentant les critères d'appariement.	String
most_or_least_similar	Indique si les entités à rechercher sont les plus similaires ou les moins similaires au paramètre input_layer. MOST_SIMILAR—Recherche les entités les plus similaires. LEAST_SIMILAR—Recherche les entités les moins similaires. BOTH—Recherche à la fois les entités qui sont les plus similaires et les entités qui sont les moins similaires.	String
match_method	Indique si les appariements doivent reposer sur des valeurs ou des relations cosinusoïdales. ATTRIBUTE_VALUES—La similarité et la dissemblance reposent sur la somme des différences des valeurs attributaires standardisées au carré de tous les attributs analysis_fields. ATTRIBUTE_PROFILES—La similarité et la dissemblance sont calculées comme une fonction de similarité cosinusoïdale de tous les attributs analysis_fields.	String
number_of_results	Nombre de solutions à trouver. Pour classer toutes les entités candidates, et 10 000 au maximum, entrez zéro ou un nombre supérieur au nombre total d’entités de type search_layer.	Long
append_fields [append_fields,...] (Facultatif)	Une liste facultative d’attributs à inclure avec la sortie. Vous pouvez inclure un identifiant de nom, un champ de catégorie ou un champ de date, par exemple. Ces champs ne sont pas utilisés pour déterminer la similarité. Ils sont inclus uniquement dans les attributs du paramètre en sortie à titre de référence. Par défaut, tous les champs sont ajoutés.	Field
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

Sortie obtenue

Nom	Explication	Type de données
output	Entités de l’entrée et pour toutes les solutions trouvées.	Jeu d'enregistrements

Exemple de code

FindSimilarLocations (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil FindSimilarLocations.

#-------------------------------------------------------------------------------
# Name: FindSimilarLocations.py
# Description: Find Similar stores to a top performing store
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
referenceStore = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Stores/BigDataCatalogServer/TopPerformer"
candidateStores = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Stores/BigDataCatalogServer/AllStores"
analysisFields = [ "SickDays", "TotalCustomers", "AvgPurchaseAmount"]
outputName = "BestStores_10"
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute Find Similar Locations
arcpy.geoanalytics.FindSimilarLocations(referenceStore, candidateStores, 
                                        outputName, analysisFields, 
                                        "MOST_SIMILAR", "ATTRIBUTE_VALUES", 10, 
                                        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 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