Calculateur de richesse spécifique
La richesse spécifique correspond au nombre d’espèces distinctes observées dans un échantillon défini.
Lancer gratuitement
Collez un nom par ligne, ou séparez les noms par des virgules, des points-virgules ou des tabulations : le calculateur élimine les répétitions avant de fournir le total. Il indique aussi le nombre d’observations et les libellés distincts reconnus afin que vous puissiez contrôler le résultat. Le calcul est déterministe, sans consultation externe, et fonctionne dans le navigateur comme par API.
Préparez un échantillon représentant une seule unité écologique
Partez d’observations issues d’un échantillon clairement délimité, par exemple un quadrat, une visite de transect, une période de piégeage ou une bibliothèque de séquençage après attribution taxonomique. Saisissez le libellé de l’espèce pour chaque observation, répétitions comprises. Si le chêne apparaît cinq fois, inscrivez-le cinq fois : total_observations conservera cette information tandis que species_richness ne comptera le chêne qu’une fois. Séparez les libellés par des retours à la ligne, des virgules, des points-virgules ou des tabulations. Les entrées vides et les espaces périphériques sont ignorés, et les suites d’espaces internes sont réduites afin qu’une mise en forme accidentelle ne crée pas de fausse espèce. Conservez le même rang taxonomique dans tout l’échantillon. Mélanger espèces, genres, groupes informels et catégories indéterminées peut déformer le résultat, car le calculateur ne déduit aucune équivalence biologique. Harmonisez synonymes, orthographes et révisions taxonomiques lorsqu’ils désignent le même organisme. Par défaut, les différences de casse ne créent pas une nouvelle espèce. Activez la distinction uniquement si les majuscules ont réellement un sens dans votre système. Ne regroupez pas des sites ou dates sans rapport, sauf si vous cherchez précisément une richesse cumulée.
Comprenez précisément la production du décompte
L’algorithme découpe d’abord le texte à chaque séparateur accepté. Il retire les espaces aux extrémités, normalise les suites d’espaces et écarte les entrées vides. Il crée ensuite une clé de comparaison pour chaque observation. Avec le réglage par défaut, qui ignore la casse, cette clé est la version en minuscules du libellé ; lorsque la casse est prise en compte, le libellé nettoyé sert directement de clé. La première occurrence de chaque clé est conservée dans distinct_species. Les suivantes augmentent total_observations sans modifier species_richness. La richesse est donc la taille de l’ensemble des clés nettoyées uniques. La liste renvoyée suit l’ordre de première apparition, ce qui facilite son rapprochement avec les données sources sans tri alphabétique inattendu. Aucun poids d’abondance, indice de diversité, raréfaction, référentiel taxonomique ou estimateur statistique n’intervient. Une espèce vue une fois contribue autant qu’une espèce vue de nombreuses fois. Le résultat est un décompte observé élémentaire et non une estimation des espèces non détectées. Les règles déterministes produisent toujours la même sortie pour la même entrée et les mêmes options. Si le total vous surprend, examinez distinct_species : des noms presque identiques révèlent souvent une faute ou une taxonomie incohérente.
Interprétez la richesse sans dépasser la portée de l’échantillon
La richesse observée est facile à communiquer, mais elle dépend fortement de l’effort d’échantillonnage, de la probabilité de détection, de la saison, de la couverture de l’habitat et de la qualité des identifications. Un échantillon plus grand contient souvent davantage d’espèces, car les espèces rares ont plus de chances d’être rencontrées. Ne comparez les valeurs que si les méthodes et les efforts sont raisonnablement compatibles, ou complétez l’analyse par une raréfaction ou une méthode adaptée aux efforts inégaux. La richesse ne décrit pas non plus l’équitabilité. Deux communautés peuvent compter six espèces alors que l’une est dominée par une seule et que l’autre présente des abondances équilibrées. Utilisez une mesure sensible aux abondances lorsque cette différence importe. Conservez total_observations et les métadonnées originales avec species_richness afin que le contexte reste vérifiable. Le calculateur traite les libellés comme des identifiants, non comme des taxons validés : deux synonymes restent séparés sans harmonisation, et deux organismes placés sous un nom trop large restent réunis. Pour un suivi, gardez des conventions stables et consignez les regroupements ou séparations taxonomiques. L’API coûte $0.002 par requête, tandis que le même calcul déterministe est gratuit dans le navigateur. Dans un rapport, parlez de richesse observée de l’échantillon indiqué, et non du nombre exhaustif d’espèces de l’écosystème.
Cas d’usage
Résumer un relevé de terrain
Comptez les libellés uniques de quadrats, transects ou listes répétées tout en conservant le nombre total d’observations.
Comparer des échantillons de suivi
Produisez des valeurs cohérentes de richesse observée pour des sites ou dates étudiés selon le même protocole.
Auditer une chaîne de biodiversité
Examinez la liste distincte afin de repérer les problèmes d’orthographe, de casse ou d’harmonisation taxonomique.
Questions fréquentes
Qu’est-ce que la richesse spécifique ?
C’est le nombre d’espèces distinctes observées dans un échantillon défini, sans tenir compte de leurs abondances relatives.
Les observations répétées augmentent-elles la richesse ?
Non. Elles augmentent total_observations, mais chaque libellé nettoyé distinct n’ajoute qu’une unité à species_richness.
La comparaison tient-elle compte de la casse ?
Non par défaut. Activez case_sensitive lorsque les majuscules doivent différencier les libellés.
Le calculateur résout-il les synonymes ou vérifie-t-il la taxonomie ?
Non. Il compare des libellés nettoyés sans consulter de référentiel taxonomique. Harmonisez auparavant synonymes et orthographes.
Peut-on comparer directement des échantillons de tailles différentes ?
Restez prudent. Les grands échantillons détectent souvent plus d’espèces ; envisagez un effort standardisé, une raréfaction ou une méthode appropriée.
Quel est le prix d’une requête API ?
Chaque requête coûte $0.002. Le même calcul déterministe est aussi disponible gratuitement dans le navigateur.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/bio/species-richness \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Oak\nPine\nOak\nBirch\nPine\nWillow"}'const res = await fetch("https://api.kit.forhosting.com/bio/species-richness", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Oak\nPine\nOak\nBirch\nPine\nWillow"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/bio/species-richness",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Oak\nPine\nOak\nBirch\nPine\nWillow"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/bio/species-richness", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Oak\\nPine\\nOak\\nBirch\\nPine\\nWillow"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Oak\nPine\nOak\nBirch\nPine\nWillow"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/bio/species-richness", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"text": "Oak\nPine\nOak\nBirch\nPine\nWillow"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "bio.species_richness",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_chars | 200000 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |