Indice di Theil
Il calcolatore dell’indice di Theil misura quanto è disuguale la distribuzione dei redditi in una popolazione con un metodo derivato dall’entropia dell’informazione.
Esegui gratis nel browser
Inserisca un reddito positivo per ogni persona, famiglia, regione o altra unità con lo stesso peso. Il risultato comprende l’indice Theil T, il numero di osservazioni, il reddito totale e la media impiegati. Il valore zero indica uguaglianza perfetta, mentre valori maggiori segnalano una concentrazione più elevata. Il calcolo deterministico è adatto ad analisi, report riproducibili, pipeline di dati e confronti automatizzati.
Che cosa indica l’indice di Theil
L’indice di Theil riassume la distribuzione dei redditi in una misura non negativa della disuguaglianza. Quando tutte le osservazioni hanno esattamente lo stesso reddito, ogni rapporto rispetto alla media vale uno, tutti i contributi logaritmici sono nulli e l’indice finale è zero. Se il reddito si concentra in un numero minore di osservazioni, l’indice cresce. A differenza di un totale monetario o di una media, il risultato non ha unità di misura; ciò consente di confrontare distribuzioni espresse in valute o scale diverse, purché le popolazioni siano definite in modo coerente. La misura risponde ai cambiamenti nell’intera distribuzione, compresa la fascia superiore. Tuttavia, non identifica quali famiglie siano povere o ricche, e due distribuzioni visivamente diverse possono produrre lo stesso indice. Lo interpreti insieme a numerosità, medie, quantili e contesto. Questo calcolatore restituisce la forma Theil T, non la distinta misura Theil L. Dichiarare tale convenzione è essenziale nei risultati pubblicati o confrontati.
Come viene eseguito il calcolo
Per n redditi, il calcolatore determina innanzitutto la media aritmetica. Divide poi ogni reddito per la media, calcola il logaritmo naturale del rapporto, moltiplica il rapporto per il suo logaritmo, somma tutti i contributi e divide il totale per n. In sintesi, Theil T è la media del reddito relativo moltiplicato per il relativo logaritmo naturale. I logaritmi naturali sono indispensabili: l’uso della base dieci o due modifica la scala numerica. Ogni input deve essere un numero finito strettamente maggiore di zero. Questo requisito evita logaritmi indefiniti e rispetta il contratto: valori nulli, negativi, mancanti, infiniti o non numerici producono un errore invece di essere esclusi senza avviso. Ogni elemento dell’array ha lo stesso peso nella popolazione. Se un record rappresenta più persone, espanda i dati in osservazioni individuali oppure li trasformi prima con pesi di frequenza appropriati. Il totale e la media restituiti permettono di verificare l’interpretazione della popolazione inviata.
Confrontare gruppi e interpretare i risultati
Adotti la stessa definizione di popolazione, periodo contabile, concetto di reddito e trattamento di imposte o trasferimenti in ogni confronto. Mescolare il reddito familiare mensile con quello personale annuale produce un numero, ma non un confronto significativo. La famiglia Theil è particolarmente utile perché la disuguaglianza complessiva può essere scomposta in componenti interne ai gruppi e tra i gruppi; tale scomposizione richiede popolazioni e totali per gruppo e non viene eseguita da questo calcolatore basato su un solo array. Può comunque calcolare un indice separato per ogni gruppo definito coerentemente, purché non scambi tali risultati indipendenti per una scomposizione additiva. Non esiste una soglia universale che renda buono o cattivo un valore Theil: l’interpretazione dipende dalla società, dal mercato, dal disegno campionario e dalla domanda. Verifichi inoltre l’influenza di pochi valori estremi, la coerenza degli adeguamenti all’inflazione e la rappresentatività del campione. Per l’automazione, conservi l’array esatto insieme all’output.
Casi d'uso
Confrontare le distribuzioni nel tempo
Misuri la disuguaglianza su redditi annuali definiti coerentemente e verifichi se la concentrazione aumenta o diminuisce tra i periodi.
Analizzare la disuguaglianza regionale
Calcoli un valore Theil T per regione usando lo stesso concetto di reddito, unità di popolazione, valuta e periodo.
Aggiungere una metrica riproducibile
Produca una statistica deterministica da valori positivi convalidati e conservi numerosità, totale e media per la verifica.
Domande frequenti
Che cosa significa un indice di Theil pari a zero?
Significa che tutte le osservazioni inserite hanno lo stesso reddito e che la distribuzione nella popolazione fornita è perfettamente uniforme.
Un reddito può essere zero o negativo?
No. Ogni valore deve essere finito e strettamente positivo. Zero e valori negativi generano un errore perché la formula logaritmica non è definita da questo contratto.
Quale versione dell’indice di Theil viene calcolata?
Il calcolatore restituisce Theil T: la media del rapporto tra ogni reddito e la media moltiplicato per il logaritmo naturale del rapporto. Non restituisce Theil L.
Cambiare valuta modifica il risultato?
Moltiplicare tutti i redditi per lo stesso fattore di conversione positivo non cambia l’indice, salvo la normale precisione in virgola mobile.
Le osservazioni dei redditi sono ponderate?
Ogni elemento dell’array ha lo stesso peso. I record che rappresentano quantità di popolazione diverse devono essere espansi o trasformati correttamente prima del calcolo.
Quanto costa il calcolo tramite API?
Il prezzo dell’API è $0.002 per richiesta. Lo stesso calcolo deterministico può essere eseguito gratuitamente anche nel browser.
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/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)Esempio di richiesta
{
"incomes": [
10,
20,
30,
40
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "stat.theil_index",
"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.
Limiti
max_items | 100000 |
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. |