Calculer des taux (Statistiques spatiales)

Synthèse

Calcule des taux bruts ou lissés. La méthode de calcul des taux Global Empirical Bayes (Estimation bayésienne empirique globale) lisse les taux pour les rapprocher d’un taux de référence global. Les méthodes de calcul des taux Local Empirical Bayes (Estimation bayésienne empirique locale), Locally Weighted Average (Moyenne pondérée locale) et Locally Weighted Median (Médiane pondérée locale) utilisent les voisins locaux pour effectuer un lissage spatial des taux.

En savoir plus sur le fonctionnement du calcul des taux

Utilisation

• Si la valeur du paramètre Input Table or Features (Table ou entités en entrée) correspond à une table, les options du paramètre Rate Method (Méthode de calcul des taux) sont limitées à Crude Rate (Taux brut) et Global Empirical Bayes (Estimation bayésienne empirique globale). Les options Local Empirical Bayes (Estimation bayésienne empirique locale), Locally Weighted Average (Moyenne pondérée locale) et Locally Weighted Median (Médiane pondérée locale) sont valides uniquement pour les données spatiales.

• L’outil fournit plusieurs options de paramètre Neighborhood Type (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 Spatial Weights Matrix (Matrice de pondérations spatiales).

• Si les valeurs des taux sont petites, elles peuvent être difficiles à interpréter. Utilisez le paramètre Rate Multiplier (Multiplicateur de taux) pour mettre les taux à l’échelle ou communiquer les taux par unité de population spécifique. Par exemple, si la valeur du paramètre Rate Multiplier (Multiplicateur de taux) est de 10 000, les taux sont communiqués comme nombre par 10 000 individus.

• Si une méthode de calcul des taux avec lissage spatial est utilisée, chaque entité focale est incluse dans son propre voisinage. Par exemple, si la valeur du paramètre Neighborhood Type (Type de voisinage) est K Nearest Neighbors (K voisins les plus proches) et que la valeur du paramètre Number of Neighbors (Nombre de voisins) est de 7, chaque entité possède un voisinage de huit entités. L’intégralité du voisinage est utilisée pour calculer le taux d’une entité focale.

• Si le paramètre Rate Method (Méthode de calcul des taux) est défini sur Local Empirical Bayes (Estimation bayésienne empirique locale), Locally Weighted Average (Moyenne pondérée locale) ou Locally Weighted Median (Médiane pondérée locale), la sortie inclut un champ Number of Non-Null Neighbors. Ce champ contient le nombre de voisins, y compris l’entité focale, dont les valeurs des paramètres Population Field (Champ de population) et Count Field (Champ de nombre) n’étaient pas négatives ou nulles.

• Les entités dont la valeur Population Field (Champ de population) est nulle reçoivent un taux brut de valeur nulle.

• Si le paramètre Rate Method (Méthode de calcul des taux) est défini sur Locally Weighted Average (Moyenne pondérée locale) ou Locally Weighted Median (Médiane pondérée locale), la sortie inclut un champ Fill Missing Value. Ce champ indique si un taux a été entré pour une entité avec une valeur Count Field (Champ de nombre) ou Population Field (Champ de population) négative ou nulle.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Input Table or Features (Table ou entités en entrée)	Table ou entités contenant les champs de nombre et de population permettant de calculer les taux.	Table View
Champs de taux	Champs de nombre et de population à utiliser pour calculer les taux.	Value Table
Append Fields to Input (Ajouter les 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 classe d’entités ou une table en sortie. Sélectionné : les champs sont ajoutés aux entités en entrée. Cela modifie les données en entrée. Non sélectionné : table ou classe d’entités en sortie contenant les champs à créer. Il s’agit de l’option par défaut.	Boolean
Output Table or Features (Table ou entités en sortie) (Facultatif)	Table ou classe d’entités en sortie contenant les taux et des champs supplémentaires permettant de les évaluer.	Feature Class; Table
Rate Method (Méthode de calcul des taux) (Facultatif)	Indique la méthode à utiliser pour calculer les taux. Taux brut—Les taux sont calculés en divisant les valeurs des champs de nombre par les valeurs des champs de population. Il s’agit de l’option par défaut. Estimation bayésienne empirique globale—Les taux correspondent à la moyenne pondérée du taux brut et du taux moyen global. La pondération dépend de la taille de population de l’entité. Estimation bayésienne empirique locale—Les taux correspondent à 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 locale—Les taux correspondent au taux moyen pondéré dans l’espace de chaque entité et son voisinage. Médiane pondérée locale—Les taux correspondent au taux médian pondéré dans l’espace de chaque entité et son voisinage.	String
Distribution des probabilités	Indique la distribution des probabilités du champ de nombre. Poisson—Le champ de nombre est supposé suivre une distribution de Poisson. Il s’agit de l’option par défaut. Binomiale—Le champ de nombre est supposé suivre une distribution binomiale.	String
Type de voisinage (Facultatif)	Indique la méthode employée pour identifier les voisins de chaque entité. Canal de distance—Une distance seuil est appliquée 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 la valeur par défaut. Tronçons 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 se superposent ou 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 la valeur par défaut. K voisins les plus proches—Le même nombre de voisins, k, est affecté à 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 des centroïdes des entités. Chaque entité est un nœud de triangle, et les nœuds qui partagent des segments sont considérés comme voisins. Extraire les pondérations spatiales d’un 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 de chaque entité est utilisée pour rechercher les voisins. Toutes les entités comprises dans cette distance sont incluses comme voisins.	Linear Unit
Nombre de voisins (Facultatif)	Nombre de voisins à inclure 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 qui définit les relations spatiales entre les entités.	File
Schéma de pondération local (Facultatif)	Indique le schéma de pondération appliqué aux voisins lors du calcul des statistiques locales. Non pondéré—Les voisins ne sont pas pondérés. Il s’agit de l’option par défaut. Bicarré—Les voisins sont pondérés via une structure de noyau bicarré. Gaussien—Les voisins sont pondérés via une structure de noyau Gaussien.	String
Bande passante du noyau (Facultatif)	Largeur de bande des schémas de pondération locaux Bicarré ou Gaussien. Si aucune valeur n’est spécifiée, une valeur est estimée lors du traitement et incluse comme message de géotraitement.	Linear Unit
Rate Multiplier (Multiplicateur de taux)	Valeur constante multipliée par les taux. Ce paramètre peut être utilisé pour mettre les taux à l’échelle ou communiquer les taux par unité de population spécifique. Par exemple, si la valeur de ce paramètre est définie sur 10 000, les taux sont communiqués comme nombre par 10 000 individus.	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 pour le paramètre Input Table or Features (Table ou entités en entrée), un groupe de couches est généré avec une couche pour chaque taux spécifié dans le paramètre Rate Fields (Champs de 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	Table ou entités contenant les champs de nombre et de population permettant de calculer les taux.	Table View
rate_fields [[count_field, population_field],...]	Champs de nombre et de population à utiliser pour calculer les 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 classe d’entités ou une table en sortie. APPEND—Les champs sont ajoutés aux entités en entrée. Cela modifie les données en entrée. NO_APPEND—Table ou classe d’entités en sortie contenant les champs à créer. 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 permettant de les évaluer.	Feature Class; Table
rate_method (Facultatif)	Indique la méthode à utiliser pour calculer les taux. CRUDE_RATE—Les taux sont calculés en divisant les valeurs des champs de nombre par les valeurs des champs de population. Il s’agit de l’option par défaut. GLOBAL_EMPIRICAL_BAYES—Les taux correspondent à la moyenne pondérée du taux brut et du taux moyen global. La pondération dépend de la taille de population de l’entité. LOCAL_EMPIRICAL_BAYES—Les taux correspondent à la moyenne pondérée du taux brut de l’entité focale et du taux moyen pondéré de son voisinage. LOCALLY_WEIGHTED_AVERAGE—Les taux correspondent au taux moyen pondéré dans l’espace de chaque entité et son voisinage. LOCALLY_WEIGHTED_MEDIAN—Les taux correspondent au taux médian pondéré dans l’espace de chaque entité et son voisinage.	String
probability_distribution	Indique la distribution des probabilités du champ de nombre. POISSON—Le champ de nombre est supposé suivre une distribution de Poisson. Il s’agit de l’option par défaut. BINOMIAL—Le champ de nombre est supposé suivre une distribution binomiale.	String
neighborhood_type (Facultatif)	Indique la méthode employée pour identifier les voisins de chaque entité. DISTANCE_BAND—Une distance seuil est appliquée 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 la valeur 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 se superposent ou 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 la valeur par défaut. K_NEAREST_NEIGHBORS—Le même nombre de voisins, k, est affecté à 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 des centroïdes des entités. Chaque entité est un nœud de triangle, et 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 de chaque entité est utilisée pour rechercher les voisins. Toutes les entités comprises dans cette distance sont incluses comme voisins.	Linear Unit
number_of_neighbors (Facultatif)	Nombre de voisins à inclure 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 qui définit les relations spatiales entre les entités.	File
local_weighting_scheme (Facultatif)	Indique le schéma de pondération appliqué aux voisins lors du calcul des statistiques locales. UNWEIGHTED—Les voisins ne sont pas pondérés. Il s’agit de l’option par défaut. BISQUARE—Les voisins sont pondérés via une structure de noyau bicarré. GAUSSIAN—Les voisins sont pondérés via une structure de noyau Gaussien.	String
kernel_bandwidth (Facultatif)	Largeur de bande des schémas de pondération locaux Bicarré ou Gaussien. Si aucune valeur n’est spécifiée, une valeur est estimée lors du traitement et incluse comme message de géotraitement.	Linear Unit
rate_multiplier	Valeur constante multipliée par les taux. Ce paramètre peut être utilisé pour mettre les taux à l’échelle ou communiquer les taux par unité de population spécifique. Par exemple, si la valeur de ce paramètre est définie sur 10 000, les taux sont communiqués comme nombre par 10 000 individus.	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 pour le paramètre in_table, un groupe de couches est généré 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 suivant 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 suivant 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

Informations de licence

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