Índice de Shannon
Contagens de dez, vinte, trinta e quarenta indivíduos em quatro espécies resultam em um índice de Shannon de 1,279854. Informe as abundâncias de um quadrante, rede ou armadilha fotográfica e tenha um número comparável entre áreas. 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
- Contagens
- 10, 20, 30, 40
- Total
- 100 nats
- Índice de Shannon
- 1,2798542258
- Riqueza
- 4
- Número de espécies
- 4
O índice de diversidade de Shannon, também chamado índice de Shannon–Wiener ou de Shannon–Weaver, mede o quão misturada está uma comunidade biológica a partir das contagens populacionais de cada espécie. Não é uma lista de espécies nem um simples recenseamento de riqueza: duas parcelas podem abrigar o mesmo número de táxons e mesmo assim diferir porque uma é dominada por uma única espécie abundante enquanto a outra reparte os indivíduos de forma mais uniforme. Contagens nulas não contribuem em nada, porque o limite de p vezes ln p quando p tende a zero é zero.
Como o índice de diversidade de Shannon é calculado
Some essas contagens uma única vez para obter o tamanho da comunidade N. Um total nulo significaria que cada abundância relativa seria zero sobre zero, por isso o motor rejeita essa entrada em vez de inventar um índice. Uma contagem nula não contribui: o limite conhecido de p ln p quando p tende a zero é zero, que é a convenção ecológica de todo manual padrão.
Quando todas as contagens positivas são idênticas, H linha se reduz ao logaritmo natural do número de táxons ocupados, que é também o máximo teórico H_max para aquela riqueza. Uma única espécie ocupada sempre produz H linha igual a zero porque p vale um e o ln de um é zero. A equitabilidade de Pielou J linha é H linha dividido pelo ln da riqueza; uma comunidade de uma espécie é tratada como perfeitamente uniforme, de modo que a equitabilidade vale um e não um zero sobre zero indefinido.
Esta é a leitura informacional de uma comunidade: H linha é a incerteza, em nats, da identidade específica de um indivíduo sorteado ao acaso da amostra.
O que você envia, o que recebe de volta e o que falha
Um número é uma espécie. Abundâncias fracionárias são permitidas para que uma série de biomassa ou de cobertura não precise ser arredondada primeiro a inteiros. Entradas nulas são permitidas e permanecem nos arrays counts e proportions devolvidos; elas não aumentam a riqueza.
Qualquer contagem negativa falha e nomeia o índice ofensivo, porque uma população negativa não é uma amostra. Quando todas as contagens são zero o total é zero e a tarefa falha com uma mensagem de que o índice de Shannon é indefinido quando N vale zero. Verificações clássicas incluem dez, vinte, trinta, quarenta, cujo índice fica perto de 1.279854, e três contagens iguais, cujo índice é o logaritmo natural de três.
Conecte o formulário gratuito do navegador para um caderno de campo e depois chame o mesmo contrato a partir de scripts quando precisar de gabaritos ou de um pipeline de monitoramento.
Quem usa o índice de Shannon e para quê
Ecólogos de campo, agências de conservação e laboratórios de sala usam uma calculadora determinística de Shannon para transformar um vetor de contagens de um quadrante, uma sessão de rede ou uma noite de armadilha fotográfica em um único número comparável que cabe ao lado do nome do sítio, em vez de discutir se a parcela «parecia» diversa.
Projetos de restauração comparam uma amostra pré-tratamento com uma pós-tratamento enviando as duas listas de contagens de forma independente e lendo a mudança de H linha e de equitabilidade; o motor não inventa um teste estatístico, apenas devolve a mesma fórmula nas duas vezes. Validação falha não consome saldo. Mantenha as listas dentro do limite de itens publicado, fixe os campos arredondados nos testes e você obtém um produto de diversidade reproduzível sem levantar uma pilha estatística própria.
Se mais adiante você precisar de dominância de Simpson, curvas de rarefação ou um teste de permutação de duas comunidades, trate-os como intenções de busca separadas em vez de sobrecarregar esta página do índice de Shannon.
Casos de uso
Anotações de quadrante e de transecto
Transforme uma linha de contagens de espécies de uma parcela, uma rede ou uma noite de armadilha em H′, riqueza e equitabilidade que você pode guardar ao lado do identificador do sítio.
Gabaritos de sala e de prova
Gere o índice de Shannon das listas de abundância do livro para que professores e autocorretores compartilhem uma única verdade de referência em vez de logaritmos que divergem.
Pipelines de restauração e monitoramento
Compare comunidades pré e pós-tratamento enviando cada vetor de contagens de forma independente e lendo a mudança de H′ e de equitabilidade.
Perguntas frequentes
O que é o índice de diversidade de Shannon?
Aqui é informado em nats (logaritmo natural). Um H′ mais alto significa uma comunidade mais misturada.
Contagens nulas alteram o índice?
Não. Uma abundância nula não contribui porque o limite de p ln p quando p tende a zero é zero. Zeros também não aumentam a riqueza, que conta apenas entradas estritamente positivas.
O que é a equitabilidade na resposta?
A equitabilidade de Pielou J′ = H′ / ln(S), o índice dividido pelo H′ máximo possível para aquela riqueza. Uma única espécie ocupada é tratada como perfeitamente uniforme, de modo que a equitabilidade vale 1.
Quanto custa?
A ferramenta do navegador é gratuita e roda localmente.
Qual é o valor máximo do índice de Shannon?
Quando todas as espécies têm a mesma contagem, o índice é o logaritmo natural do número de espécies, o máximo possível para essa riqueza. Três contagens iguais dão ln 3; uma única espécie sempre dá zero.
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/eco/shannon-index \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"counts":[10,20,30,40]}'const res = await fetch("https://api.kit.forhosting.com/eco/shannon-index", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"counts": [
10,
20,
30,
40
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/eco/shannon-index",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"counts": [
10,
20,
30,
40
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/eco/shannon-index", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"counts":[10,20,30,40]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"counts":[10,20,30,40]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/eco/shannon-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
{
"counts": [
10,
20,
30,
40
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "eco.shannon_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 | 10000 |
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
Esta calculadora recebe uma lista de contagens populacionais não negativas, converte cada contagem em uma abundância relativa p_i igual a n_i sobre N e devolve H linha igual a menos a soma de p_i vezes o logaritmo natural de p_i. Uma contagem negativa não é uma população, e um total nulo deixa cada proporção indefinida, de modo que esses casos falham com invalid_input em vez de devolver NaN.
Como o índice de diversidade de Shannon é calculado
Comece com uma lista não vazia de contagens populacionais n_1 até n_S, cada uma um número finito não negativo. Para cada espécie calcule a abundância relativa p_i igual a n_i dividido por N. O índice de Shannon–Wiener em nats é então H linha igual a menos a soma de p_i vezes o logaritmo natural de p_i, tomada apenas sobre as espécies cuja contagem é estritamente positiva. O pipeline é aritmética ordinária de ponto flutuante, sem sementes aleatórias, sem carimbos de relógio e sem consulta de rede, de modo que contagens idênticas sempre produzem o mesmo JSON.
O que você envia, o que recebe de volta e o que falha
Envie um objeto JSON com um campo obrigatório chamado counts, ou os aliases populations, abundances, values ou n, contendo um array JSON de números finitos não negativos ou uma string com números separados por vírgulas, espaços ou ponto e vírgula. Campos ausentes, arrays vazios, strings vazias, booleanos, objetos, NaN, Infinity e tokens que não são decimais simples nem notação científica falham com invalid_input e não são cobrados. Em caso de sucesso, a resposta informa shannon_index como o H linha principal em nats, richness como o número de contagens estritamente positivas, species_count como o comprimento da entrada incluindo zeros, total como N, evenness como J linha de Pielou, os counts e proportions limpos na ordem de entrada, log_base e, unit nats e a string compacta de fórmula. Chamadas API bem-sucedidas usam a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.
Onde uma API do índice de Shannon justifica o uso
Programas de monitoramento de longo prazo que já guardam tabelas de abundância espécie por sítio podem enviar uma tarefa por linha e armazenar shannon_index, richness e evenness ao lado do identificador da visita sem abrir uma planilha de logaritmos. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.
Perguntas técnicas
Por que contagens negativas e um total nulo são rejeitados?
Uma população negativa não é uma amostra. Quando todas as contagens são zero, N é zero e cada p_i fica indefinida, de modo que o índice não pode ser calculado. Ambos os casos falham com invalid_input.