Calculer la densité (GeoAnalytics Desktop)

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

Illustration de l’outil Calculer la densité

Utilisation

  • 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.

    Groupes hexagonaux et carrés

  • 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’analyse avec regroupement nécessite de projeter l’entrée ou de définir le système de coordonnées en sortie sur un système de coordonnées projetées. Si les 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. 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 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 champDescription

    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 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 Spark. L'analyse est effectuée sur votre ordinateur de bureau à l'aide de plusieurs cœurs en parallèle. Pour en savoir plus sur l'exécution d'une analyse, reportez-vous à la rubrique Remarques sur les outils de GeoAnalytics Desktop.

  • Lors de l’exécution d’outils de GeoAnalytics Desktop, l’analyse est effectuée sur votre ordinateur de bureau. Pour des performances optimales, les données doivent être disponibles sur votre bureau : Si vous utilisez une couche d’entités hébergée, il est recommandé d'utiliser ArcGIS GeoAnalytics Server. Si vos données ne sont pas locales, l'exécution d'un outil est plus longue. Pour utiliser votre ArcGIS GeoAnalytics Server en vue d'une analyse, reportez-vous à la rubrique GeoAnalytics Tools.

  • Vous pouvez effectuer une analyse semblable en utilisant :

Paramètres

ÉtiquetteExplicationType 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.

  • CarréLa forme de groupe sera carrée. Il s’agit de l’option par défaut.
  • HexagoneLa 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é.

  • UniformeUn 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.
  • NoyauUn 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 internationalesLes unités de surface sont les acres internationales.
  • HectaresLes unités de surface sont les hectares.
  • Milles terrestres carrésLes unités de surface sont les milles terrestres carrés.
  • Kilomètres carrésLes unités de surface sont les kilomètres carrés.
  • Mètres carrésLes unités de surface sont les mètres carrés.
  • Pieds internationaux carrésLes unités de surface sont les pieds internationaux carrés.
  • Yards internationaux carrésLes unités de surface sont les yards internationaux carrés.
  • Milles d'arpentage américains carrésLes unités de surface sont les milles d’arpentage américains carrés.
  • Pieds d'arpentage américains carrésLes unités de surface sont les pieds d’arpentage américains carrés.
  • Yards d'arpentage américains carrésLes unités de surface sont les yards d’arpentage américains carrés.
  • Acres d’arpentage américainesLes 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

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})
NomExplicationType 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.

  • SQUARELa forme de groupe sera carrée. Il s’agit de l’option par défaut.
  • HEXAGONLa 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é.

  • UNIFORMUn 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.
  • KERNELUn 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.

  • ACRESLes unités de surface sont les acres internationales.
  • HECTARESLes unités de surface sont les hectares.
  • SQUARE_MILESLes unités de surface sont les milles terrestres carrés.
  • SQUARE_KILOMETERSLes unités de surface sont les kilomètres carrés.
  • SQUARE_METERSLes unités de surface sont les mètres carrés.
  • SQUARE_FEETLes unités de surface sont les pieds carrés.
  • SQUARE_YARDSLes unités de surface sont les yards carrés.
  • SQUARE_MILES_USLes unités de surface sont les milles d’arpentage américains carrés.
  • SQUARE_FEET_USLes unités de surface sont les pieds d’arpentage américains carrés.
  • SQUARE_YARDS_USLes unités de surface sont les yards d’arpentage américains carrés.
  • ACRES_USLes 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

Exemple de code

Exemple d’utilisation de la fonction CalculateDensity (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction CalculateDensity.

# Name: CalculateDensity.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"

# Enable time on the input features using an .lyrx file.
# To create the .lyrx file, add your layer to a map, open the layer properties 
# and enable time. Then right-click the layer and select Share As Layer File.
inputLyrx = r'C:\data\outbreaks.lyrx'

# MakeFeatureLayer converts the .lyrx to features
outbreaksLayer = arcpy.management.MakeFeatureLayer(inputLyrx, "outbreaks_layer")

# ApplySymbologyFromLayer sets the time using the .lyrx file definition
arcpy.management.ApplySymbologyFromLayer(outbreaksLayer, inputLyrx)

# 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 = "OutbreakDensity"


# Run Calculate Density
arcpy.gapro.CalculateDensity(outbreaksLayer, out, 'HEXAGON', binSize, 
                             'UNIFORM', neighborhoodSize, fields, 
                             'SQUARE_KILOMETERS', timeStepInterval)

Informations de licence

  • Basic: Non
  • Standard: Non
  • Advanced: Oui

Rubriques connexes