Calcule une grandeur par unité de carte à partir d'entités ponctuelles qui se trouvent dans le voisinage donné de chaque cellule.
Héritage :
L’extension ArcGIS GeoAnalytics Server devient obsolète dans ArcGIS Enterprise. La dernière version de GeoAnalytics Server a été incluse avec ArcGIS Enterprise 11.3. Cet outil de géotraitement est accessible via ArcGIS Enterprise 11.3 et versions antérieures.
L’outil Calculer la densité requiert une seule entrée d’entités ponctuelles.
La densité peut ê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 de voisinage permet de rechercher les entités en entrée qui se trouvent dans le même voisinage que l’entité (groupe) considérée.
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’outil Calculer la densité exige que la couche surfacique se trouve dans un système de coordonnées projetées. Si les données ne sont pas projetées et si vous ne définissez pas de système de coordonnées projetées, l’analyse est effectuée dans la projection World Cylindrical Equal Area (WKID 54034).
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. 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 des champs.
Lorsque des entités en entrée sont analysées à l’aide d’intervalles temporels, chaque intervalle temporel est analysé indépendamment des entités en dehors de cet intervalle temporel.
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_datetime
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_datetime
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 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.
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 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.
Points qui seront utilisés pour calculer la densité.
Feature Set
Nom en sortie
Nom du service d’entités en sortie.
String
Type de groupe
Spécifie la forme de groupe qui sera utilisée dans l’analyse.
Carré—La forme de groupe sera carrée. Il s’agit de l’option par défaut.
Hexagone—La forme de groupe sera hexagonale.
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 à appliquer à la fonction de densité.
Uniforme—Un calcul de grandeur par carte dans lequel une pondération égale est appliquée à chaque groupe est utilisé. Il s’agit de l’option par défaut.
Noyau—Un calcul de grandeur par carte via un algorithme de lissage (noyau) qui applique une pondération plus importante aux groupes les plus proches des points est utilisé.
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 à utiliser 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.
Acres internationales—Les unités de surface sont les acres internationales.
Hectares—Les unités de surface sont les hectares.
Milles terrestres carrés—Les unités de surface sont les milles terrestres carrés.
Kilomètres carrés—Les unités de surface sont les kilomètres carrés.
Mètres carrés—Les unités de surface sont les mètres carrés.
Pieds internationaux carrés—Les unités de surface sont les pieds internationaux carrés.
Yards internationaux carrés—Les unités de surface sont les yards internationaux carrés.
Milles d'arpentage américains carrés—Les unités de surface sont les milles d’arpentage américains carrés.
Pieds d'arpentage américains carrés—Les unités de surface sont les pieds d’arpentage américains carrés.
Yards d'arpentage américains carrés—Les unités de surface sont les yards d’arpentage américains carrés.
Acres d’arpentage américaines—Les unités de surface sont les acres d’arpentage américaines.
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
Data store
(Facultatif)
Indique le ArcGIS Data Store où la sortie sera stockée. 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
Calcule une surface de grandeur par unité à partir d’entités ponctuelles qui se trouvent dans le voisinage donné de chaque cellule.
Points qui seront utilisés pour calculer la densité.
Feature Set
output_name
Nom du service d’entités en sortie.
String
bin_type
Spécifie la forme de groupe qui sera utilisée dans l’analyse.
SQUARE—La forme de groupe sera carrée. Il s’agit de l’option par défaut.
HEXAGON—La forme de groupe sera hexagonale.
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 à appliquer à la fonction de densité.
UNIFORM—Un calcul de grandeur par carte dans lequel une pondération égale est appliquée à chaque groupe est utilisé. Il s’agit de l’option par défaut.
KERNEL—Un calcul de grandeur par carte via un algorithme de lissage (noyau) qui applique une pondération plus importante aux groupes les plus proches des points est utilisé.
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 à utiliser 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.
ACRES—Les unités de surface sont les acres internationales.
HECTARES—Les unités de surface sont les hectares.
SQUARE_MILES—Les unités de surface sont les milles terrestres carrés.
SQUARE_KILOMETERS—Les unités de surface sont les kilomètres carrés.
SQUARE_METERS—Les unités de surface sont les mètres carrés.
SQUARE_FEET—Les unités de surface sont les pieds carrés.
SQUARE_YARDS—Les unités de surface sont les yards carrés.
SQUARE_MILES_US—Les unités de surface sont les milles d’arpentage américains carrés.
SQUARE_FEET_US—Les unités de surface sont les pieds d’arpentage américains carrés.
SQUARE_YARDS_US—Les unités de surface sont les yards d’arpentage américains carrés.
ACRES_US—Les unités de surface sont les acres d’arpentage américaines.
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
data_store
(Facultatif)
Indique le ArcGIS Data Store où la sortie sera stockée. 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
Calcule une surface de grandeur par unité à partir d’entités ponctuelles qui se trouvent dans le voisinage donné de chaque cellule.
Feature Set
Exemple de code
CalculateDensity (fenêtre Python)
Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction CalculateDensity.
# Name: Calculate Density.py
# Description: Calculate density using the count of points as well as the severity
# value of outbreaks by week.
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
# This example uses a big data file share name "HealthInfo" with dataset
# "Outbreaks" registered on a GeoAnalytics server
inFeatures = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_HealthInfo/BigDataCatalogServer/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
outFS = "OutbreakDensity"
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Run Calculate Density
arcpy.geoanalytics.CalculateDensity(inFeatures, outFS, 'HEXAGON', binSize,
'UNIFORM', neighborhoodSize, fields,
'SQUARE_KILOMETERS', timeStepInterval, None,
None, dataStore)
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.
