ForHosting KIT · Outils pour développeurs

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.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/stat/theil-index

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

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]}'
{
  "incomes": [
    10,
    20,
    30,
    40
  ]
}
{
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

max_items100000
HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →