ForHosting KIT · Utilidades de desarrollo

Í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.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

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.

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.

¿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.

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.

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

¿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.

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"
  }
}

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.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_items100000
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →