Vitesse de groupe des vagues
Ce calculateur détermine la vitesse à laquelle l’énergie et l’enveloppe d’un groupe étroit de vagues se propagent dans une eau de profondeur finie.
Lancer gratuitement
Indiquez la longueur d’onde et la profondeur en mètres : la relation de dispersion linéaire est résolue, puis le facteur de groupe est appliqué. Le résultat comprend la vitesse de groupe, la vitesse de phase, la pulsation, le nombre d’onde et la profondeur relative. Cet outil convient à l’ingénierie côtière, à l’océanographie, aux opérations maritimes et aux contrôles pédagogiques lorsque les approximations d’eau peu profonde ou profonde manquent de précision.
Ce que décrit la vitesse de groupe
Les crêtes individuelles avancent à la vitesse de phase, tandis qu’un ensemble identifiable de composantes proches se déplace généralement à une autre vitesse. La vitesse de groupe décrit la propagation de l’enveloppe et, dans la théorie linéaire, celle de l’énergie. Cette distinction intervient pour prévoir l’arrivée de la houle sur une côte, confronter une mesure à une prévision ou suivre la transformation des vagues sur la bathymétrie. Le calcul part de la longueur d’onde ; il est donc adapté aux mesures issues d’images, de modèles spatiaux, de bassins d’essai ou de spectres de nombres d’onde. La vitesse de phase fournie facilite la comparaison. En eau très profonde, la vitesse de groupe tend vers la moitié de la vitesse de phase. En eau peu profonde, elles convergent, car les ondes longues deviennent presque non dispersives. La relation complète traite le domaine intermédiaire sans imposer trop tôt une approximation.
Principe du calcul à profondeur finie
Le calcul suppose une onde de gravité progressive de faible amplitude sur une profondeur uniforme. Il convertit d’abord la longueur L en nombre d’onde k avec k = 2π/L, puis résout ω² = gk tanh(kh), où ω désigne la pulsation, g l’accélération de la pesanteur et h la profondeur. La vitesse de phase vaut ω/k. La vitesse de groupe s’obtient en la multipliant par la moitié de 1 + 2kh/sinh(2kh). Le produit sans dimension kh, donné comme profondeur relative, quantifie l’influence du fond : une petite valeur correspond aux eaux peu profondes, une grande valeur aux eaux profondes. La pesanteur standard s’applique sauf si vous fournissez une autre valeur positive. Aucune itération n’est requise puisque la longueur détermine déjà k. Pour une profondeur relative extrême, la limite est évaluée directement afin d’éviter un dépassement du sinus hyperbolique.
Choix des données et lecture du résultat
Saisissez la longueur d’onde et la profondeur en mètres, sur une même échelle physique. La profondeur est la distance entre la surface au repos et le fond, et non la hauteur de vague, le tirant d’eau ou une altitude rapportée à un référentiel arbitraire. La longueur d’onde est la distance horizontale entre deux phases équivalentes, souvent de crête à crête. Une profondeur nulle ou négative est refusée, car la relation ne définit alors aucune solution océanique ; une longueur ou une pesanteur non positive et toute valeur non finie sont également rejetées. Le résultat reste une estimation de théorie linéaire. Courants forts, forte cambrure, déferlement, bathymétrie rapidement variable, viscosité, tension superficielle des très courtes vagues ou étalement directionnel peuvent nécessiter un modèle plus complet. Pour contrôler l’ordre de grandeur, le facteur de groupe tend vers 1 en eau peu profonde et 0.5 en eau profonde.
Cas d’usage
Estimer l’arrivée de l’énergie de la houle
Convertissez une longueur observée ou modélisée et une profondeur au large en vitesse de propagation jusqu’à un point de suivi.
Contrôler un calcul d’ingénierie côtière
Comparez les vitesses de groupe et de phase avant de calculer flux d’énergie, shoaling ou temps de parcours sur un tronçon uniforme.
Enseigner la dispersion à profondeur finie
Montrez comment la profondeur relative kh situe une vague entre les limites d’eau peu profonde et profonde.
Questions fréquentes
Quel est le prix du calcul ?
Chaque requête API coûte $0.002. Le calcul peut aussi s’exécuter dans le navigateur, car il n’emploie qu’une arithmétique déterministe sans service réseau.
Pourquoi les vitesses de groupe et de phase diffèrent-elles ?
La vitesse de phase suit les crêtes ; celle de groupe suit l’enveloppe et l’énergie. La dispersion explique leur différence.
Que se passe-t-il si la profondeur est nulle ou négative ?
La requête renvoie une erreur de saisie, car la relation des vagues océaniques exige une profondeur strictement positive.
Quelle valeur de pesanteur est utilisée par défaut ?
L’accélération standard de la pesanteur est retenue. Vous pouvez fournir une autre valeur positive pour une convention ou un milieu différent.
Les courants et le déferlement sont-ils pris en compte ?
Non. Le calcul applique la théorie linéaire en profondeur uniforme, sans modéliser courants, déferlement, forte non-linéarité ou bathymétrie variable.
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/wave-group-velocity \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"wavelength_m":100,"depth_m":20}'const res = await fetch("https://api.kit.forhosting.com/earth/wave-group-velocity", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"wavelength_m": 100,
"depth_m": 20
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/earth/wave-group-velocity",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"wavelength_m": 100,
"depth_m": 20
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/earth/wave-group-velocity", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"wavelength_m":100,"depth_m":20}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"wavelength_m":100,"depth_m":20}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/wave-group-velocity", 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
{
"wavelength_m": 100,
"depth_m": 20
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "earth.wave_group_velocity",
"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. |