| Étiquette | Explication | Type de données |
Couche en entrée | Couche ponctuelle, linéaire ou surfacique à synthétiser. | Feature Layer |
Entité centrale en sortie | La classe d'entités en sortie qui contiendra l’entité la plus au centre dans la couche en entrée. | Feature Class |
Centre moyen en sortie (Facultatif) | La classe d’entités ponctuelles en sortie qui contiendra les entités représentant les centres moyens de la couche en entrée. | Feature Class |
Centre médian en sortie (Facultatif) | La classe d'entités ponctuelles en sortie qui contiendra les entités représentant les centres médians de la couche en entrée. | Feature Class |
Ellipse en sortie (Facultatif) | La classe d'entités surfaciques en sortie qui contiendra la représentation de l’ellipse directionnelle de la couche en entrée. | Feature Class |
Taille de l'ellipse (Facultatif) | Spécifie la taille des ellipses en sortie en écarts types.
| String |
Champ de pondération (Facultatif) | Champ numérique permettant de pondérer les emplacements en fonction de leur importance relative. Ceci s'applique à tous les types de résumés. | Field |
Grouper par champ (Facultatif) | Champ utilisé pour regrouper des entités similaires. Ceci s'applique à tous les types de résumés. Par exemple, si vous choisissez un champ nommé PlantTypecontenant des valeurs liées aux arbres, buissons et herbages, toutes les entités avec la valeur arbre seront analysées pour leur propre centre ou dispersion. Cet exemple aura pour résultat trois entités, une pour chaque groupe d’arbres, de buissons et d’herbages. | Field |
Synthèse
Recherche des entités centrales et des distributions directionnelles et calcule les emplacements moyens et médians à partir de l’entrée.
Illustration
Utilisation
Cet outil peut être utilisé pour la centralité et la dispersion des entités. Voici quelques exemples de situations où l’utilisation de cet outil s’avère utile :
- Une administration locale prévoit d’ouvrir une nouvelle bibliothèque pour une communauté non desservie. Les centroïdes des groupes de blocs avec le zonage approprié et les lots disponibles ont été collectés. Le calcul d’une entité centrale avec une pondération sur la population peut être utilisé pour identifier le groupe de blocs central qui servira au mieux la communauté.
- Un analyste SIG analyse les emplacements des appels 911 et ceux des postes d’intervention d’urgence (police, pompiers et ambulances). Le calcul d'un centre moyen permet de comparer le centre moyen des appels d’urgence au centre moyen des postes d’intervention afin d’optimiser le temps de réponse.
- Un analyste de la criminalité souhaite déterminer si le centre médian des cambriolages se déplace lors de l’évaluation des incidents de jour et de nuit. Un centre médian calculé avec un groupe par heure de la journée permet de déterminer où sont commis les délits au cours de la journée et de la nuit.
- Un analyste SIG d’une organisation non gouvernementale analyse la propagation d’une maladie infectieuse. Une ellipse peut être utilisée pour modéliser la propagation de l’épidémie.
Pour les entités linéaires et surfaciques en entrée, les centroïdes d'entité sont utilisés dans les calculs de distance.
Le paramètre Champ de pondération permet de pondérer les emplacements en fonction de leur importance relative. Il est par exemple possible de pondérer les magasins d’une grande chaîne par rapport au total des ventes, ou les entités surfaciques par rapport à leur surface. Reportez-vous à la section Application des pondérations pour plus d'informations sur la façon dont les pondérations sont appliquées dans l’analyse.
Le paramètre Regrouper par champ permet de regrouper les entités pour des calculs distincts des entités centrales ou de la dispersion. Par exemple, les observations de la faune tout au long de l’année peuvent être regroupées par saison ou par mois. Ce champ peut être de type entier, date ou chaîne. Les enregistrements comportant des valeurs nulles seront regroupés ensemble.
L’entité centrale est l’entité associée à la plus petite distance cumulée vers toutes les autres entités du jeu de données. Cette entité est identifiée et incluse dans la sortie Couche d’entités centrales. Plusieurs entités peuvent partager la plus petite distance cumulée vers toutes les autres entités. Lorsque c’est le cas, toutes les entités les plus centrales sont incluses dans la sortie Central Feature Layer (Couche d’entités centrales). Lorsqu'une valeur de paramètre Group By Field (Grouper par champ) est spécifiée, les entités en entrée sont groupées en premier selon les valeurs du champ ; une entité centrale est ensuite identifiée pour chaque groupe. L’entité centrale en sortie doit avoir le même type de géométrie que les entités en entrée.
Le centre moyen est un point construit à partir des coordonnées x et y moyennes. Les entités de centre moyen sont incluses dans la sortie Mean Center Layer (Couche de centre moyen). Lorsqu'une valeur Group By Field (Grouper par champ) est spécifiée, les entités en entrée sont groupées en premier selon les valeurs du champ ; le centre moyen est ensuite calculé pour chaque groupe.
-
Le centre médian utilise un algorithme itératif pour identifier le point géométrique médian qui minimise la distance euclidienne vers toutes les entités du jeu de données. Les entités de centre médian sont incluses dans la sortie Median Center Layer (Couche de centre médian). Lorsqu'une valeur Group By Field (Grouper par champ) est spécifiée, les entités en entrée sont groupées en premier selon les valeurs du champ ; le centre médian est ensuite calculé pour chaque groupe. Contrairement aux résultats de l’opération de centre moyen, les résultats de l’opération de centre médian sont moins influencés par les entités aberrantes.
Des ellipses d'écart type sont créées pour récapituler les caractéristiques spatiales des entités géographiques : tendance centrale, dispersion et tendances directionnelles. Les ellipses peuvent être dimensionnées en 1, 2 ou 3 écarts types. Les entités ellipses sont incluses dans la sortie Ellipse Layer (Couche d’ellipses). Lorsqu'une valeur Group By Field (Grouper par champ) est spécifiée, les entités en entrée sont groupées en premier selon les valeurs du champ ; une ellipse est ensuite calculée pour chaque groupe.
Vous pouvez spécifier un ou plusieurs types de résumés à générer. Chaque type de résumé sera généré dans une couche d’entités unique.
Si la couche en entrée comporte des entités ayant des valeurs de temps ou de géométrie nulles, ces entités ne seront pas utilisées dans l’analyse.
Outre les champs provenant de la couche en entrée, les champs suivants seront inclus dans le résultat du paramètre Entité centrale en sortie :
Nom du champ Description CoordX
Coordonnée x de l’entité centrale. Si l’entité est une ligne ou un polygone, la valeur représentera le centroïde de l’entité.
CoordY
Coordonnée y de l’entité centrale. Si l’entité est une ligne ou un polygone, la valeur représentera le centroïde de l’entité.
date
Si la couche en entrée est temporelle avec un temps de type instant, le résultat en sortie inclura un champ de date de type instant représentant l’heure de l’entité en sortie.
start_date
Si la couche en entrée est temporelle avec un temps de type intervalle, le résultat en sortie inclura un champ de date de début représentant l’heure de début de l’entité en sortie.
end_date
Si la couche en entrée est temporelle avec un temps de type intervalles, le résultat en sortie inclura un champ de date de fin instant représentant l’heure de fin de l’entité en sortie.
Outre la valeur du paramètre facultatif Grouper par champ utilisée dans l’analyse, les champs suivants seront inclus dans les résultats des paramètres Centre moyen en sortie et Centre médian en sortie :
Nom du champ Description CoordX
Coordonnée x de l’entité médiane ou moyenne.
CoordY
Coordonnée y de l’entité médiane ou moyenne.
date
Si la couche en entrée est temporelle, le résultat en sortie inclura un champ de date de type instant représentant l’heure moyenne ou médianne des entités en entrée. Ceci s’applique aux couches en entrée des types intervalle et instant.
Outre la valeur du paramètre facultatif Grouper par champ utilisée dans l’analyse, les champs suivants seront inclus dans le type de résumé Ellipse en sortie :
Nom du champ Description CenterX
Coordonnée x du centre moyen de l’ellipse.
CenterY
Coordonnée y du centre moyen de l’ellipse.
CenterT
Valeur temporelle du centre moyen de l’ellipse.
Rotation
Rotation de l'axe long mesurée dans le sens horaire à partir de midi. La rotation est mesurée dans les unités de la référence spatiale en entrée. Par exemple, un jeu de données projetées pourrait être mesuré en mètres, et un jeu de données géographiques pourrait être mesuré en degrés.
MajStdDist
La distance standard du grand axe. La rotation est mesurée dans les unités de la référence spatiale en entrée. Par exemple, un jeu de données avec une référence spatiale projetée pourrait être mesuré en mètres, et un jeu de données avec une référence spatiale géographique pourrait être mesuré en degrés
MinStdDist
La distance standard du petit axe. La rotation est mesurée dans les unités de la référence spatiale en entrée. Par exemple, un jeu de données avec une référence spatiale projetée pourrait être mesuré en mètres, et un jeu de données avec une référence spatiale géographique pourrait être mesuré en degrés
TmStdDist
La distance temporelle standard. Cette valeur est une durée mesurée en millisecondes.
Toutes les valeurs des coordonnées en sortie seront calculées à l’aide de la référence spatiale de l’analyse. Par défaut, la référence spatiale de l’analyse est la même que celle de la couche en entrée. Vous pouvez éventuellement spécifier la référence spatiale utilisée dans l’analyse à l’aide de la variable d'environnement du système de coordonnées en sortie.
Vous pouvez améliorer les performances de l’outil Synthétiser le centre et la dispersion 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.
- Utilisez les données locales de l’environnement de l’analyse.
- Groupez vos données à l’aide du paramètre Group By Field (Grouper par champ).
- Pour les jeux de données plus volumineux, utilisez lCentre médian pour le paramètre Générer des types, car celui-ci peut s’avérer le moins performant en raison de ses calculs itératifs.
Vous pouvez effectuer une analyse semblable en utilisant les outils de statistiques spatiales suivants :
- Rechercher l’entité centrale à l’aide de l’outil Entité centrale.
- Calculer le centre moyen à l’aide de l’outil Centre moyen.
- Calculer le centre médian à l’aide de l’outil Centre médian.
- Calculer une ellipse à l’aide de l'outil Distribution directionnelle (Ellipse d'écart type).
Cet outil de géotraitement est mis en œuvre par Spark. L’analyse est effectuée sur votre ordinateur de bureau en utilisant plusieurs cœurs en parallèle. Pour en savoir plus sur l’exécution de l’analyse, reportez-vous à la rubrique Remarques relatives aux outils GeoAnalytics Desktop.
Lorsque vous exécutez des outils GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être accessibles sur votre bureau. Si vous utilisez une couche d’entités hébergée, nous vous recommandons de faire appel à ArcGIS GeoAnalytics Server. Si vos données ne sont pas enregistrées en local, l’exécution des outils prendra plus de temps. Pour utiliser votre instance ArcGIS GeoAnalytics Server en vue d’une analyse, reportez-vous à la rubrique GeoAnalytics Tools.
Paramètres
arcpy.gapro.SummarizeCenterAndDispersion(input_layer, out_central_feature, {out_mean_center}, {out_median_center}, {out_ellipse}, {ellipse_size}, {weight_field}, {group_by_field})| Nom | Explication | Type de données |
input_layer | Couche ponctuelle, linéaire ou surfacique à synthétiser. | Feature Layer |
out_central_feature | La classe d'entités en sortie qui contiendra l’entité la plus au centre dans la couche en entrée. | Feature Class |
out_mean_center (Facultatif) | La classe d’entités ponctuelles en sortie qui contiendra les entités représentant les centres moyens de la couche en entrée. | Feature Class |
out_median_center (Facultatif) | La classe d'entités ponctuelles en sortie qui contiendra les entités représentant les centres médians de la couche en entrée. | Feature Class |
out_ellipse (Facultatif) | La classe d'entités surfaciques en sortie qui contiendra la représentation de l’ellipse directionnelle de la couche en entrée. | Feature Class |
ellipse_size (Facultatif) | Spécifie la taille des ellipses en sortie en écarts types.
| String |
weight_field (Facultatif) | Champ numérique permettant de pondérer les emplacements en fonction de leur importance relative. Ceci s'applique à tous les types de résumés. | Field |
group_by_field (Facultatif) | Champ utilisé pour regrouper des entités similaires. Ceci s'applique à tous les types de résumés. Par exemple, si vous choisissez un champ nommé PlantTypecontenant des valeurs liées aux arbres, buissons et herbages, toutes les entités avec la valeur arbre seront analysées pour leur propre centre ou dispersion. Cet exemple aura pour résultat trois entités, une pour chaque groupe d’arbres, de buissons et d’herbages. | Field |
Exemple de code
Le script autonome suivant illustre l’utilisation de la fonction SummarizeCenterAndDispersion.
# Name: SummarizeCenterAndDispersion.py
# Description: Calculate the directionality and movement of fire occurrences
# over time. This sample calculates a mean center and a standard
# deviational ellipse.
# Requirements: ArcGIS Pro Advanced license
# Import system modules
import arcpy
# Set local variables
inFeatures = r"c:\data\MyBigDataConnection.bdc\fire_incidents"
outMeanCenter = r"c:\data\FireIncidents.gdb\fires_meancenter"
outEllipse = r"c:\data\FireIncidents.gdb\fires_ellipse"
# Execute SummarizeCenterAndDispersion
arcpy.gapro.SummarizeCenterAndDispersion(inFeatures, "", outMeanCenter, "",
outEllipse, "2_STANDARD_DEVIATIONS")Environnements
Cas particuliers
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?