ForHosting KIT · Finanças e dinheiro

Í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
Use pelo WebAPIE-mailTelegramApp em breve
Se você digitar
Rendas
10, 20, 30, 40
Você obtém
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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/econ/theil-index-distribution

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

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]}'
{
  "incomes": [
    10,
    20,
    30,
    40
  ]
}
{
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

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.

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.

Ver a documentação completa do KIT →