Índice de Theil
La calculadora del índice de Theil mide cuán desigual es la distribución de los ingresos de una población mediante un método derivado de la entropía de la información.
Ejecutar — gratis
Introduzca un ingreso positivo por cada persona, hogar, región u otra unidad con el mismo peso. Obtendrá el índice Theil T, el número de observaciones, el ingreso total y la media utilizados. El valor cero representa igualdad perfecta; los valores mayores indican más concentración. El cálculo determinista sirve para análisis, informes reproducibles, procesos de datos y comparaciones automatizadas.
Qué revela el índice de Theil
El índice de Theil resume la distribución de ingresos en una medida no negativa de desigualdad. Si todas las observaciones tienen exactamente el mismo ingreso, cada cociente respecto de la media vale uno, todas las contribuciones logarítmicas son cero y el índice final es cero. Cuando los ingresos se concentran en menos observaciones, el índice aumenta. El resultado no tiene unidad, a diferencia de un total monetario o una media; por eso permite comparar distribuciones expresadas en monedas o escalas distintas, siempre que las poblaciones se definan de manera coherente. La medida responde a cambios en toda la distribución, incluida la parte superior. Sin embargo, no identifica qué hogares son pobres o ricos, y dos distribuciones visualmente distintas pueden producir el mismo índice. Conviene interpretarlo junto con recuentos, medias, cuantiles y contexto. Esta calculadora informa la variante Theil T, no la medida Theil L. Indicar esta convención es esencial al publicar resultados o compararlos con otra fuente.
Cómo se realiza el cálculo
Para n ingresos, la calculadora obtiene primero la media aritmética. Después divide cada ingreso entre esa media, calcula el logaritmo natural del cociente, multiplica el cociente por su logaritmo, suma todas las contribuciones y divide el total entre n. En otras palabras, Theil T es el promedio de cada ingreso relativo multiplicado por su logaritmo natural. Es imprescindible usar logaritmos naturales: las bases diez o dos alteran la escala numérica. Cada entrada debe ser un número finito estrictamente mayor que cero. Así se evitan logaritmos indefinidos y se respeta el contrato: los valores cero, negativos, ausentes, infinitos o no numéricos generan un error en lugar de omitirse. Cada elemento del array tiene el mismo peso poblacional. Si un registro representa a varias personas, amplíe los datos a observaciones individuales o aplique antes una transformación con las ponderaciones adecuadas. El total y la media devueltos permiten comprobar cómo se interpretó la población enviada.
Comparar grupos e interpretar resultados
Mantenga la misma definición de población, período contable, concepto de ingreso y tratamiento de impuestos o transferencias en todas las comparaciones. Mezclar ingresos mensuales de hogares con ingresos anuales de personas genera un número, pero no una comparación válida. La familia Theil resulta especialmente útil porque la desigualdad total puede descomponerse en componentes dentro de los grupos y entre ellos; esa descomposición requiere tamaños y totales grupales y no forma parte de esta calculadora de un solo array. Aun así, puede calcular un índice independiente para cada grupo definido de manera coherente, sin confundir esos resultados con una descomposición aditiva. No existe un umbral universal que convierta un valor de Theil en bueno o malo: depende de la sociedad, el mercado, el diseño muestral y la pregunta. Compruebe también si unos pocos extremos dominan el resultado, si los ajustes por inflación son uniformes y si la muestra es representativa. En automatizaciones, conserve el array original junto con la salida para facilitar la reproducción.
Qué puede hacer con ella
Comparar distribuciones a lo largo del tiempo
Mida la desigualdad con registros anuales definidos de forma coherente y observe si la concentración aumenta o disminuye entre períodos.
Auditar la desigualdad regional
Calcule valores Theil T por región cuando compartan concepto de ingreso, unidad poblacional, moneda y período de observación.
Incorporar una métrica reproducible
Obtenga una estadística determinista a partir de valores positivos validados y conserve recuento, total y media para auditoría.
Preguntas frecuentes
¿Qué significa un índice de Theil igual a cero?
Significa que todas las observaciones enviadas tienen el mismo ingreso; la distribución de esa población es perfectamente igualitaria.
¿Puede un ingreso ser cero o negativo?
No. Todos los valores deben ser finitos y estrictamente positivos. Cero y los negativos generan un error porque la fórmula logarítmica no está definida bajo este contrato.
¿Qué variante del índice de Theil se calcula?
Se devuelve Theil T: el promedio del cociente entre cada ingreso y la media multiplicado por el logaritmo natural de dicho cociente. No se calcula Theil L.
¿Cambiar de moneda modifica el resultado?
Multiplicar todos los ingresos por el mismo factor positivo de conversión no cambia el índice, salvo la precisión habitual de coma flotante.
¿Se ponderan las observaciones de ingresos?
Cada elemento del array tiene el mismo peso. Los registros que representan cantidades de población diferentes deben ampliarse o transformarse adecuadamente antes del cálculo.
¿Cuánto cuesta el cálculo mediante API?
El precio de la API es $0.002 por solicitud. El mismo cálculo determinista también puede ejecutarse gratis en el navegador.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su 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)Ejemplo de solicitud
{
"incomes": [
10,
20,
30,
40
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "stat.theil_index",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_items | 100000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |