ForHosting KIT · Ferramentas para dev

Calculadora de divergência de Kullback-Leibler

Esta calculadora de divergência de Kullback-Leibler mede quanto uma distribuição de probabilidade discreta difere de uma distribuição de referência.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe dois vetores do mesmo tamanho, com probabilidades que somem um, para obter a divergência direcionada em nats. O cálculo é determinístico, usa o logaritmo natural e trata corretamente os zeros da primeira distribuição. A validação também identifica comprimentos incompatíveis, totais inválidos, valores negativos e probabilidades de referência iguais a zero, evitando resultados infinitos ou indefinidos apresentados de forma enganosa.

Entenda o que a divergência KL mede

A divergência de Kullback-Leibler compara uma distribuição P com uma referência Q por meio da razão logarítmica entre probabilidades correspondentes. Ela responde a uma pergunta direcionada: quanta informação se perde ao usar Q para representar resultados que seguem P? Zero significa que as distribuições coincidem em todas as posições; valores positivos maiores indicam discrepância maior. A direção é essencial, pois trocar P e Q geralmente altera a resposta. Esta ferramenta calcula D(P || Q): o primeiro vetor é avaliado e o segundo serve de referência. Como utiliza logaritmos naturais, o resultado aparece em nats, não em bits. A divergência KL não é uma distância métrica: é assimétrica e não satisfaz a desigualdade triangular. Essas características são úteis em teoria da informação, inferência estatística, ajuste de modelos e comparações com uma referência bem definida.

Prepare vetores de probabilidade válidos

Informe o mesmo número de probabilidades nos dois vetores e mantenha as categorias na mesma ordem. Se a primeira posição representa chuva em P, ela também deve representar chuva em Q. Todo valor precisa ser finito e não negativo, e cada vetor completo deve somar um. Uma pequena tolerância acomoda a representação de ponto flutuante, mas a ferramenta não normaliza pesos arbitrários. Normalize contagens ou pontuações antes do envio. Zero em P é permitido, pois um evento impossível contribui com zero. Qualquer zero na referência é rejeitado: ele torna indisponível a razão logarítmica quando o P correspondente é positivo e pode implicar divergência infinita. Essa validação ajuda você a detectar categorias trocadas, vetores truncados, percentuais inteiros e conjuntos incompatíveis antes de alimentar um relatório ou pipeline.

Interprete e use o resultado com cuidado

A resposta contém a divergência e a unidade nats. Valores próximos de zero indicam que Q representa P de forma adequada, mas não há um limite universal entre modelo bom e ruim. A relevância depende da quantidade de categorias, da aplicação, da amostragem e do custo dos erros. Compare somente resultados com as mesmas definições e direção. Você pode acompanhar mudanças entre versões de modelos, comparar dados recentes com uma linha de base ou relatar a medida com outras métricas e incertezas. Não trate o resultado como probabilidade, percentual, correlação ou distância simétrica. Ruído amostral também pode gerar divergência entre amostras do mesmo processo. O navegador atende verificações pontuais; cada solicitação de API custa US$ 0,002 e permite automação repetível. Como o algoritmo é determinístico, entradas válidas idênticas produzem o mesmo JSON arredondado.

Monitorar mudança de distribuição

Compare uma distribuição categórica atual com uma referência positiva para quantificar alterações direcionadas ao longo do tempo.

Avaliar modelos probabilísticos

Meça como uma referência do modelo difere de uma distribuição observada ou desejada com uma métrica informacional padrão.

Verificar hipóteses de compressão

Estime a penalidade informacional de representar resultados com probabilidades diferentes das probabilidades da fonte.

Qual direção a calculadora utiliza?

Ela calcula D(P || Q), da primeira distribuição para a segunda, usada como referência. Inverter os vetores pode alterar o valor.

Por que o resultado é expresso em nats?

A fórmula usa o logaritmo natural. Um logaritmo de base dois produziria um resultado em bits.

A primeira distribuição pode conter zero?

Sim. Pela convenção de limite padrão, uma probabilidade zero em P contribui com zero para a divergência.

Por que probabilidades de referência iguais a zero são rejeitadas?

Um zero em Q deixa a razão logarítmica indefinida para um P correspondente positivo e pode implicar divergência infinita.

As probabilidades precisam somar exatamente um?

Elas devem somar um dentro de uma pequena tolerância numérica. A calculadora valida, mas não normaliza pesos automaticamente.

Quanto custa um cálculo pela API?

Cada solicitação de API custa US$ 0,002. Você também pode executar o cálculo gratuitamente no navegador.

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/stat/kl-divergence

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/stat/kl-divergence \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"distribution":[0.5,0.3,0.2],"reference":[0.4,0.4,0.2]}'
{
  "distribution": [
    0.5,
    0.3,
    0.2
  ],
  "reference": [
    0.4,
    0.4,
    0.2
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "stat.kl_divergence",
  "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.

Ver a documentação completa do KIT →