ForHosting KIT · Finances et argent

Indice de Theil

Quatre revenus inégaux totalisant 100, d'une moyenne de 25, donnent un indice de Theil positif mais loin de son plafond pour quatre personnes : l'inégalité existe, mais reste modérée. Ajoutez des étiquettes de groupe pour voir où elle se loge. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt
Si vous saisissez
Revenus
10, 20, 30, 40
Vous obtenez
N
4
Revenu moyen
25
Revenu total
100
T de Theil
0,1064401353

L'indice de Theil T est une mesure d'inégalité fondée sur l'entropie qui transforme une liste de revenus individuels en un seul nombre non négatif : zéro lorsque tout le monde gagne le même montant, et plus élevé lorsque le revenu se concentre chez moins de personnes. Les économistes, analystes de politiques publiques et journalistes de données l'utilisent parce qu'il se décompose de façon additive en composantes intra et inter-groupes—ce que le coefficient de Gini n'offre pas proprement. Cette capacité accepte une distribution de revenus strictement positifs, calcule la formule classique de Theil T avec le logarithme naturel, renvoie la moyenne et le total des revenus, un plafond théorique ln(n) et un ratio normalisé optionnel T/ln(n). Lorsque vous fournissez aussi des libellés de sous-groupe de même longueur, elle renvoie le Theil par groupe ainsi que les contributions within et between qui recomposent l'indice global.

Ce que mesure l'indice de Theil T et pourquoi l'entropie compte

Theil T appartient à la famille des mesures d'inégalité d'entropie généralisée. Lorsque chaque revenu égale la moyenne, chaque rapport vaut un, chaque terme logarithmique est nul et T vaut exactement zéro—égalité parfaite. Lorsqu'une personne détient presque tout le revenu et que les autres ne conservent que de minuscules montants positifs, les termes logarithmiques pondérés croissent et T s'approche de son plafond d'échantillon fini ln(n).

Interpréter T comme une divergence de Kullback–Leibler entre la distribution réelle des revenus et le partage égalitaire n'est pas un langage marketing : c'est la lecture standard de la théorie de l'information qui justifie l'étiquette d'entropie. Contrairement au coefficient de Gini, qui résume la courbe de Lorenz par un double comptage des écarts par paires, Theil T est plus sensible aux variations en haut de la distribution et admet une partition additive exacte entre partitions de population.

Cette partition explique pourquoi les comptes régionaux, les études salariales sectorielles et les analyses de financement des districts scolaires préfèrent souvent Theil lorsque la question est de savoir combien d'inégalité vit à l'intérieur des groupes versus combien provient des écarts entre groupes. Ce calculateur met en œuvre cette définition avec une arithmétique de nombres finis uniquement : sans échantillonnage, sans appels de modèle et sans repondération cachée, sauf si vous fournissez les revenus que vous entendez mesurer.

Où l'indice de Theil sert en recherche

Les économistes du développement et les instituts nationaux de statistique calculent Theil T sur des microdonnées d'enquêtes ménages pour suivre les tendances d'inégalité et attribuer le changement aux forces intra-régionales versus inter-régionales. Les équipes de rémunération d'entreprise et les plateformes d'analytique RH appliquent la même formule aux grilles salariales par département ou site lorsqu'elles ont besoin d'un tableau de bord d'inégalité décomposable plutôt que d'un unique Gini opaque.

Gardez des revenus strictement positifs, alignez les libellés de groupe optionnels par index, et vous obtenez des mesures d'inégalité basées sur l'entropie reproductibles pour carnets, plugins LMS et workers en bordure sans monter votre propre pile statistique.

Microdonnées d'enquête et décomposition régionale

Calculez Theil T sur les revenus des ménages et, avec des libellés de région, séparez l'inégalité en parts intra-régionales et inter-régionales pour des notes de politique.

Analytique de rémunération et de main-d'œuvre

Mesurez l'inégalité salariale entre employés et décomposez par département ou site avec les mêmes contributions Theil within et between.

Enseignement et notation automatisée

Permettez aux étudiants de vérifier les exemples de Theil du manuel et les identités de sous-groupe optionnelles face à un oracle déterministe dans des plugins LMS.

Pourquoi chaque revenu doit-il être strictement positif ?

Theil T utilise le logarithme naturel des rapports de revenu.

En quoi Theil T diffère-t-il du coefficient de Gini ?

Gini résume la courbe de Lorenz et ne se décompose pas de façon additive simple entre groupes. Theil T est fondé sur l'entropie, plus sensible au haut de la distribution, et se scinde clairement en inégalité intra-groupe et inter-groupes.

Que signifie un indice de Theil égal à zéro ?

L'égalité parfaite : chacun gagne la moyenne et chaque terme logarithmique est nul. L'indice augmente à mesure que le revenu se concentre, jusqu'à un plafond égal au logarithme naturel du nombre de personnes.

Peut-on séparer l'inégalité au sein des groupes et entre eux ?

Oui. Ajoutez une étiquette de groupe à chaque revenu, par exemple une région ou un service. Vous obtenez l'indice de chaque groupe et les parts intra et intergroupes, dont la somme redonne le total.

Qu'est-ce que l'indice de Theil normalisé ?

C'est l'indice divisé par sa valeur maximale possible pour ce nombre de personnes, le logarithme naturel de n. Des populations de tailles différentes deviennent ainsi comparables sur une même échelle de 0 à 1.

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/econ/theil-index-distribution

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/econ/theil-index-distribution \
  -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": "econ.theil_index_distribution",
  "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.

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.

Ce que mesure l'indice de Theil T et pourquoi l'entropie compte

Pour une population de n personnes aux revenus strictement positifs y_i et de moyenne arithmétique μ, l'indice est la moyenne des parts de revenu multipliées par le logarithme de ces parts : T égale un sur n fois la somme sur i de (y_i sur μ) multiplié par le logarithme naturel de (y_i sur μ).

Contrat d'entrée, groupes optionnels, champs de réponse et erreurs

Les nombres sont arrondis à douze décimales pour des goldens stables entre runtimes. Envoyez un corps JSON avec le champ obligatoire incomes : un tableau non vide de nombres finis strictement positifs (les alias values, y et data sont acceptés). Listes vides, zéros, négatifs et valeurs non finies échouent avec invalid_input car le logarithme d'un rapport de revenu non positif est indéfini. Envoyez optionnellement groups (alias subgroup, labels, region) : un tableau d'étiquettes non vides de même longueur que incomes. Lorsque des groupes sont présents, le solveur regroupe les observations par étiquette, calcule le Theil T de chaque groupe, forme l'inégalité intra-groupe comme somme pondérée par la part de revenu de ces indices de groupe et l'inégalité inter-groupes comme la somme de s_g multiplié par ln(s_g sur p_g), où s_g est la part du revenu total du groupe et p_g sa part de population. La réponse renvoie toujours n, mean_income, total_income, theil_t, max_theil comme ln(n) pour n supérieur à un (zéro pour un singleton), normalized_theil comme theil_t divisé par max_theil lorsque ce plafond est positif, un booléen equal_share, une chaîne formula et une brève interprétation. Avec groups, elle renvoie aussi within_theil, between_theil, decomposition_check (leur somme, pour audit), group_count et un tableau groups trié par étiquette avec moyennes, parts et contributions par groupe. Les échecs de validation ne sont pas facturés ; les appels réussis utilisent le prix de base publié $0.002 par élément sur le chemin API tandis que l'outil navigateur reste gratuit.

Où une API d'indice de Theil apporte de la valeur en recherche et produit

Les plateformes pédagogiques et MOOC utilisent le endpoint comme oracle : les étudiants envoient de petits vecteurs d'exemple comme dix-vingt-trente-quarante et vérifient à la fois le T global et, en joignant des libellés de région, l'identité within-plus-between. Comme l'implémentation est pure parse de niveau A, chaque appel réussi coûte le $0.002 publié sans jetons de modèle ni réseau sortant, la validation échouée ne consomme pas de solde et vous pouvez figer les sorties arrondies dans des tests unitaires.

Comment l'indice de Theil T se calcule-t-il à partir des revenus ?

Pour n revenus positifs de moyenne μ, T = (1/n) · Σ (y_i/μ) · ln(y_i/μ). L'API renvoie cette valeur comme theil_t, plus moyenne, total, max_theil = ln(n) et normalized_theil optionnel = T/ln(n).

Comment fonctionne la décomposition par sous-groupes ?

Fournissez un tableau groups aligné avec incomes. La réponse inclut within_theil, between_theil et le détail par groupe. Par construction, within_theil + between_theil égale le theil_t global (au arrondi près).

Combien coûte le calculateur d'indice de Theil ?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi ; l'entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →