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

Boîte de dialogue

Étiquette	Explication	Type 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 brut—Le 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 global—Le 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 local—Le 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 localement—Le taux correspond au taux moyen pondéré spatialement de chaque entité et de son voisinage. Médiane pondérée localement—Le 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. Poisson—Le champ de nombre est censé suivre une distribution de Poisson. Il s’agit de l’option par défaut. Binomiale—Le 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 distance—Applique 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. Segments de contiguïté uniquement—Les entités surfaciques qui partagent un segment ou sont superposées à une entité deviennent les voisins de cette entité. 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. K voisins les plus proches—Le même nombre de voisins, k, est attribué à chaque entité. Les k entités les plus proches d’une entité deviennent ses voisins. Triangulation de Delaunay—Un 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. Extraire les pondérations spatiales à partir du fichier—Les 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é. Gaussien—Les 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

Étiquette	Explication	Type 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

Python

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)

Nom	Explication	Type 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. APPEND—Les champs sont ajoutés aux entités en entrée. Cette option modifie les données en entrée. NO_APPEND—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
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_RATE—Le 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_BAYES—Le 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_BAYES—Le 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_AVERAGE—Le taux correspond au taux moyen pondéré spatialement de chaque entité et de son voisinage. LOCALLY_WEIGHTED_MEDIAN—Le 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. POISSON—Le champ de nombre est censé suivre une distribution de Poisson. Il s’agit de l’option par défaut. BINOMIAL—Le 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_BAND—Applique 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. CONTIGUITY_EDGES_ONLY—Les entités surfaciques qui partagent un segment ou sont superposées à une entité deviennent les voisins de cette entité. CONTIGUITY_EDGES_CORNERS—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. K_NEAREST_NEIGHBORS—Le même nombre de voisins, k, est attribué à chaque entité. Les k entités les plus proches d’une entité deviennent ses voisins. DELAUNAY_TRIANGULATION—Un 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. GET_SPATIAL_WEIGHTS_FROM_FILE—Les 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. UNWEIGHTED—Les voisins ne seront pas pondérés. Il s’agit de l’option par défaut. BISQUARE—Les voisins seront pondérés à l’aide d’une structure de noyau bicarré. GAUSSIAN—Les 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

Nom	Explication	Type 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)

Environnements

Système de coordonnées en sortie