Indice di Theil
Quattro redditi diseguali che sommano 100, con una media di 25, danno un indice di Theil positivo ma lontano dal suo tetto per quattro persone: la disuguaglianza c'è, ma è moderata. Aggiunga etichette di gruppo per vedere dove si concentra. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Redditi
- 10, 20, 30, 40
- N
- 4
- Reddito medio
- 25
- Reddito totale
- 100
- T di Theil
- 0,1064401353
L'indice di Theil T è una misura di disuguaglianza basata sull'entropia che trasforma un elenco di redditi individuali in un unico numero non negativo: zero quando tutti guadagnano lo stesso importo, e maggiore quando il reddito si concentra tra meno persone. Economisti, analisti di politiche e giornalisti di dati lo usano perché si scompone in modo additivo in componenti intra e inter-gruppo—cosa che il coefficiente di Gini non offre in modo pulito. Questa capacità accetta una distribuzione di redditi strettamente positivi, calcola la formula classica di Theil T con il logaritmo naturale, riporta media e totale del reddito, un tetto teorico ln(n) e un rapporto normalizzato opzionale T/ln(n). Quando Lei fornisce anche etichette di sottogruppo della stessa lunghezza, restituisce il Theil per gruppo e i contributi within e between che sommano all'indice complessivo.
Cosa misura l'indice di Theil T e perché l'entropia conta
Theil T appartiene alla famiglia delle misure di disuguaglianza a entropia generalizzata. Quando ogni reddito eguaglia la media, ogni rapporto è uno, ogni termine logaritmico è zero e T è esattamente zero—uguaglianza perfetta. Quando una persona detiene quasi tutto il reddito e le altre conservano importi positivi minuscoli, i termini logaritmici ponderati crescono e T si avvicina al tetto di campione finito ln(n).
Interpretare T come una divergenza di Kullback–Leibler tra la distribuzione effettiva dei redditi e la ripartizione egualitaria non è linguaggio di marketing: è la lettura standard della teoria dell'informazione che giustifica l'etichetta di entropia. A differenza del coefficiente di Gini, che riassume la curva di Lorenz con un doppio conteggio degli scarti a coppie, Theil T è più sensibile ai cambiamenti in cima alla distribuzione e ammette una partizione additiva esatta tra partizioni di popolazione.
Quella partizione spiega perché i conti regionali, gli studi salariali settoriali e le analisi di finanziamento dei distretti scolastici spesso preferiscono Theil quando la domanda è quanta disuguaglianza vive all'interno dei gruppi rispetto a quanta proviene dai divari tra gruppi. Questo calcolatore implementa quella definizione solo con aritmetica di numeri finiti: senza campionamento, senza chiamate a modelli e senza riponderazione nascosta, salvo che Lei fornisca i redditi che intende misurare.
Dove si usa l'indice di Theil
Gli economisti dello sviluppo e gli istituti nazionali di statistica calcolano Theil T su microdati di indagini sulle famiglie per seguire le tendenze di disuguaglianza e attribuire il cambiamento a forze within-region versus between-region. I team di compensazione aziendale e le piattaforme di analytics HR applicano la stessa formula alle fasce salariali per reparto o sede quando serve un cruscotto di disuguaglianza scomponibile invece di un unico Gini opaco.
Mantenga i redditi strettamente positivi, allinei le etichette di gruppo opzionali per indice e ottenga misure di disuguaglianza basate sull'entropia riproducibili per notebook, plugin LMS e worker edge senza erigere uno stack statistico proprio.
Casi d'uso
Microdati di indagine e scomposizione regionale
Calcoli Theil T sui redditi delle famiglie e, con etichette di regione, separi la disuguaglianza in quote within-region e between-region per note di policy.
Analytics di compensazione e forza lavoro
Misuri la disuguaglianza retributiva tra dipendenti e la scomponga per reparto o sede con gli stessi contributi Theil within e between.
Didattica e valutazione automatica
Consenta agli studenti di verificare esempi di Theil da manuale e identità di sottogruppo opzionali contro un oracolo deterministico in plugin LMS.
Domande frequenti
Perché ogni reddito deve essere strettamente positivo?
Theil T usa il logaritmo naturale dei rapporti di reddito.
In che modo Theil T differisce dal coefficiente di Gini?
Gini riassume la curva di Lorenz e non si scompone in modo additivo semplice tra gruppi. Theil T è basato sull'entropia, più sensibile alla coda alta, e si divide nettamente in disuguaglianza within-group e between-group.
Che cosa significa un indice di Theil pari a zero?
Uguaglianza perfetta: tutti guadagnano la media e ogni termine logaritmico vale zero. L'indice cresce man mano che il reddito si concentra in meno mani, fino a un tetto pari al logaritmo naturale del numero di persone.
Posso separare la disuguaglianza all'interno e tra i gruppi?
Sì. Aggiunga un'etichetta di gruppo a ogni reddito, come una regione o un reparto. Otterrà l'indice di ciascun gruppo e le parti interna ed esterna ai gruppi, che sommate danno il totale.
Che cos'è l'indice di Theil normalizzato?
È l'indice diviso per il suo valore massimo possibile per quel numero di persone, il logaritmo naturale di n. Così popolazioni di dimensioni diverse diventano confrontabili su una stessa scala da 0 a 1.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
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]}'const res = await fetch("https://api.kit.forhosting.com/econ/theil-index-distribution", {
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/econ/theil-index-distribution",
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/econ/theil-index-distribution", 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/econ/theil-index-distribution", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"incomes": [
10,
20,
30,
40
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "econ.theil_index_distribution",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Cosa misura l'indice di Theil T e perché l'entropia conta
Per una popolazione di n persone con redditi strettamente positivi y_i e media aritmetica μ, l'indice è la media delle quote di reddito moltiplicate per il logaritmo di tali quote: T è uguale a uno su n volte la somma su i di (y_i su μ) per il logaritmo naturale di (y_i su μ).
Contratto di input, gruppi opzionali, campi di risposta ed errori
I numeri sono arrotondati a dodici decimali per goldens stabili tra runtime. Invii un corpo JSON con il campo obbligatorio incomes: un array non vuoto di numeri finiti strettamente positivi (sono accettati gli alias values, y e data). Elenchi vuoti, zeri, negativi e valori non finiti falliscono con invalid_input perché il logaritmo di un rapporto di reddito non positivo è indefinito. Opzionalmente invii groups (alias subgroup, labels, region): un array di etichette non vuote della stessa lunghezza di incomes. Quando i gruppi sono presenti, il risolutore raggruppa le osservazioni per etichetta, calcola il Theil T di ciascun gruppo, forma la disuguaglianza within-group come somma ponderata per quota di reddito di tali indici di gruppo e la disuguaglianza between-group come la somma di s_g per ln(s_g su p_g), dove s_g è la quota del reddito totale del gruppo e p_g la sua quota di popolazione. La risposta restituisce sempre n, mean_income, total_income, theil_t, max_theil come ln(n) per n maggiore di uno (zero per un singleton), normalized_theil come theil_t diviso per max_theil quando quel tetto è positivo, un booleano equal_share, una stringa formula e una breve interpretazione. Con groups restituisce anche within_theil, between_theil, decomposition_check (la loro somma, per audit), group_count e un array groups ordinato per etichetta con medie, quote e contributi per gruppo. I fallimenti di validazione non vengono addebitati; le chiamate riuscite usano il prezzo base pubblicato $0.002 per voce sul percorso API mentre lo strumento browser resta gratuito.
Dove un'API dell'indice di Theil porta valore in ricerca e prodotto
Le piattaforme didattiche e i MOOC usano l'endpoint come oracolo: gli studenti inviano piccoli vettori di esempio come dieci-venti-trenta-quaranta e verificano sia il T complessivo sia, allegando etichette di regione, l'identità within-plus-between. Poiché l'implementazione è parse di livello A puro, ogni chiamata riuscita costa il $0.002 pubblicato senza token di modello né rete in uscita, la validazione fallita non consuma saldo e Lei può fissare le uscite arrotondate nei test unitari.
Domande tecniche
Come si calcola l'indice di Theil T a partire dai redditi?
Per n redditi positivi con media μ, T = (1/n) · Σ (y_i/μ) · ln(y_i/μ). L'API restituisce quel valore come theil_t, più media, totale, max_theil = ln(n) e normalized_theil opzionale = T/ln(n).
Come funziona la scomposizione per sottogruppi?
Fornisca un array groups allineato a incomes. La risposta include within_theil, between_theil e i dettagli per gruppo. Per costruzione, within_theil + between_theil eguaglia il theil_t complessivo (salvo arrotondamento).
Quanto costa il calcolatore dell'indice di Theil?
Lo strumento browser è gratuito. Le richieste API usano il saldo KIT prepagato a $0.002 per chiamata riuscita; l'input non valido non viene addebitato.