Índice de Theil
A calculadora do índice de Theil mede o grau de desigualdade na distribuição de renda de uma população por um método derivado da entropia da informação.
Executar grátis
Informe uma renda positiva para cada pessoa, família, região ou outra unidade com o mesmo peso. O resultado inclui o índice Theil T, a contagem, a renda total e a média usadas no cálculo. Zero representa igualdade perfeita; valores maiores indicam concentração mais elevada. O cálculo determinístico é adequado para análises, relatórios reproduzíveis, pipelines de dados e comparações automatizadas.
O que o índice de Theil revela
O índice de Theil resume a distribuição de renda em uma medida não negativa de desigualdade. Quando todas as observações têm exatamente a mesma renda, cada razão em relação à média é igual a um, todas as contribuições logarítmicas são zero e o índice final também é zero. À medida que a renda se concentra em menos observações, o índice aumenta. Diferentemente de um total monetário ou de uma média, o resultado não possui unidade; assim, ele permite comparar distribuições expressas em moedas ou escalas diferentes, desde que as populações sejam definidas de modo consistente. A medida reage a mudanças em toda a distribuição, inclusive na faixa superior. Porém, ela não mostra quais famílias são pobres ou ricas, e duas distribuições visualmente distintas podem produzir o mesmo índice. Interprete o valor junto com contagens, médias, quantis e contexto. Esta calculadora apresenta a forma Theil T, e não a medida Theil L. Registrar essa convenção é importante ao publicar ou comparar resultados.
Como o cálculo é realizado
Para n rendas, a calculadora determina primeiro a média aritmética. Em seguida, divide cada renda pela média, calcula o logaritmo natural dessa razão, multiplica a razão pelo logaritmo, soma todas as contribuições e divide o total por n. Em termos simples, Theil T é a média da renda relativa multiplicada por seu logaritmo natural. O uso do logaritmo natural é indispensável, pois bases dez ou dois alteram a escala numérica. Cada entrada deve ser um número finito estritamente maior que zero. Essa regra evita logaritmos indefinidos e cumpre o contrato: valores iguais a zero, negativos, ausentes, infinitos ou não numéricos geram erro, em vez de serem descartados silenciosamente. Cada elemento do array recebe o mesmo peso populacional. Se um registro representar várias pessoas, expanda os dados em observações individuais ou aplique antes uma transformação com pesos apropriados. A renda total e a média retornadas permitem confirmar como a população enviada foi interpretada.
Como comparar grupos e interpretar valores
Use a mesma definição de população, período contábil, conceito de renda e tratamento de impostos ou transferências em todas as comparações. Misturar renda familiar mensal com renda pessoal anual produz um número, mas não uma comparação significativa. A família Theil é particularmente útil porque a desigualdade total pode ser decomposta em componentes internos aos grupos e entre grupos; essa decomposição exige populações e totais por grupo e não é feita por esta calculadora de um único array. Ainda assim, você pode calcular um índice separado para cada grupo definido de maneira consistente, desde que não confunda esses resultados independentes com uma decomposição aditiva. Não existe um limite universal que torne um valor Theil bom ou ruim: a interpretação depende da sociedade, do mercado, da amostragem e da pergunta. Verifique também se poucos valores extremos dominam o resultado, se os ajustes de inflação são uniformes e se a amostra é representativa. Em automações, preserve o array exato com a saída para permitir reprodução posterior.
Casos de uso
Comparar distribuições ao longo do tempo
Meça a desigualdade em registros anuais definidos de forma consistente e acompanhe se a concentração aumenta ou diminui entre períodos.
Auditar a desigualdade regional
Calcule valores Theil T por região quando conceito de renda, unidade populacional, moeda e período forem equivalentes.
Adicionar uma métrica reproduzível
Gere uma estatística determinística a partir de valores positivos validados e guarde contagem, total e média para auditoria.
Perguntas frequentes
O que significa um índice de Theil igual a zero?
Significa que todas as observações enviadas têm a mesma renda; portanto, a distribuição da população informada é perfeitamente igualitária.
Uma renda pode ser zero ou negativa?
Não. Todos os valores devem ser finitos e estritamente positivos. Zero e valores negativos geram erro porque a fórmula logarítmica não é definida por este contrato.
Qual versão do índice de Theil é calculada?
A calculadora retorna Theil T: a média da razão entre cada renda e a média multiplicada pelo logaritmo natural dessa razão. Ela não retorna Theil L.
Trocar a moeda altera o resultado?
Multiplicar todas as rendas pelo mesmo fator positivo de conversão não altera o índice, exceto pela precisão normal de ponto flutuante.
As observações de renda recebem pesos?
Cada elemento do array tem o mesmo peso. Registros que representam quantidades populacionais diferentes precisam ser expandidos ou transformados adequadamente antes do cálculo.
Quanto custa o cálculo pela API?
O preço da API é US$ 0,002 por solicitação. O mesmo cálculo determinístico também pode ser executado gratuitamente no navegador.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"incomes": [
10,
20,
30,
40
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "stat.theil_index",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_items | 100000 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |