Indice di Shannon
Conteggi di dieci, venti, trenta e quaranta individui su quattro specie danno un indice di Shannon di 1,279854. Inserisca le abbondanze di un quadrato, di una rete o di una fototrappola e ottenga un numero confrontabile tra siti. Gratis nel Suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Conteggi
- 10, 20, 30, 40
- Totale
- 100 nats
- Indice di Shannon
- 1,2798542258
- Ricchezza
- 4
- Numero di specie
- 4
L’indice di diversità di Shannon, detto anche indice di Shannon–Wiener o di Shannon–Weaver, misura quanto è mescolata una comunità biologica a partire dai conteggi di popolazione di ciascuna specie. Non è un elenco di specie né un semplice conteggio di ricchezza: due aree possono ospitare lo stesso numero di taxa e tuttavia differire perché una è dominata da una sola specie abbondante mentre l’altra ripartisce gli individui in modo più uniforme. I conteggi nulli non contribuiscono affatto, perché il limite di p per ln p quando p tende a zero è zero.
Come si calcola l’indice di diversità di Shannon
Si sommino quei conteggi una sola volta per ottenere la dimensione della comunità N. Un totale nullo significherebbe che ogni abbondanza relativa sarebbe zero su zero, perciò il motore respinge quell’ingresso invece di inventare un indice. Un conteggio nullo non contribuisce: il noto limite di p ln p quando p tende a zero è zero, convenzione ecologica di ogni manuale standard.
Quando tutti i conteggi positivi sono identici, H primo si riduce al logaritmo naturale del numero di taxa occupati, che è anche il massimo teorico H_max per quella ricchezza. Una sola specie occupata produce sempre H primo pari a zero perché p vale uno e ln di uno è zero. L’equitabilità di Pielou J primo è H primo diviso ln della ricchezza; una comunità di una specie è trattata come perfettamente uniforme, perciò l’equitabilità vale uno e non uno zero su zero indefinito.
Questa è la lettura informazionale di una comunità: H primo è l’incertezza, in nats, dell’identità specifica di un individuo estratto a caso dal campione.
Che cosa invia Lei, che cosa riceve e che cosa fallisce
Un numero corrisponde a una specie. Le abbondanze frazionarie sono ammesse così una serie di biomassa o di copertura non deve essere prima arrotondata a interi. Le voci nulle sono ammesse e restano negli array counts e proportions restituiti; non aumentano la ricchezza.
Qualsiasi conteggio negativo fallisce e indica l’indice incriminato, perché una popolazione negativa non è un campione. Quando tutti i conteggi sono zero il totale è zero e l’operazione fallisce con un messaggio che l’indice di Shannon è indefinito quando N vale zero. I controlli classici includono dieci, venti, trenta, quaranta, il cui indice è circa 1.279854, e tre conteggi uguali, il cui indice è il logaritmo naturale di tre.
Si colleghi il modulo gratuito del browser a un taccuino di campo, poi si richiami lo stesso contratto da script quando servono chiavi di risposta o una pipeline di monitoraggio.
Chi usa l'indice di Shannon e perché
Gli ecologi di campo, le agenzie di conservazione e i laboratori didattici usano un calcolatore deterministico di Shannon per trasformare un vettore di conteggi da un quadrato, una sessione di rete o una notte di fototrappola in un unico numero confrontabile da mettere accanto al nome del sito, invece di discutere se l’area «sembrava» diversa.
I progetti di ripristino confrontano un campione pre-trattamento con uno post-trattamento inviando le due liste di conteggi in modo indipendente e leggendo il cambiamento di H primo e di equitabilità; il motore non inventa un test statistico, restituisce soltanto la stessa formula entrambe le volte. Una convalida fallita non consuma saldo. Si tengano gli elenchi entro il limite di voci pubblicato, si fissino i campi arrotondati nei test e si ottiene un prodotto di diversità riproducibile senza allestire una pila statistica propria.
Se in seguito servono dominanza di Simpson, curve di rarefazione o un test di permutazione di due comunità, li si tratti come intenzioni di ricerca distinte invece di sovraccaricare questa pagina dell’indice di Shannon.
Casi d'uso
Note di quadrato e di transetto
Si trasformi una riga di conteggi di specie da un’area, una rete o una notte di trappola in H′, ricchezza ed equitabilità da conservare accanto all’identificatore del sito.
Chiavi d’aula e d’esame
Si generi l’indice di Shannon delle liste di abbondanza del manuale così docenti e correttori automatici condividono un’unica verità di riferimento invece di logaritmi che divergono.
Pipeline di ripristino e monitoraggio
Si confrontino comunità pre e post-trattamento inviando ciascun vettore di conteggi in modo indipendente e leggendo il cambiamento di H′ e di equitabilità.
Domande frequenti
Che cos’è l’indice di diversità di Shannon?
Qui è riportato in nats (logaritmo naturale). Un H′ più alto significa una comunità più mescolata.
I conteggi nulli modificano l’indice?
No. Un’abbondanza nulla non contribuisce perché il limite di p ln p quando p tende a zero è zero. Gli zeri non aumentano nemmeno la ricchezza, che conta solo le voci strettamente positive.
Che cos’è l’equitabilità nella risposta?
L’equitabilità di Pielou J′ = H′ / ln(S), l’indice diviso per il H′ massimo possibile per quella ricchezza. Una sola specie occupata è trattata come perfettamente uniforme, perciò l’equitabilità vale 1.
Quanto costa?
Lo strumento del browser è gratuito e gira in locale.
Qual è il valore massimo dell'indice di Shannon?
Quando tutte le specie hanno lo stesso conteggio, l'indice è il logaritmo naturale del numero di specie, il massimo per quella ricchezza. Tre conteggi uguali danno ln 3; una sola specie dà sempre zero.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
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)Esempio di richiesta
{
"counts": [
10,
20,
30,
40
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "eco.shannon_index",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_items | 10000 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Questo calcolatore prende un elenco di conteggi non negativi, converte ciascun conteggio in un’abbondanza relativa p_i uguale a n_i su N e restituisce H primo uguale a meno la somma di p_i per il logaritmo naturale di p_i. Un conteggio negativo non è una popolazione, e un totale nullo lascia ogni proporzione indefinita, perciò quei casi falliscono con invalid_input invece di restituire NaN.
Come si calcola l’indice di diversità di Shannon
Si parta da un elenco non vuoto di conteggi di popolazione n_1 fino a n_S, ciascuno un numero finito non negativo. Per ciascuna specie si calcoli l’abbondanza relativa p_i uguale a n_i diviso N. L’indice di Shannon–Wiener in nats è allora H primo uguale a meno la somma di p_i per il logaritmo naturale di p_i, presa solo sulle specie il cui conteggio è strettamente positivo. La pipeline è aritmetica ordinaria a virgola mobile, senza semi casuali, senza timestamp e senza consultazione di rete, così conteggi identici producono sempre lo stesso JSON.
Che cosa invia Lei, che cosa riceve e che cosa fallisce
Si invii un oggetto JSON con un campo obbligatorio chiamato counts, o gli alias populations, abundances, values oppure n, contenente un array JSON di numeri finiti non negativi oppure una stringa con numeri separati da virgole, spazi o punti e virgola. Campi assenti, array vuoti, stringhe vuote, booleani, oggetti, NaN, Infinity e token che non sono decimali semplici né notazione scientifica falliscono con invalid_input e non vengono addebitati. In caso di successo, la risposta riporta shannon_index come H primo principale in nats, richness come il numero di conteggi strettamente positivi, species_count come la lunghezza dell’ingresso inclusi gli zeri, total come N, evenness come J primo di Pielou, i counts e proportions ripuliti nell’ordine di ingresso, log_base e, unit nats e la stringa compatta di formula. Le chiamate API andate a buon fine usano la base pubblicata di $0.002 per voce; i fallimenti di convalida non consumano il saldo prepagato.
Dove un’API dell’indice di Shannon merita il suo posto
I programmi di monitoraggio di lungo periodo che già archiviano tabelle di abbondanza specie per sito possono inviare un’operazione per riga e memorizzare shannon_index, richness ed evenness accanto all’identificatore della visita senza aprire un foglio di logaritmi. Poiché l’implementazione è parse puro di livello A, ogni chiamata andata a buon fine costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita.
Domande tecniche
Perché i conteggi negativi e un totale nullo vengono respinti?
Una popolazione negativa non è un campione. Quando tutti i conteggi sono zero, N è zero e ogni p_i resta indefinita, quindi l’indice non può essere calcolato. Entrambi i casi falliscono con invalid_input.