Calculadora de proporções de abundância
Com 40, 30, 20 e 10 árvores o total é 100 e as proporções são 0,4, 0,3, 0,2 e 0,1: a calculadora transforma contagens brutas nas proporções que os índices de Shannon, Simpson e equabilidade usam. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
A ecologia de comunidades reduz uma amostra de campo a abundâncias relativas antes de se poder calcular a entropia de Shannon, a dominância de Simpson ou a equitabilidade de Pielou. Esta calculadora de proporções de abundância de espécies aceita uma lista de táxons nomeados com contagens não negativas — ou qualquer medida de abundância não negativa como biomassa, área basal ou cobertura percentual —, divide cada valor pelo total da amostra N e devolve proporções, percentuais, postos, uma cota acumulada e a cota dominante de Berger-Parker.
O que é abundância proporcional e por que o trabalho de diversidade começa aqui
Abundância relativa é a fração de uma amostra de comunidade que pertence a um táxon. Trabalhar com contagens brutas sem dividir por N mistura o tamanho da amostra no índice seguinte e torna dois sítios incomparáveis quando uma caminhada foi mais longa que a outra. Esta calculadora faz só essa normalização: não calcula um índice de diversidade, por isso permanece uma página dedicada à busca por proporções de abundância de espécies em vez de competir com uma página de Simpson ou de Shannon.
As contagens podem ser inteiros de um ponto de contagem ou reais não negativos de biomassa, área basal ou cobertura percentual; a álgebra é a mesma. Uma amostra toda zero não tem N e é rejeitada.
Contrato de entrada, campos de resposta e erros de validação
Nesta rota parse gratuita são permitidas no máximo dez mil linhas. Os arrays paralelos proportions e percents respeitam a ordem de entrada para que um script de Shannon ou Simpson consuma o vetor p sem analisar nomes. Strings formula e method entram para exibição e auditoria.
Campos numéricos são arredondados a doze dígitos significativos para goldens estáveis entre runtimes. Checagem clássica: quarenta, trinta, vinte e dez indivíduos de quatro árvores nomeadas dão N igual a cem e cotas 0.4, 0.3, 0.2 e 0.1.
Quem precisa de abundâncias relativas
Avaliações de impacto ambiental e cartões de restauração precisam de abundâncias relativas reproduzíveis ao argumentar que um povoamento pós-distúrbio ainda é dominado por poucos táxons oportunistas — a cota de Berger-Parker e a coluna acumulada ranqueada tornam essa afirmação verificável. Laboratórios didáticos e cursos de ecologia on-line usam uma calculadora ao vivo para que estudantes digitem contagens nomeadas de um ponto de aves ou de um quadrante vegetal e vejam percentuais e postos atualizarem sem instalar R nem vegan.
Cadernos de pesquisa que já calculam índices de diversidade podem padronizar o vetor p uma vez e reutilizá-lo em vários índices sem dividir de novo por N em cada célula.
Perguntas frequentes
Como converter contagens de espécies em abundâncias proporcionais?
Envie um array species de linhas { name, count }.
Esta calculadora obtém a diversidade de Shannon ou de Simpson?
Não. Ela só monta o vetor p que esses índices consomem. Use uma capacidade dedicada de Shannon ou Simpson sobre o array proportions se precisar do índice.
O que acontece se todas as contagens forem zero?
Listas vazias e nomes ausentes também são rejeitados e não são cobrados.
Posso usar biomassa ou cobertura percentual em vez de indivíduos?
Sim. Qualquer medida de abundância finita não negativa serve: indivíduos, biomassa, área basal ou cobertura. Cada linha ainda é dividida pela soma de todas as linhas.
O que é a proporção de Berger-Parker?
É a fatia da espécie mais abundante. Em uma amostra de 40, 30, 20 e 10 árvores, a espécie dominante reúne 0,4 do total, um sinal rápido de quanto um único táxon domina.
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/bio/species-abundance-proportions \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"species":[{"name":"Quercus alba","count":40},{"name":"Acer saccharum","count":30},{"name":"Fagus grandifolia","count":20},{"name":"Pinus strobus","count":10}]}'const res = await fetch("https://api.kit.forhosting.com/bio/species-abundance-proportions", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"species": [
{
"name": "Quercus alba",
"count": 40
},
{
"name": "Acer saccharum",
"count": 30
},
{
"name": "Fagus grandifolia",
"count": 20
},
{
"name": "Pinus strobus",
"count": 10
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/bio/species-abundance-proportions",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"species": [
{
"name": "Quercus alba",
"count": 40
},
{
"name": "Acer saccharum",
"count": 30
},
{
"name": "Fagus grandifolia",
"count": 20
},
{
"name": "Pinus strobus",
"count": 10
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/bio/species-abundance-proportions", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"species":[{"name":"Quercus alba","count":40},{"name":"Acer saccharum","count":30},{"name":"Fagus grandifolia","count":20},{"name":"Pinus strobus","count":10}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"species":[{"name":"Quercus alba","count":40},{"name":"Acer saccharum","count":30},{"name":"Fagus grandifolia","count":20},{"name":"Pinus strobus","count":10}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/bio/species-abundance-proportions", 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
{
"species": [
{
"name": "Quercus alba",
"count": 40
},
{
"name": "Acer saccharum",
"count": 30
},
{
"name": "Fagus grandifolia",
"count": 20
},
{
"name": "Pinus strobus",
"count": 10
}
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "bio.species_abundance_proportions",
"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
Esses índices consomem p_i igual a n_i sobre N, não as contagens brutas de um quadrante, um transecto ou uma rede de neblina. Listas vazias, nomes ausentes, contagens negativas e uma amostra toda zero falham com invalid_input para que você nunca publique um vetor p oco.
O que é abundância proporcional e por que o trabalho de diversidade começa aqui
Se a espécie i foi registrada com abundância n_i e a amostra reúne N igual à soma de todos os n_i, a abundância proporcional é p_i igual a n_i dividido por N. Esses valores p_i — não as contagens brutas — são as entradas reais da entropia de Shannon (menos a soma de p_i vezes o logaritmo natural de p_i), do lambda de Simpson (a soma de p_i ao quadrado), do Simpson inverso (um sobre lambda), da equitabilidade de Pielou e dos gráficos de posto-abundância ou de Whittaker. Linhas com contagem zero são mantidas com p_i igual a zero e não somam à riqueza. O táxon dominante é a linha com a maior contagem; seu p_i é o índice de dominância de Berger-Parker, um companheiro compacto do vetor p que muitos relatórios de monitoramento imprimem ao lado da tabela de cotas.
Contrato de entrada, campos de resposta e erros de validação
Envie um corpo JSON com o campo obrigatório species: um array não vazio de objetos, cada um com uma string name não vazia e um número count finito não negativo. Os aliases taxa, abundances, community e rows são aceitos para a lista; em cada linha, count também aceita n, abundance ou individuals. Campo ausente, lista vazia, linhas que não são objeto, nomes em branco, tokens não numéricos, valores negativos e um total todo zero falham com invalid_input e não são cobrados. Em caso de sucesso o corpo devolve species como array na ordem de entrada; cada linha traz name, count, proportion p_i, percent, rank (um é o mais abundante; empates conservam a ordem de entrada anterior) e cumulative_proportion (soma corrente dos valores p ao longo dessa ordem de posto, útil para curvas de dominância). Os campos de resumo são species_count (riqueza: linhas com count maior que zero), row_count, total_individuals N, dominant_name, dominant_count, dominant_proportion, dominant_percent, berger_parker (igual ao maior p_i) e sum_of_proportions (deve ser um após o arredondamento).
Onde uma API de proporções de abundância de espécies agrega valor
Programas de monitoramento da biodiversidade reduzem as contagens brutas de cada parcela a um vetor p antes de guardar séries temporais ou alimentar calculadoras de Shannon, Simpson ou equitabilidade; automatizar p_i igual a n_i sobre N remove o desvio de planilha quando técnicos copiam uma fórmula SUM pela folha e esquecem de travar N. Aplicativos móveis de campo podem chamar o mesmo endpoint parse a partir de listas de contagens sincronizadas offline quando a conectividade volta, cobrando só tarefas bem-sucedidas ao preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída no worker.
Casos de integração
Vetores p de parcelas e transectos
Transforme contagens nomeadas de uma parcela vegetal, um ponto de aves ou um quadrante em p_i, percentuais e postos antes de Shannon ou Simpson.
Tabelas de impacto e restauração
Documente se poucos táxons ainda dominam após um distúrbio informando Berger-Parker max(p_i) ao lado da tabela completa de cotas.
Laboratórios didáticos e aplicativos de campo
Permita que estudantes ou técnicos colem uma amostra de comunidade nomeada e leiam proporções iguais à rota API usada na análise posterior.
Perguntas técnicas
Quanto custa a calculadora de proporções de abundância de espécies?
A ferramenta no navegador é gratuita. Solicitações API usam saldo KIT pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.