ForHosting KIT · Outils pour développeurs

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.

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

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.

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.

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.

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/earth/wave-group-velocity

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/earth/wave-group-velocity \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wavelength_m":100,"depth_m":20}'
{
  "wavelength_m": 100,
  "depth_m": 20
}
{
  "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.

par requête$0.002

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

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 →