Calculer un taux (Statistiques spatiales)

Synthèse

Calculer des taux bruts ou lissés. La méthode globale du taux de Bayes empirique lisse les taux pour les rapprocher d’un taux de référence global. Les méthodes de taux de Bayes empirique local, de moyenne pondérée localement et de médiane pondérée localement utilisent les voisins locaux pour effectuer un lissage spatial du taux.

En savoir plus sur le fonctionnement de l’outil Calculer des taux

Utilisation

  • Si la valeur du paramètre Entités ou table en entrée est une table, les options du paramètre Méthode de calcul du taux sont limitées à Taux brut et Taux de Bayes empirique global. Les options Taux de Bayes empirique local, Moyenne pondérée localement et Médiane pondérée localement sont valides uniquement pour les données spatiales.

  • L’outil fournit plusieurs options pour le paramètre Type de voisinage. Toutefois, pour personnaliser davantage les voisinages, utilisez l’explorateur de voisinage pour configurer les voisinages et exporter un fichier .swm. Utilisez le fichier .swm comme valeur du paramètre Matrice de pondérations spatiales.

  • Les faibles valeurs de taux peuvent être difficiles à interpréter. Utilisez le paramètre Multiplicateur de taux pour mettre à l’échelle les taux ou reporter les taux selon une unité de population spécifique. Si, par exemple, la valeur Multiplicateur de taux s’élève à 10 000, les taux sont reportés pour un nombre de 10 000 personnes.

  • Lorsqu’une méthode de taux de lissage spatial est sélectionnée, chaque entité focale est incluse dans son propre voisinage. Si, par exemple, le paramètre Type de voisinage a pour valeur K voisins les plus proches et que le paramètre Nombre de voisins a pour valeur 7, chaque entité a un voisinage de 8 entités. Le voisinage entier permet de calculer le taux d’une entité focale.

  • Si le paramètre Méthode de calcul du taux est défini sur Taux de Bayes empirique local, Moyenne pondérée localement ou Médiane pondérée localement, la sortie inclut un champ Number of Non-Null Neighbors. Ce champ contient le nombre de voisins, entité focale comprise, qui ne comportent pas de valeur négative ou nulle dans le paramètre Champ de population ou Champ de nombre.

  • Les entités avec une valeur égale à 0 dans le paramètre Champ de population se voient attribuer un taux brut nul.

  • Si le paramètre Méthode de calcul du taux est défini sur Moyenne pondérée localement ou Médiane pondérée localement, la sortie inclut un champ Fill Missing Value. Ce champ indique si un taux a été imputé à une entité comportant une valeur négative ou nulle dans le paramètre Champ de population ou Champ de nombre.

Paramètres

ÉtiquetteExplicationType de données
Entités ou table en entrée

Entités ou table contenant les champs relatifs au nombre et à la population permettant de calculer un taux.

Table View
Champs relatifs au taux

Champs relatifs au nombre total et à la population permettant de calculer un taux.

Value Table
Ajouter des champs à l’entrée
(Facultatif)

Indique si les champs sont ajoutés au jeu de données en entrée ou enregistrés dans une table ou classe d’entités en sortie.

  • Activé : les champs sont ajoutés aux entités en entrée. Cette option modifie les données en entrée.
  • Désactivé : une table ou une classe d’entités en sortie contenant les champs est créée. Il s’agit de l’option par défaut.

Boolean
Table ou entités en sortie
(Facultatif)

Table ou classe d’entités en sortie contenant les taux et des champs supplémentaires destinés à faciliter l’évaluation des taux.

Feature Class; Table
Méthode de calcul du taux
(Facultatif)

Précise la méthode utilisée pour calculer le taux.

  • Taux brutLe taux est calculé en divisant la valeur du champ de nombre par la valeur du champ de population. Il s’agit de l’option par défaut.
  • Taux de Bayes empirique globalLe taux correspond à la moyenne pondérée du taux brut et du taux moyen global. La pondération dépend de la taille de la population des entités.
  • Taux de Bayes empirique localLe taux correspond à la moyenne pondérée du taux brut de l’entité focale et du taux moyen pondéré de son voisinage.
  • Moyenne pondérée localementLe taux correspond au taux moyen pondéré spatialement de chaque entité et de son voisinage.
  • Médiane pondérée localementLe taux correspond au taux médian pondéré spatialement de chaque entité et de son voisinage.
String
Distribution des probabilités

Indique la distribution des probabilités du champ de nombre.

  • PoissonLe champ de nombre est censé suivre une distribution de Poisson. Il s’agit de l’option par défaut.
  • BinomialeLe champ de nombre est censé suivre une distribution binomiale.
String
Type de voisinage
(Facultatif)

Spécifie la méthode employée pour identifier les voisins de chaque entité.

  • Canal de distanceApplique une distance seuil pour identifier les voisins. Chaque entité située dans la distance seuil d’une entité focale est considérée comme un voisin. Si l’entrée contient des entités linéaires ou ponctuelles, il s’agit de l’option par défaut.
    Distance fixe
  • Segments de contiguïté uniquementLes entités surfaciques qui partagent un segment ou sont superposées à une entité deviennent les voisins de cette entité.
    Segments de contiguïté uniquement
  • Angles des tronçons de contiguïtéLes entités qui sont superposées à une entité, ou qui partagent un segment ou un sommet avec une entité sont des voisins de cette entité. Si l’entrée contient des entités surfaciques, il s’agit de l’option par défaut.
    Angles des segments de contiguïté
  • K voisins les plus prochesLe même nombre de voisins, k, est attribué à chaque entité. Les k entités les plus proches d’une entité deviennent ses voisins.
    K voisins les plus proches
  • Triangulation de DelaunayUn maillage de triangles non superposés est créé à partir de centroïdes d’entités. Chaque entité est un nœud de triangle ; les nœuds qui partagent des segments sont considérés comme voisins.
    Triangulation de Delaunay avec élimination des points
  • Extraire les pondérations spatiales à partir du fichierLes relations spatiales entre les entités sont définies dans un fichier de matrice de pondérations spatiales (.swm).
String
Canal de distance
(Facultatif)

La distance séparant chaque entité permet de rechercher les voisins. Toutes les entités se trouvant dans cette distance seront incluses comme voisines.

Linear Unit
Nombre de voisins
(Facultatif)

Nombre de voisins inclus dans le voisinage d’une entité.

Long
Matrice de pondérations spatiales
(Facultatif)

Chemin d’accès et nom du fichier de matrice de pondérations spatiales définissant les relations spatiales entre des entités.

File
Structure de pondération locale
(Facultatif)

Spécifie la structure de pondération allant être appliquée aux voisins lors du calcul des statistiques locales.

  • Non pondéréLes voisins ne seront pas pondérés. Il s’agit de l’option par défaut.
  • BicarréLes voisins seront pondérés à l’aide d’une structure de noyau bicarré.
  • GaussienLes voisins seront pondérés à l’aide d’une structure de noyau Gaussien.
String
Bande passante de noyau
(Facultatif)

La bande passante des structures de pondération locales bicarrées ou Gaussienne. Si aucune valeur n’est fournie, une valeur est estimée pendant le traitement et incluse sous forme de message de géotraitement.

Linear Unit
Multiplicateur de taux

Valeur constante qui est multipliée par le taux. Ce paramètre permet de mettre à l’échelle les taux ou de reporter les taux selon une unité de population spécifique. Ainsi, lorsque la valeur est définie sur 10 000, les taux sont reportés pour un nombre de 10 000 personnes.

Long

Sortie obtenue

ÉtiquetteExplicationType de données
Table en entrée mise à jour

Table en entrée mise à jour.

Table View
Groupe de couches en sortie

Si une classe d’entités est spécifiée dans le paramètre Entités ou table en entrée, un groupe de couches est indiqué en sortie avec une couche pour chaque taux spécifié dans le paramètre Champs relatifs au taux.

Group Layer

arcpy.stats.CalculateRates(in_table, rate_fields, {append_to_input}, {out_table}, {rate_method}, probability_distribution, {neighborhood_type}, {distance_band}, {number_of_neighbors}, {weights_matrix_file}, {local_weighting_scheme}, {kernel_bandwidth}, rate_multiplier)
NomExplicationType de données
in_table

Entités ou table contenant les champs relatifs au nombre et à la population permettant de calculer un taux.

Table View
rate_fields
[[count_field, population_field],...]

Champs relatifs au nombre total et à la population permettant de calculer un taux.

Value Table
append_to_input
(Facultatif)

Indique si les champs sont ajoutés au jeu de données en entrée ou enregistrés dans une table ou classe d’entités en sortie.

  • APPENDLes champs sont ajoutés aux entités en entrée. Cette option modifie les données en entrée.
  • NO_APPENDUne table ou une classe d’entités en sortie contenant les champs est créée. Il s’agit de l’option par défaut.
Boolean
out_table
(Facultatif)

Table ou classe d’entités en sortie contenant les taux et des champs supplémentaires destinés à faciliter l’évaluation des taux.

Feature Class; Table
rate_method
(Facultatif)

Précise la méthode utilisée pour calculer le taux.

  • CRUDE_RATELe taux est calculé en divisant la valeur du champ de nombre par la valeur du champ de population. Il s’agit de l’option par défaut.
  • GLOBAL_EMPIRICAL_BAYESLe taux correspond à la moyenne pondérée du taux brut et du taux moyen global. La pondération dépend de la taille de la population des entités.
  • LOCAL_EMPIRICAL_BAYESLe taux correspond à la moyenne pondérée du taux brut de l’entité focale et du taux moyen pondéré de son voisinage.
  • LOCALLY_WEIGHTED_AVERAGELe taux correspond au taux moyen pondéré spatialement de chaque entité et de son voisinage.
  • LOCALLY_WEIGHTED_MEDIANLe taux correspond au taux médian pondéré spatialement de chaque entité et de son voisinage.
String
probability_distribution

Indique la distribution des probabilités du champ de nombre.

  • POISSONLe champ de nombre est censé suivre une distribution de Poisson. Il s’agit de l’option par défaut.
  • BINOMIALLe champ de nombre est censé suivre une distribution binomiale.
String
neighborhood_type
(Facultatif)

Spécifie la méthode employée pour identifier les voisins de chaque entité.

  • DISTANCE_BANDApplique une distance seuil pour identifier les voisins. Chaque entité située dans la distance seuil d’une entité focale est considérée comme un voisin. Si l’entrée contient des entités linéaires ou ponctuelles, il s’agit de l’option par défaut.
    Distance fixe
  • CONTIGUITY_EDGES_ONLYLes entités surfaciques qui partagent un segment ou sont superposées à une entité deviennent les voisins de cette entité.
    Segments de contiguïté uniquement
  • CONTIGUITY_EDGES_CORNERSLes entités qui sont superposées à une entité, ou qui partagent un segment ou un sommet avec une entité sont des voisins de cette entité. Si l’entrée contient des entités surfaciques, il s’agit de l’option par défaut.
    Angles des segments de contiguïté
  • K_NEAREST_NEIGHBORSLe même nombre de voisins, k, est attribué à chaque entité. Les k entités les plus proches d’une entité deviennent ses voisins.
    K voisins les plus proches
  • DELAUNAY_TRIANGULATIONUn maillage de triangles non superposés est créé à partir de centroïdes d’entités. Chaque entité est un nœud de triangle ; les nœuds qui partagent des segments sont considérés comme voisins.
    Triangulation de Delaunay avec élimination des points
  • GET_SPATIAL_WEIGHTS_FROM_FILELes relations spatiales entre les entités sont définies dans un fichier de matrice de pondérations spatiales (.swm).
String
distance_band
(Facultatif)

La distance séparant chaque entité permet de rechercher les voisins. Toutes les entités se trouvant dans cette distance seront incluses comme voisines.

Linear Unit
number_of_neighbors
(Facultatif)

Nombre de voisins inclus dans le voisinage d’une entité.

Long
weights_matrix_file
(Facultatif)

Chemin d’accès et nom du fichier de matrice de pondérations spatiales définissant les relations spatiales entre des entités.

File
local_weighting_scheme
(Facultatif)

Spécifie la structure de pondération allant être appliquée aux voisins lors du calcul des statistiques locales.

  • UNWEIGHTEDLes voisins ne seront pas pondérés. Il s’agit de l’option par défaut.
  • BISQUARELes voisins seront pondérés à l’aide d’une structure de noyau bicarré.
  • GAUSSIANLes voisins seront pondérés à l’aide d’une structure de noyau Gaussien.
String
kernel_bandwidth
(Facultatif)

La bande passante des structures de pondération locales bicarrées ou Gaussienne. Si aucune valeur n’est fournie, une valeur est estimée pendant le traitement et incluse sous forme de message de géotraitement.

Linear Unit
rate_multiplier

Valeur constante qui est multipliée par le taux. Ce paramètre permet de mettre à l’échelle les taux ou de reporter les taux selon une unité de population spécifique. Ainsi, lorsque la valeur est définie sur 10 000, les taux sont reportés pour un nombre de 10 000 personnes.

Long

Sortie obtenue

NomExplicationType de données
updated_table

Table en entrée mise à jour.

Table View
output_layer_group

Si une classe d’entités est spécifiée dans le paramètre in_table, un groupe de couches est indiqué en sortie avec une couche pour chaque taux spécifié dans le paramètre rate_fields.

Group Layer

Exemple de code

Exemple 1 d’utilisation de l’outil CalculateRates (fenêtre Python)

Le script Python ci-dessous illustre l’utilisation de la fonction CalculateRates.

import arcpy
in_features = r"C:\Health.gdb\cancer_deaths"
out_features = r"C:\Health.gdb\cancer_rate"
rate_fields = "deaths_2024 population_2024; deaths_2023 population_2023"
rate_method = "Global Empirical Bayes"
distribution = "Poisson"
scaling_factor = 100000

arcpy.stats.CalculateRates(
    in_features, rate_fields, "NO_APPEND", out_features, rate_method,
    distribution, None, None, None, None, None, None, scaling_factor)
Exemple 2 d’utilisation de l’outil CalculateRates (script autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction CalculateRates.

import arcpy

arcpy.env.workspace = r"C:\Health.gdb"

in_features = "cancer_deaths"
out_features = "cancer_rate"
rate_fields = "deaths_2024 population_2024; deaths_2023 population_2023"
rate_method = "RAW_RATE"
scaling_factor = 100000

arcpy.stats.CalculateRates(
    in_features, rate_fields,"NO_APPEND", out_features, rate_method, None, 
    None, None, None, None, None, None, scaling_factor)

Informations de licence

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

Rubriques connexes