ForHosting KIT · Sciences

Calculateur de surface terrière

Transformez une liste de diamètres en surface terrière : trois arbres d'échantillon de 30 cm de diamètre moyen à 400 tiges par hectare donnent environ 30,37 mètres carrés par hectare. Le calcul passe par le diamètre quadratique moyen, l'estimateur usuel en sylviculture. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Diamètres: 20, 30, 40
Nombre par hectare: 400

Vous obtenez

Taille de l'échantillon: 3
DHP moyen (cm): 30
DHP quadratique moyen (cm): 31,0912635103
Surface terrière moyenne par arbre (m2): 0,0759218225

La surface terrière est l'aire de la section des tiges à hauteur de poitrine, exprimée pour un peuplement en mètres carrés par hectare. Les équipes d'inventaire, les sylviculteurs et les étudiants en forêts s'en servent pour décrire le peuplement, planifier les éclaircies et comparer des placettes au nombre de tiges différent. Ce calculateur de surface terrière accepte une liste de diamètres à hauteur de poitrine en centimètres et un nombre de tiges à l'hectare, puis renvoie la surface terrière du peuplement G par l'identité du diamètre quadratique moyen : G égale pi sur quarante mille fois Dq au carré fois N.

Ce que mesure la surface terrière et comment Dq entre dans la formule

La surface terrière d'un arbre est l'aire de la section de sa tige à hauteur de poitrine, classiquement 1.3 mètres au-dessus du sol dans les inventaires métriques. Traitez la section comme un cercle dont le diamètre est le DHP relevé : l'aire individuelle g vaut pi fois le carré de d sur deux cents lorsque d est en centimètres et g en mètres carrés, car diviser les centimètres par cent convertit en mètres et diviser par deux convertit le diamètre en rayon. Un peuplement, ce sont de nombreuses tiges.

Les forestiers les résument en surface terrière G en mètres carrés par hectare, somme de ces aires circulaires ramenée à un hectare de sol. Lorsque vous disposez d'un échantillon de diamètres et d'une densité connue N en tiges par hectare, l'estimateur usuel emploie le diamètre quadratique moyen Dq, défini comme la racine carrée de la moyenne des diamètres au carré ; alors G vaut pi sur quarante mille fois Dq au carré fois N.

Cette identité est exactement N fois la moyenne arithmétique des aires individuelles, si bien qu'un peuplement de quatre cents tiges à l'hectare dont les DHP d'échantillon valent vingt, trente et quarante centimètres a la même G que quatre cents fois la moyenne des trois aires circulaires.

Le DHP moyen arithmétique est renvoyé pour l'interprétation, mais ne doit pas remplacer Dq dans la formule du peuplement : la moyenne des carrés n'est pas le carré de la moyenne, et substituer la moyenne arithmétique sous-estime la surface terrière dès que les diamètres varient. Ce calculateur n'implémente que cette identité forestière SI : pas de volume de tige, pas d'expansion de biomasse et pas de coefficient de forme.

Où la surface terrière sert concrètement

Les logiciels d'inventaire et les carnets forestiers appellent un calculateur de surface terrière pour que les équipes transforment un échantillon au ruban ou au compas en G sans recalculer le facteur centimètres vers mètres sur chaque fiche de placette. Les prescriptions d'éclaircie s'écrivent souvent comme une surface terrière résiduelle cible en mètres carrés par hectare ; comparer la G actuelle à cette cible est le premier pas arithmétique avant de marquer les arbres à extraire.

Les travaux pratiques de sylviculture utilisent de courtes listes de diamètres synthétiques pour que les étudiants voient pourquoi la moyenne quadratique dépasse la moyenne arithmétique et pourquoi substituer la moyenne arithmétique sous-estime le peuplement sur une placette irrégulière. Une validation en échec ne consomme pas de solde. Gardez les requêtes petites, figez le chiffre arrondi de mètres carrés par hectare dans l'intégration continue, et vous obtenez des métriques de peuplement reproductibles pour greffons LMS, workers de bordure et tableurs, sans dresser un système d'information forestière à vous.

Le calculateur ne convertit pas les pouces en centimètres ni les pieds carrés par acre en mètres carrés par hectare : envoyez des entrées SI et lisez des sorties SI afin que les erreurs d'unité restent visibles au lieu d'être masquées par une conversion silencieuse.

Cas d’usage

Contrôle de l'objectif d'éclaircie

Calculez la G actuelle du peuplement à partir des diamètres et de la densité récents, puis comparez-la à un résiduel prescrit tel que 18 ou 22 m²/ha avant de marquer les arbres.

Travaux pratiques de sylviculture

Donnez aux étudiants un court échantillon de diamètres mixtes et laissez-les vérifier à la main que G utilise la moyenne quadratique du DHP, non la moyenne arithmétique.

Questions fréquentes

Comment calcule-t-on la surface terrière à partir du DHP ?

Chaque diamètre d en centimètres a une aire d'arbre g = π (d/200)² m². La G du peuplement en m²/ha vaut N fois la moyenne de ces aires, ou de façon équivalente G = (π/40000) × Dq² × N, Dq étant le DHP quadratique moyen.

Quelles unités pour les diamètres et le résultat ?

Le calculateur ne convertit ni les pouces ni les ft²/acre.

Que se passe-t-il si un diamètre est nul ou négatif ?

Chaque diamètre doit être un nombre fini strictement positif. Zéro, négatifs, NaN et jetons non numériques sont rejetés et ne sont pas facturés.

Pourquoi le DHP quadratique moyen plutôt que la moyenne arithmétique ?

La surface terrière dépend de d au carré. La moyenne des carrés n'est pas le carré de la moyenne, donc utiliser le DHP moyen arithmétique sous-estime G dès que les diamètres varient. La réponse signale tout de même les deux moyennes.

Que signifie une surface terrière de 30,37 m²/ha ?

Cela signifie que les sections des troncs à hauteur de poitrine totalisent 30,37 mètres carrés par hectare de terrain. C'est le résultat pour trois arbres d'échantillon de 30 cm de diamètre moyen avec 400 tiges par hectare.

Outils associés

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

POSThttps://api.kit.forhosting.com/bio/basal-area

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/basal-area \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"diameters":[20,30,40],"count_per_hectare":400}'

const res = await fetch("https://api.kit.forhosting.com/bio/basal-area", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "diameters": [
      20,
      30,
      40
    ],
    "count_per_hectare": 400
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/bio/basal-area",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "diameters": [
        20,
        30,
        40
    ],
    "count_per_hectare": 400
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/bio/basal-area", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"diameters":[20,30,40],"count_per_hectare":400}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"diameters":[20,30,40],"count_per_hectare":400}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/bio/basal-area", 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

{
  "diameters": [
    20,
    30,
    40
  ],
  "count_per_hectare": 400
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "bio.basal_area",
  "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

par requête$0.002

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

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.

Notes techniques

Tout diamètre qui n'est pas un nombre fini strictement positif échoue avec invalid_input, de sorte qu'un DHP nul, négatif ou non numérique ne devient jamais en silence un peuplement vide.

Contrat d'entrée, champs de réponse et comportement de validation

Au plus dix mille diamètres sont autorisés afin qu'un isolate du worker ne soit pas inondé par un fichier d'inventaire sans borne. Exemple : diamètres de vingt, trente et quarante centimètres avec quatre cents tiges à l'hectare donnent G d'environ 30.37 mètres carrés par hectare. Les clés de sortie facultatives sont omises plutôt qu'envoyées à null. Associez le chiffre à vos propres cartes ou équations de cubage si vous avez besoin de biomasse ; ce point de terminaison calcule uniquement la surface terrière du peuplement. Envoyez par POST un objet JSON à deux champs obligatoires. diameters est une liste non vide de diamètres à hauteur de poitrine en centimètres ; chaque valeur doit être un nombre fini strictement positif. Vous pouvez envoyer un tableau JSON de nombres ou une chaîne séparée par des virgules, des espaces ou des points-virgules, que le gestionnaire découpe de la même façon. Un diamètre numérique unique est accepté et traité comme un échantillon d'un arbre, manière habituelle d'entrer un DHP quadratique moyen déjà calculé pour un peuplement homogène. count_per_hectare est la densité du peuplement N en tiges par hectare et doit aussi être un nombre fini strictement positif ; des alias tels que stems_per_hectare, trees_per_hectare, n_ha et density sont acceptés. Champs manquants, listes vides, jetons non numériques, zéro, valeurs négatives, NaN et Infinity échouent avec invalid_input en nommant le champ et, pour un élément fautif, l'indice basé à zéro ; ces échecs ne sont pas facturés. En cas de succès le corps renvoie les diameters nettoyés et count_per_hectare, signale sample_size, mean_dbh_cm et quadratic_mean_dbh_cm, donne mean_tree_basal_area_m2 comme aire circulaire moyenne individuelle, et renvoie basal_area_m2_ha comme résultat G du peuplement, avec une chaîne de formule et une étiquette de méthode.

Où une API de surface terrière de peuplement prouve son utilité

Comme l'implémentation est parse pure de niveau A, chaque appel réussi coûte le tarif de base publié $0.002 sans jetons de modèle et sans réseau sortant.

Cas d'intégration

De l'inventaire de placette au peuplement

Saisissez la liste de DHP mesurés sur une placette de surface fixe plus le nombre de tiges expansé à l'hectare et consignez basal_area_m2_ha à côté de la composition spécifique sur la fiche d'inventaire.

Questions techniques

Combien coûte le calculateur de surface terrière ?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement