| Étiquette | Explication | Type de données |
Couche en entrée
| Points qui seront utilisés pour calculer la densité. | Feature Layer |
Classe d’entités en sortie
| Nouvelle classe d’entités contenant les densités calculées. | Feature Class |
Type de groupe
| Spécifie la forme de groupe qui sera utilisée dans l’analyse.
| String |
Taille du groupe
| La taille des groupes utilisés pour agréger les entités en entrée. Lors de la génération de groupes pour des carrés, le nombre et les unités spécifiés déterminent la hauteur et la longueur du carré. Pour des hexagones, le nombre et les unités spécifiés déterminent la distance entre les côtés parallèles. | Linear Unit |
Pondération | Spécifie la pondération appliquée à la fonction de densité.
| String |
Taille du voisinage | Rayon de recherche à appliquer aux calculs de densité. | Linear Unit |
Champs (Facultatif) | Un ou plusieurs champs indiquant les valeurs de population pour chaque entité. Le champ de population représente le total ou la quantité à répartir sur tout le paysage pour créer une surface continue. Les valeurs du champ de population doivent être numériques. Par défaut, la densité du nombre de points en entrée est toujours calculée. | Field |
Facteur d'échelle d'unité de surface
(Facultatif) | Spécifie les unités de surface utilisées pour les valeurs de densité en sortie. L'unité par défaut est basée sur les unités de la référence spatiale en sortie.
| String |
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 |
Synthèse
Calcule une grandeur par unité de carte à partir d'entités ponctuelles qui se trouvent dans le voisinage donné de chaque cellule.
En savoir plus sur le fonctionnement des intervalles temporels
Illustration
Utilisation
L’outil Calculer la densité requiert une seule entrée d’entités ponctuelles.
La densité peut également être calculée à l’aide d’un ou plusieurs champs de nombre. Un champ de nombre est un champ numérique qui indique le nombre d'incidents à chaque emplacement. Les entités, telles que les villes ou les autoroutes, peuvent utiliser un champ de nombre pour calculer la densité de la population ou les voies de trafic, respectivement. Si vous spécifiez un champ de nombre, la densité est calculée pour ce champ, en plus de la densité des points.
Les points en entrée sont agrégés dans des groupes à des fins d’analyse. Vous devez préciser la taille des groupes dans lesquels les données doivent être agrégées. Par défaut, les résultats en sortie sont indiqués en kilomètres carrés.
Les points en entrée sont agrégés en groupes d’une taille et d’une forme (hexagone ou carré) spécifiées. Si vous optez pour l’agrégation dans des hexagones, la taille du groupe d 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 du groupe d correspond à la hauteur du carré, qui est égale à la largeur.
Vous devez spécifier une taille de voisinage supérieure à la taille du groupe. La taille du voisinage permet de rechercher les entités en entrée au sein du même voisinage spécifiée comme entité (groupe) d’intérêt.
Des valeurs élevées de taille du voisinage produisent en sortie une densité plus généralisée. Des valeurs faibles produisent une sortie plus détaillée.
Seuls les points compris dans un voisinage sont pris en compte lors du calcul de la densité. Si aucun point n'est compris dans le voisinage d'une cellule spécifique, aucune valeur ne lui est attribuée.
Deux options de pondération permettent de calculer la densité : l’option Uniform (Uniforme) additionne toutes les valeurs au sein du voisinage et les divise par la surface. L’option Kernel (Noyau) pondère les valeurs du voisinage en fonction de la distance par rapport à l’entité considérée et applique une fonction de noyau pour ajuster une surface effilée régulière à chaque point.
Seules les surfaces situées dans le voisinage d’un groupe contenant des points sont renvoyées.
Si les unités du facteur d'échelle d'unité de surface sont petites par rapport à la distance entre les points, les valeurs en sortie risquent d'être très faibles. Pour obtenir des valeurs plus grandes, utilisez le facteur d’échelle d’unité de surface correspondant à des unités plus grandes (par exemple, Square Kilometers [Kilomètres carrés] au lieu de Square Meters [Mètres carrés]).
L’analyse avec regroupement nécessite de projeter votre entrée ou de définir le système de coordonnées en sortie sur un système de coordonnées projetées. Si vos données ne figurent pas dans un système de coordonnées projetées et si vous n’en définissez pas un, une projection sera utilisée en fonction de l’étendue des données que vous analysez.
Les valeurs de densité seront toujours des valeurs à virgule flottante.
Calculer la densité permet d’effectuer des analyses à l’aide de la discrétisation temporelle, s’il y a lieu. 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, vos 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 des champs.
Lorsque des entités en entrée sont analysées à l'aide d'intervalles de temps, chaque intervalle de temps est analysé indépendamment des entités en dehors de cet intervalle de temps.
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 density
Densité du polygone donné. Ce champ est renvoyé dans le facteur d’échelle d’unité spécifié.
density_<fieldname>
Densité pondérée par le champ donné. Ce champ est renvoyé uniquement lorsqu’un ou plusieurs champs sont indiqués.
start_date
Lorsque la discrétisation temporelle est spécifiée, les polygones en sortie ont un intervalle temporel. Ce champ représente l’heure de début.
end_date
Lorsque la discrétisation temporelle est spécifiée, les polygones en sortie ont un intervalle temporel. Ce champ représente l’heure de fin.
Vous pouvez améliorer les performances de l’outil Calculer la densité 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.
- Les groupes plus importants sont plus performants que les groupes de moindre taille. Si vous ne savez pas quelle taille utiliser, commencez par effectuer un prototype avec un groupe plus grand.
- À l’instar des groupes, les intervalles temporels plus importants sont plus performants que les intervalles de moindre importance.
- Réduisez le ratio de la taille du voisinage par rapport à la taille du groupe. Une taille du voisinage égale à trois fois la taille du groupe produira de meilleures performances qu’une taille du voisinage égale à dix fois la taille du groupe.
- Utilisez les données locales de l’environnement de l’analyse.
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.
Vous pouvez effectuer une analyse semblable en utilisant :
- Agréger des points dans la boîte d’outils GeoAnalytics Desktop ou la boîte d’outils GeoAnalytics Server
- L’outil Densité de point de la boîte d’outils Spatial Analyst
- L’outil Densité de noyau de la boîte d’outils Spatial Analyst
- L’outil Calculer la densité dans la boîte d’outils Analyse des entités standard
Paramètres
arcpy.gapro.CalculateDensity(input_layer, out_feature_class, bin_type, bin_size, weight, neighborhood_size, {fields}, {area_unit_scale_factor}, {time_step_interval}, {time_step_repeat}, {time_step_reference})| Nom | Explication | Type de données |
input_layer | Points qui seront utilisés pour calculer la densité. | Feature Layer |
out_feature_class | Nouvelle classe d’entités contenant les densités calculées. | Feature Class |
bin_type | Spécifie la forme de groupe qui sera utilisée dans l’analyse.
| String |
bin_size | La taille des groupes utilisés pour agréger les entités en entrée. Lors de la génération de groupes pour des carrés, le nombre et les unités spécifiés déterminent la hauteur et la longueur du carré. Pour des hexagones, le nombre et les unités spécifiés déterminent la distance entre les côtés parallèles. | Linear Unit |
weight | Spécifie la pondération appliquée à la fonction de densité.
| String |
neighborhood_size | Rayon de recherche à appliquer aux calculs de densité. | Linear Unit |
fields [fields,...] (Facultatif) | Un ou plusieurs champs indiquant les valeurs de population pour chaque entité. Le champ de population représente le total ou la quantité à répartir sur tout le paysage pour créer une surface continue. Les valeurs du champ de population doivent être numériques. Par défaut, la densité du nombre de points en entrée est toujours calculée. | Field |
area_unit_scale_factor (Facultatif) | Spécifie les unités de surface utilisées pour les valeurs de densité en sortie. L'unité par défaut est basée sur les unités de la référence spatiale en sortie.
| String |
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 |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil CalculateDensity.
#-------------------------------------------------------------------------------
# Name: Calculate Density.py
# Description: Calculate density using the count of points as well as the severity
# value of outbreaks by week.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/HealthInfo.gdb"
# Set local variables
inFeatures = "Outbreaks"
# By default, the count of points will be used in addition to any other fields
# that are specified
fields = "Severity"
# Set the size of bins and neighborhood and the time step size
binSize = "1 Kilometers"
neighborhoodSize = "2 Kilometers"
timeStepInterval = "1 Weeks"
# Specify output info
out = "OutbreakDenisty"
# Execute Calculate Density
arcpy.gapro.CalculateDensity(inFeatures, out, 'HEXAGON', binSize,
'UNIFORM', neighborhoodSize, fields,
'SQUARE_KILOMETERS', timeStepInterval)Environnements
Cas particuliers
Informations de licence
- Basic: Non
- Standard: Non
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?