Índice de Theil
Quatro rendas desiguais que somam 100, com média de 25, geram um índice de Theil positivo, mas longe do teto para quatro pessoas: há desigualdade, porém moderada. Informe rótulos de grupo para ver onde ela se concentra. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Rendas
- 10, 20, 30, 40
- N
- 4
- Renda média
- 25
- Renda total
- 100
- T de Theil
- 0,1064401353
O índice de Theil T é uma medida de desigualdade baseada em entropia que transforma uma lista de rendas individuais em um único número não negativo: zero quando todos ganham o mesmo valor, e maior quando a renda se concentra em menos pessoas. Economistas, analistas de políticas e jornalistas de dados usam-no porque ele se decompõe de forma aditiva em componentes intra e intergrupos—algo que o coeficiente de Gini não oferece com clareza. Esta capacidade aceita uma distribuição de rendas estritamente positivas, calcula a fórmula clássica de Theil T com logaritmo natural, informa a média e o total de renda, um teto teórico ln(n) e uma razão normalizada opcional T/ln(n). Quando você também envia rótulos de subgrupo do mesmo comprimento, ela devolve o Theil por grupo e as contribuições within e between que somam o índice geral.
O que o índice de Theil T mede e por que a entropia importa
Theil T pertence à família de medidas de desigualdade de entropia generalizada. Quando cada renda iguala a média, cada razão é um, cada termo logarítmico é zero e T é exatamente zero—igualdade perfeita. Quando uma pessoa detém quase toda a renda e as demais mantêm montantes positivos minúsculos, os termos logarítmicos ponderados crescem e T se aproxima do teto de amostra finita ln(n).
Interpretar T como uma divergência de Kullback–Leibler entre a distribuição real de rendas e o repasse igualitário não é linguagem de marketing: é a leitura padrão da teoria da informação que justifica o rótulo de entropia. Diferente do coeficiente de Gini, que resume a curva de Lorenz com contagem dupla de lacunas aos pares, Theil T é mais sensível a mudanças no topo da distribuição e admite uma partição aditiva exata entre partições populacionais.
Essa partição explica por que contas regionais, estudos salariais setoriais e análises de financiamento de distritos escolares costumam preferir Theil quando a pergunta é quanta desigualdade vive dentro dos grupos versus quanta vem das lacunas entre grupos. Esta calculadora implementa essa definição apenas com aritmética de números finitos: sem amostragem, sem chamadas a modelos e sem reponderação oculta, salvo se você fornecer as rendas que pretende medir.
Onde o índice de Theil é usado
Economistas do desenvolvimento e institutos oficiais de estatística calculam Theil T em microdados de pesquisas domiciliares para acompanhar tendências de desigualdade e atribuir mudanças a forças within-region versus between-region. Equipes de remuneração corporativa e plataformas de analytics de RH aplicam a mesma fórmula a faixas salariais por departamento ou unidade quando precisam de um painel de desigualdade decomponível em vez de um único Gini opaco.
Mantenha as rendas estritamente positivas, alinhe os rótulos de grupo opcionais por índice e obtenha medidas de desigualdade baseadas em entropia reproduzíveis para cadernos, plugins LMS e workers na borda sem montar uma pilha estatística própria.
Casos de uso
Microdados de pesquisa e decomposição regional
Calcule Theil T sobre rendas domiciliares e, com rótulos de região, separe a desigualdade em parcelas within-region e between-region para notas de política.
Analytics de remuneração e força de trabalho
Meça a desigualdade salarial entre funcionários e decomponha por departamento ou unidade com as mesmas contribuições Theil within e between.
Ensino e correção automatizada
Permita que alunos verifiquem exemplos de Theil do livro e identidades de subgrupo opcionais contra um oráculo determinístico em plugins LMS.
Perguntas frequentes
Por que cada renda deve ser estritamente positiva?
Theil T usa o logaritmo natural das razões de renda.
Como Theil T difere do coeficiente de Gini?
Gini resume a curva de Lorenz e não se decompõe de forma aditiva simples entre grupos. Theil T é baseado em entropia, mais sensível ao topo e se divide com clareza em desigualdade within-group e between-group.
O que significa um índice de Theil igual a zero?
Igualdade perfeita: todos ganham a média e cada termo logarítmico vale zero. O índice cresce conforme a renda se concentra em menos mãos, até um teto igual ao logaritmo natural do número de pessoas.
Posso separar a desigualdade dentro e entre grupos?
Sim. Informe um rótulo de grupo para cada renda, como uma região ou um departamento. Você recebe o índice de cada grupo e as partes dentro e entre grupos, que somam exatamente o total.
O que é o índice de Theil normalizado?
É o índice dividido pelo seu valor máximo possível para esse número de pessoas, o logaritmo natural de n. Assim, populações de tamanhos diferentes ficam comparáveis em uma mesma escala de 0 a 1.
Ferramentas relacionadas
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/econ/theil-index-distribution \
-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/econ/theil-index-distribution", {
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/econ/theil-index-distribution",
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/econ/theil-index-distribution", 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/econ/theil-index-distribution", 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": "econ.theil_index_distribution",
"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.
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. |
Notas técnicas
O que o índice de Theil T mede e por que a entropia importa
Para uma população de n pessoas com rendas estritamente positivas y_i e média aritmética μ, o índice é a média das parcelas de renda vezes o logaritmo dessas parcelas: T é igual a um sobre n vezes a soma em i de (y_i sobre μ) vezes o logaritmo natural de (y_i sobre μ).
Contrato de entrada, grupos opcionais, campos de resposta e erros
Os números são arredondados a doze casas decimais para goldens estáveis entre runtimes. Envie um corpo JSON com o campo obrigatório incomes: um array não vazio de números finitos estritamente positivos (os alias values, y e data são aceitos). Listas vazias, zeros, negativos e valores não finitos falham com invalid_input porque o logaritmo de uma razão de renda não positiva é indefinido. Opcionalmente envie groups (alias subgroup, labels, region): um array de rótulos não vazios com o mesmo comprimento de incomes. Quando há grupos, o solucionador agrupa observações por rótulo, calcula o Theil T de cada grupo, forma a desigualdade within-group como soma ponderada pela parcela de renda desses índices de grupo e a desigualdade between-group como a soma de s_g vezes ln(s_g sobre p_g), onde s_g é a parcela de renda total do grupo e p_g sua parcela populacional. A resposta sempre devolve n, mean_income, total_income, theil_t, max_theil como ln(n) para n maior que um (zero para um singleton), normalized_theil como theil_t dividido por max_theil quando esse teto é positivo, um booleano equal_share, uma string formula e uma interpretação breve. Com groups também retorna within_theil, between_theil, decomposition_check (sua soma, para auditoria), group_count e um array groups ordenado por rótulo com médias, parcelas e contribuições por grupo. Falhas de validação não são cobradas; chamadas bem-sucedidas usam o preço-base publicado US$ 0,002 por item no caminho API, enquanto a ferramenta do navegador permanece gratuita.
Onde uma API do índice de Theil agrega valor em pesquisa e produto
Plataformas de ensino e MOOC usam o endpoint como oráculo: os alunos enviam vetores de exemplo pequenos como dez-vinte-trinta-quarenta e verificam tanto o T geral quanto, ao anexar rótulos de região, a identidade within-plus-between. Como a implementação é parse de nível A puro, cada chamada bem-sucedida custa o US$ 0,002 publicado sem tokens de modelo e sem rede de saída, validação falha não consome saldo e você pode fixar saídas arredondadas em testes unitários.
Perguntas técnicas
Como o índice de Theil T é calculado a partir das rendas?
Para n rendas positivas com média μ, T = (1/n) · Σ (y_i/μ) · ln(y_i/μ). A API devolve esse valor como theil_t, mais média, total, max_theil = ln(n) e normalized_theil opcional = T/ln(n).
Como funciona a decomposição por subgrupos?
Forneça um array groups alinhado com incomes. A resposta inclui within_theil, between_theil e detalhes por grupo. Por construção, within_theil + between_theil iguala o theil_t geral (salvo arredondamento).
Quanto custa a calculadora do índice de Theil?
A ferramenta do navegador é gratuita. Solicitações API usam saldo KIT pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.