Indice de Theil
Le calculateur d’indice de Theil mesure l’inégalité de la répartition des revenus dans une population grâce à une méthode issue de l’entropie de l’information.
Lancer gratuitement
Saisissez un revenu positif pour chaque personne, ménage, région ou autre unité de même poids. Le résultat fournit l’indice Theil T ainsi que l’effectif, le revenu total et la moyenne employés. Zéro correspond à l’égalité parfaite, tandis qu’une valeur plus élevée signale une concentration accrue. Ce calcul déterministe convient aux analyses, aux rapports reproductibles, aux pipelines de données et aux comparaisons automatisées.
Ce que révèle l’indice de Theil
L’indice de Theil résume la répartition des revenus par une mesure non négative de l’inégalité. Lorsque toutes les observations ont exactement le même revenu, chaque rapport à la moyenne vaut un, toutes les contributions logarithmiques sont nulles et l’indice final est égal à zéro. À mesure que les revenus se concentrent sur un plus petit nombre d’observations, l’indice augmente. Contrairement à un total monétaire ou à une moyenne, le résultat est sans unité. Il permet donc de comparer des distributions exprimées dans des monnaies ou des échelles différentes, à condition de définir les populations de manière cohérente. La mesure réagit aux changements dans toute la distribution, y compris en haut de celle-ci. Elle n’indique toutefois pas quels ménages sont pauvres ou riches, et deux distributions visuellement différentes peuvent donner le même indice. Interprétez-la avec les effectifs, moyennes, quantiles et éléments de contexte. Ce calculateur fournit la forme Theil T, et non la mesure distincte Theil L.
Méthode de calcul
Pour n revenus, le calculateur commence par déterminer leur moyenne arithmétique. Il divise ensuite chaque revenu par cette moyenne, prend le logarithme naturel du rapport, multiplie le rapport par son logarithme, additionne toutes les contributions puis divise la somme par n. Autrement dit, Theil T est la moyenne du revenu relatif multiplié par son logarithme naturel. Le logarithme naturel est indispensable : une base dix ou deux modifierait l’échelle numérique. Chaque entrée doit être un nombre fini strictement supérieur à zéro. Cette règle évite les logarithmes indéfinis et respecte le contrat explicite : les valeurs nulles, négatives, absentes, infinies ou non numériques provoquent une erreur au lieu d’être ignorées. Chaque élément du tableau possède le même poids démographique. Si une ligne représente plusieurs personnes, développez les données en observations individuelles ou appliquez au préalable une transformation pondérée adaptée. Le total et la moyenne renvoyés permettent de vérifier l’interprétation de la population transmise.
Comparer des groupes et interpréter les résultats
Conservez la même définition de population, la même période comptable, le même concept de revenu et le même traitement des impôts ou transferts pour chaque comparaison. Mélanger un revenu mensuel par ménage et un revenu annuel individuel produit bien un nombre, mais pas une comparaison pertinente. La famille Theil est particulièrement utile, car l’inégalité globale peut être décomposée en composantes internes aux groupes et entre les groupes. Cette décomposition exige les effectifs et totaux de chaque groupe et n’est pas réalisée par ce calculateur à tableau unique. Vous pouvez néanmoins calculer un indice séparé pour chaque groupe défini de façon cohérente, sans confondre ces résultats indépendants avec une décomposition additive. Aucun seuil universel ne rend une valeur Theil bonne ou mauvaise : l’interprétation dépend de la société, du marché, du plan d’échantillonnage et de la question étudiée. Vérifiez aussi l’influence des valeurs extrêmes, la cohérence des corrections d’inflation et la représentativité de l’échantillon.
Cas d’usage
Comparer les distributions dans le temps
Mesurez l’inégalité sur des revenus annuels définis de façon cohérente et suivez l’évolution de la concentration entre les périodes.
Auditer les inégalités régionales
Calculez un Theil T par région lorsque le revenu, l’unité de population, la devise et la période reposent sur les mêmes définitions.
Ajouter une mesure reproductible
Produisez une statistique déterministe à partir de valeurs positives validées et conservez effectif, total et moyenne à des fins d’audit.
Questions fréquentes
Que signifie un indice de Theil égal à zéro ?
Toutes les observations transmises ont le même revenu : la distribution est donc parfaitement égalitaire au sein de la population fournie.
Un revenu peut-il être nul ou négatif ?
Non. Chaque valeur doit être finie et strictement positive. Une valeur nulle ou négative entraîne une erreur, car la formule logarithmique n’est pas définie par ce contrat.
Quelle version de l’indice de Theil est calculée ?
Le résultat est Theil T : la moyenne du rapport de chaque revenu à la moyenne, multiplié par le logarithme naturel de ce rapport. Theil L n’est pas calculé.
Un changement de devise modifie-t-il le résultat ?
Multiplier tous les revenus par le même facteur de conversion positif ne change pas l’indice, hormis la précision flottante habituelle.
Les observations sont-elles pondérées ?
Chaque élément du tableau a le même poids. Les lignes représentant des populations différentes doivent être développées ou transformées correctement avant le calcul.
Quel est le prix du calcul par API ?
Le tarif de l’API est de $0.002 par requête. Le même calcul déterministe peut aussi être exécuté gratuitement dans le navigateur.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/stat/theil-index \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"incomes":[10,20,30,40]}'const res = await fetch("https://api.kit.forhosting.com/stat/theil-index", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"incomes": [
10,
20,
30,
40
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/stat/theil-index",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"incomes": [
10,
20,
30,
40
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/theil-index", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"incomes":[10,20,30,40]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"incomes":[10,20,30,40]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/theil-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"incomes": [
10,
20,
30,
40
]
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "stat.theil_index",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_items | 100000 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |