ForHosting KIT · Strumenti per sviluppatori

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.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

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.

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.

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.

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.

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

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

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 è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

max_items100000
HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →