Calculateur de degrés-jours effectifs
Ne comptez que la chaleur utile aux cultures : avec une base de 10 et un plafond de 30, trois jours à 28/12, 32/18 et 22/8 cumulent 30 degrés-jours effectifs. Les extrêmes hors plage sont d’abord ramenés aux bornes. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Température de base
- 10
- Température limite supérieure
- 30
- Jours par an
- 3
- GDD total
- 30
- GDD moyen
- 10
- GDD minimum
- 6
Les degrés-jours de croissance accumulent la chaleur disponible pour le développement des cultures et des insectes en mesurant à quel point les températures journalières se situent au-dessus d'une base propre à la culture. Lorsque les après-midi dépassent une limite physiologique supérieure, les moyennes brutes surestiment la chaleur utile ; les agronomes appliquent donc un plafond de température au maximum et au minimum journaliers avant de calculer les degrés-jours. Ce calculateur de degrés-jours effectifs accepte une série de paires journalières Tmax et Tmin plus une température de base et un plafond, borne chaque extrême dans cet intervalle fermé et renvoie le GDD effectif par jour et le total selon l'identité classique moyenne des températures bornées moins la base.
Ce que mesurent les degrés-jours effectifs avec un plafond
Les degrés-jours de croissance simples d'une journée s'écrivent souvent comme la moyenne du maximum et du minimum de température de l'air moins un seuil de base, plafonnés à zéro lorsque la moyenne reste au ou sous la base. Cette forme convient par temps doux, mais de nombreuses cultures et ravageurs cessent d'accélérer leur développement lorsque les températures dépassent un seuil supérieur de développement—classiquement environ trente degrés Celsius ou quatre-vingt-six Fahrenheit pour les unités de chaleur du maïs.
Les degrés-jours effectifs ou modifiés forcent donc d'abord les deux extrêmes journaliers dans l'intervalle fermé allant de la base au plafond, prennent la moyenne de ces valeurs bornées et soustraient la base. Comme les deux températures bornées se situent au ou au-dessus de la base, la contribution journalière est toujours non négative et jamais supérieure au plafond moins la base.
Sur une série de plusieurs jours, le GDD effectif total est la somme de ces contributions journalières, et la moyenne par jour est un résumé pratique pour les tableaux de bord. Vous gardez le contrôle total des unités : fournissez chaque température—y compris base et plafond—dans la même échelle, typiquement Celsius en agronomie opérationnelle ou Fahrenheit pour les tables d'extension héritées. Lorsque le plafond est sous la base, l'intervalle s'effondre et le gestionnaire rejette la requête plutôt que d'échanger les bornes en silence ou de renvoyer zéro chaque jour.
Qui utilise les degrés-jours avec plafond
Les modèles de phénologie des cultures et les calendriers de semis ont besoin d'une accumulation de chaleur reproductible qui respecte les seuils base et supérieur de développement lorsque les stations ne publient que le maximum et le minimum journaliers. Les suiveurs de degrés-jours de ravageurs pour vergers et cultures en ligne partagent souvent la même formule de bornage et de moyenne avec bases et plafonds spécifiques à la culture ; un petit point d'accès parse évite de réimplémenter la logique de bornage dans chaque langage qui touche les archives météo.
Les laboratoires d'enseignement et les générateurs d'examens ont besoin d'un oracle déterministe qui rejette les paires max/min inversées et les configurations impossibles de plafond sous la base au lieu de renvoyer silencieusement un NaN de tableur. Les carnets de recherche qui retraitent des extrêmes journaliers historiques peuvent évaluer en lot le GDD effectif pour des études climat-culture sans déployer une boîte à outils complète d'agrométéorologie.
Les sites de contenu qui se positionnent sur calculateur de degrés-jours de croissance effectifs ou GDD avec plafond de température bénéficient d'un outil en direct dont le contrat est documenté en OpenAPI et MCP à partir du même params.json. Gardez le plafond au ou au-dessus de la base, chaque maximum journalier au moins égal à son minimum, figez les totaux arrondis dans les tests, et vous obtenez des degrés-jours de croissance effectifs reproductibles pour cours, documentation et workers en périphérie sans livrer une bibliothèque de phénologie à chaque client.
Cas d’usage
Phénologie des cultures et calendriers de semis
Accumulez le GDD effectif à partir de Tmax/Tmin journaliers avec base et plafond de la culture pour caler stades de croissance et fenêtres de récolte.
Suivi des degrés-jours de ravageurs
Appliquez le même modèle de bornage et de moyenne aux seuils de développement des insectes lorsque seuls les extrêmes journaliers de station sont disponibles.
Laboratoires d'enseignement et tests d'automatisation
Fournissez un oracle déterministe qui rejette un plafond sous la base et des paires max/min inversées pour devoirs, contrôles LMS et goldens de CI.
Questions fréquentes
Comment calcule-t-on les degrés-jours effectifs avec plafond ?
Le GDD effectif total est la somme sur tous les jours.
Que se passe-t-il un jour plus chaud que le plafond ?
La maximale est ramenée au plafond avant la moyenne. Avec une base de 10 et un plafond de 30, une journée à 32 et 18 compte comme 30 et 18, soit une moyenne de 24 et 14 degrés-jours.
Et si la minimale du jour passe sous la base ?
Elle est d’abord relevée à la base. Une journée à 22 et 8 avec une base de 10 compte comme 22 et 10, soit une moyenne de 16 et 6 degrés-jours. Aucune journée n’apporte un montant négatif.
Puis-je saisir des températures en Fahrenheit ?
Oui, à condition que toutes les valeurs utilisent la même échelle : maximales, minimales, base et plafond. Le calculateur ne convertit pas les échelles ; mélanger Celsius et Fahrenheit fausse donc les totaux.
Combien de jours puis-je calculer à la fois ?
De 1 à 366 jours en une seule fois, de quoi couvrir une année bissextile complète de maximales et minimales. La maximale de chaque jour doit être au moins égale à sa minimale, sinon la série est refusée.
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
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/earth/degree-days-effective \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"days":[{"t_max":28,"t_min":12},{"t_max":32,"t_min":18},{"t_max":22,"t_min":8}],"base_temp":10,"upper_temp":30}'const res = await fetch("https://api.kit.forhosting.com/earth/degree-days-effective", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"days": [
{
"t_max": 28,
"t_min": 12
},
{
"t_max": 32,
"t_min": 18
},
{
"t_max": 22,
"t_min": 8
}
],
"base_temp": 10,
"upper_temp": 30
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/earth/degree-days-effective",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"days": [
{
"t_max": 28,
"t_min": 12
},
{
"t_max": 32,
"t_min": 18
},
{
"t_max": 22,
"t_min": 8
}
],
"base_temp": 10,
"upper_temp": 30
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/degree-days-effective", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"days":[{"t_max":28,"t_min":12},{"t_max":32,"t_min":18},{"t_max":22,"t_min":8}],"base_temp":10,"upper_temp":30}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"days":[{"t_max":28,"t_min":12},{"t_max":32,"t_min":18},{"t_max":22,"t_min":8}],"base_temp":10,"upper_temp":30}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/degree-days-effective", 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
{
"days": [
{
"t_max": 28,
"t_min": 12
},
{
"t_max": 32,
"t_min": 18
},
{
"t_max": 22,
"t_min": 8
}
],
"base_temp": 10,
"upper_temp": 30
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "earth.degree_days_effective",
"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.
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
Si le plafond est fixé sous la température de base, la tâche échoue avec invalid_input au lieu d'inventer une fenêtre négative absurde.
Ce que mesurent les degrés-jours effectifs avec un plafond
La capacité traite les nombres comme des températures pures et rapporte les résultats en degree_days sans convertir les échelles.
Contrat d'entrée, forme de la réponse et erreurs
Les chaînes numériques sont converties lorsqu'elles s'interprètent comme décimales finies. Toutes les sorties numériques sont arrondies à douze décimales pour des goldens stables entre runtimes. Exemple : avec base dix et plafond trente, un jour à vingt-huit et douze se borne à vingt-huit et douze, moyenne vingt, GDD dix ; un jour plus chaud à trente-deux et dix-huit borne le maximum à trente et garde dix-huit, moyenne vingt-quatre, GDD quatorze ; un jour plus frais à vingt-deux et huit relève le minimum à dix, moyenne seize, GDD six—total trente degrés-jours sur trois jours. Envoyez en POST un corps JSON avec trois champs obligatoires. days est un tableau non vide d'objets, chacun avec t_max et t_min comme nombres finis, au moins un jour et au plus trois cent soixante-six afin de scorer une année bissextile complète d'extrêmes journaliers en un appel. base_temp est le seuil inférieur de développement ; upper_temp est le plafond appliqué au maximum et au minimum journaliers. Chaque objet jour peut aussi utiliser des alias courants comme tmax, temp_max ou max pour le maximum et tmin, temp_min ou min pour le minimum ; base et upper acceptent des alias comme base, t_base, lower et upper, cutoff, cap_temp. Champs manquants, séries vides, éléments de jour non objets, valeurs non finies, magnitudes au-delà d'un million, tout jour où t_max est strictement inférieur à t_min, et le cas critique upper_temp sous base_temp échouent avec invalid_input en nommant le problème. En succès le corps inclut day_count ; base_temp et upper_temp renvoyés ; total_gdd comme somme des degrés-jours effectifs journaliers ; mean_gdd, min_gdd et max_gdd sur la série ; days_with_positive_gdd ; unit degree_days ; chaînes formula et equation ; un tableau daily renvoyant chaque température brute et effective arrondie, la moyenne effective et le gdd du jour ; et steps pour les interfaces pédagogiques. L'échec de validation n'est pas facturé ; les appels analytiques réussis utilisent le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.
Où une API de GDD effectif avec plafond apporte de la valeur
Comme l'implémentation est parse pure de niveau A, chaque appel réussi coûte $0.002 sans latence d'IA.
Questions techniques
Que se passe-t-il si upper_temp est sous base_temp ?
La tâche échoue avec invalid_input. Le plafond doit être supérieur ou égal à la température de base ; une fenêtre inversée n'est ni échangée ni mise à zéro en silence.
Et si le maximum d'un jour est sous son minimum ?
Toute la requête est rejetée avec invalid_input en nommant l'index du jour. Corrigez la paire inversée avant de recalculer ; l'API ne moyenne jamais une plage négative absurde.
Quelle unité de température faut-il utiliser ?
Toute échelle cohérente—typiquement °C ou °F—pour days, base_temp et upper_temp ensemble. Le calculateur ne convertit pas les unités ; les résultats sont rapportés en degree_days dans cette même échelle.
Combien coûte le calculateur de degrés-jours de croissance effectifs ?
L'outil navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.