ForHosting KIT · Outils pour développeurs

Calculateur de richesse spécifique

La richesse spécifique correspond au nombre d’espèces distinctes observées dans un échantillon défini.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/bio/species-richness

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é.

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"}'
{
  "text": "Oak\nPine\nOak\nBirch\nPine\nWillow"
}
{
  "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.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

max_chars200000
HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →