Calculateur ET0 Hargreaves-Samani
Obtenez l’évapotranspiration de référence à partir des seules températures : une journée de 12 à 28 °C, moyenne de 20 °C, avec un rayonnement de 35 mm/jour donne une ET0 de 12,1716 mm/jour. Ni vent ni humidité requis. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- T min
- 12
- T max
- 28
- T moy
- 20
- Ra
- 35
- Plage de température
- 16 mm/day
- Racine carrée de la plage de température
- 4
- Et0
- 12,1716
- Coefficient
- 0,0023
L'évapotranspiration de référence, notée ET0 ou ETo, estime la demande évaporative de l'atmosphère au-dessus d'une surface de gazon court bien arrosée et constitue le socle des calculs de besoins en eau des cultures, de la planification de l'irrigation et du suivi des sécheresses. L'équation de Hargreaves-Samani est une méthode température-rayonnement qui ne requiert que les températures quotidiennes minimale et maximale, une température moyenne et le rayonnement extraterrestre du site et du jour de l'année—données que les stations météo et les archives climatiques fournissent presque toujours même lorsque la vitesse du vent, l'humidité et le rayonnement net manquent. Ce calculateur d'évapotranspiration de référence Hargreaves applique la forme classique ET0 égale à 0.0023 fois Ra fois (Tmean plus 17.8) fois la racine carrée de (Tmax moins Tmin), avec des températures en Celsius et Ra et ET0 en millimètres par jour d'équivalent en eau.
Ce que mesure l'équation ET0 de Hargreaves–Samani et quand l'utiliser
L'évapotranspiration de référence FAO Penman-Monteith complète exige le rayonnement net, le flux de chaleur du sol, le déficit de pression de vapeur et la vitesse du vent à deux mètres. De nombreux réseaux opérationnels, séries climatiques historiques et jeux de données pédagogiques n'enregistrent que les extrêmes de température et disposent d'un moyen de calculer ou consulter le rayonnement extraterrestre Ra à partir de la latitude et du jour de l'année.
Hargreaves et Samani ont comblé ce manque par un multiplicateur empirique sur Ra qui module la demande avec l'amplitude thermique diurne et avec la chaleur moyenne de la journée. Le terme d'amplitude de température sert de proxy pour la nébulosité et l'humidité : les jours clairs et secs présentent souvent un Tmax moins Tmin plus grand et donc un ET0 estimé plus élevé pour le même Ra, tandis que les jours humides ou nuageux compressent l'amplitude.
Le facteur (Tmean plus 17.8) maintient l'estimation positive sous climats frais et accroît la demande évaporative lorsque la température moyenne monte. Le coefficient 0.0023 est la constante Hargreaves-Samani largement publiée lorsque Ra est exprimée dans le même équivalent en eau en millimètres par jour que ET0. Utilisez Hargreaves-Samani lorsque vous avez besoin d'un ET0 transparent piloté par la température pour la planification d'irrigation, des modèles de bilan hydrique ou des contrôles de devoirs et que vous ne disposez pas d'un jeu météo complet.
Préférez Penman-Monteith lorsque les observations de vent, d'humidité et de rayonnement sont fiables et que vous avez besoin de la norme FAO-56 pour des rapports juridiques ou d'ingénierie. Cette capacité n'implémente que l'étape analytique Hargreaves-Samani ; elle ne calcule pas Ra à partir de la latitude ou du jour de l'année, de sorte que vous fournissez Ra déjà convertie en millimètres par jour.
Où la méthode de Hargreaves rend service
Les consultants en irrigation et les logiciels de gestion agricole ont souvent besoin d'une colonne ET0 quotidienne pour des stations qui n'ont jamais enregistré vent ni humidité ; alimenter Hargreaves-Samani depuis des archives de température comble ce manque sans déployer une pile micrométéorologique complète. Les cours d'hydrologie et les générateurs d'examens ont besoin d'un oracle déterministe qui rejette les extrêmes thermiques inversés au lieu de renvoyer silencieusement NaN depuis la racine d'un tableur.
Les carnets de recherche qui retraitent des grilles climatiques du XXe siècle peuvent évaluer ET0 par lots lorsque seuls des extrêmes mensuels ou quotidiens de température et un Ra astronomique sont disponibles. Les moniteurs de sécheresse et les tableaux de bilan hydrique exécutent parfois Hargreaves à côté de Penman-Monteith comme contrôle de sensibilité uniquement thermique lorsque des capteurs secondaires tombent.
Cas d’usage
Planification de l'irrigation à partir de stations de température
Calculez l'ET0 quotidien Hargreaves-Samani lorsque seuls Tmin, Tmax, Tmean et le Ra du site sont disponibles, puis multipliez par les coefficients culturaux pour les bilans hydriques.
Archives climatiques et réanalyse de sécheresse
Évaluez par lots l'évapotranspiration de référence à partir d'extrêmes historiques de température et de Ra astronomique pour bilans hydriques ou indices de sécheresse.
Questions fréquentes
Quelles unités utiliser pour les températures et Ra ?
Les températures sont en degrés Celsius. Le rayonnement extraterrestre Ra doit être en millimètres par jour d'équivalent en eau. Convertissez MJ·m⁻²·day⁻¹ avec Ra_mm ≈ 0.408·Ra_MJ avant l'appel.
Que se passe-t-il si la température maximale est inférieure à la minimale ?
Tmax doit être supérieure ou égale à Tmin ; un intervalle thermique négatif n'est pas physique pour cette équation et n'est pas facturé.
Calcule-t-on l'ET0 Penman-Monteith ou Ra à partir de la latitude ?
Non. Cette capacité n'implémente que la formule température-rayonnement Hargreaves-Samani. Vous devez fournir Ra déjà convertie en mm/day ; elle ne remplace pas le Penman-Monteith complet FAO-56.
Comment convertir le rayonnement extraterrestre de mégajoules en millimètres par jour ?
Multipliez la valeur en mégajoules par mètre carré et par jour par 0,408. Vous obtenez l’équivalent en millimètres d’eau par jour attendu par la formule, comme dans les tables de la FAO.
Pourquoi un écart de température plus grand augmente-t-il l’ET0 ?
L’écart entre maximale et minimale du jour remplace les données de nébulosité et d’humidité. Les journées claires et sèches montrent de grands écarts et une demande évaporative plus forte pour un même rayonnement ; les journées humides ou nuageuses le réduisent.
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/evapotranspiration-hargreaves \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"t_min":12,"t_max":28,"t_mean":20,"ra":35}'const res = await fetch("https://api.kit.forhosting.com/earth/evapotranspiration-hargreaves", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"t_min": 12,
"t_max": 28,
"t_mean": 20,
"ra": 35
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/earth/evapotranspiration-hargreaves",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"t_min": 12,
"t_max": 28,
"t_mean": 20,
"ra": 35
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/evapotranspiration-hargreaves", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"t_min":12,"t_max":28,"t_mean":20,"ra":35}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"t_min":12,"t_max":28,"t_mean":20,"ra":35}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/evapotranspiration-hargreaves", 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
{
"t_min": 12,
"t_max": 28,
"t_mean": 20,
"ra": 35
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "earth.evapotranspiration_hargreaves",
"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
Lorsque la température maximale est inférieure à la minimale, la tâche échoue avec invalid_input afin que l'automatisation ne prenne jamais silencieusement la racine d'un intervalle négatif.
Ce que mesure l'équation ET0 de Hargreaves–Samani et quand l'utiliser
Cette convention d'équivalent en eau correspond aux tables FAO : si votre source de Ra est en mégajoules par mètre carré par jour, convertissez d'abord avec Ra_mm approximativement égal à 0.408 fois Ra_MJ avant d'appeler cet endpoint.
Contrat d'entrée, unités, forme de réponse et comportement d'erreur
Exemple : minimum de douze Celsius, maximum de vingt-huit Celsius, moyenne de vingt Celsius et trente-cinq millimètres par jour de Ra donnent un ET0 positif de plusieurs millimètres par jour typique d'une journée chaude de saison de culture aux latitudes moyennes. Gardez les températures en Celsius, convertissez le Ra énergétique en millimètres par jour avant l'appel et figez l'ET0 arrondi dans les tests pour des goldens stables entre runtimes. Envoyez en POST un objet JSON avec quatre nombres finis obligatoires. t_min est la température minimale quotidienne de l'air en degrés Celsius. t_max est la température maximale quotidienne en degrés Celsius et doit être supérieure ou égale à t_min ; si t_max est inférieure à t_min le gestionnaire rejette la requête avec invalid_input en nommant cet échec d'ordre thermique plutôt que d'inventer une racine complexe. t_mean est la température moyenne quotidienne en Celsius—souvent la moyenne arithmétique des extrêmes lorsque seuls ceux-ci sont mesurés, mais acceptée comme champ indépendant afin d'utiliser des moyennes horaires lorsque disponibles. ra est le rayonnement extraterrestre du jour et de la latitude en millimètres par jour d'équivalent en eau ; il doit être non négatif. Chaque champ peut arriver comme nombre JSON ou chaîne numérique ; les valeurs manquantes, vides ou non finies échouent avec invalid_input en nommant le champ. En cas de succès le corps renvoie t_min, t_max, t_mean et ra arrondis ; signale temperature_range comme Tmax moins Tmin et sqrt_temperature_range comme sa racine carrée ; et retourne et0 en millimètres par jour sous unit mm/day. formula et equation reformulent l'identité Hargreaves-Samani pour l'affichage, method vaut hargreaves_samani, coefficient vaut 0.0023 et steps détaille la substitution 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 d'évapotranspiration de référence Hargreaves est utile
Comme l'implémentation est pure parse de niveau A, chaque appel réussi coûte $0.002 sans latence d'IA. Fournissez des températures Celsius cohérentes, un Ra non négatif en millimètres par jour, gardez t_max au moins égal à t_min, figez les sorties arrondies en millimètres dans les tests, et vous obtenez une évapotranspiration de référence Hargreaves-Samani reproductible pour les cours, la documentation et l'automatisation sans expédier une bibliothèque climatique à chaque worker en périphérie.
Cas d'intégration
Oracles pédagogiques et d'examen
Offrez aux étudiants une vérification déterministe de l'ET0 face aux étapes Hargreaves manuelles et rejetez Tmax/Tmin inversés comme invalid_input.
Questions techniques
Comment calculer l'évapotranspiration de référence Hargreaves-Samani ?
Envoyez t_min, t_max et t_mean en °C plus ra en mm/day d'équivalent en eau. L'API renvoie ET0 = 0.0023·Ra·(Tmean+17.8)·√(Tmax−Tmin) en mm/day.
Quel est le coût du calculateur Hargreaves ET0 ?
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.