Velocità di gruppo delle onde
Questo calcolatore determina la velocità con cui l’energia e l’inviluppo di un gruppo ristretto di onde si propagano in acqua di profondità finita.
Esegui gratis nel browser
Inserisca lunghezza d’onda e profondità in metri: viene risolta la relazione di dispersione lineare e applicato il fattore di gruppo. Il risultato comprende velocità di gruppo, velocità di fase, frequenza angolare, numero d’onda e profondità relativa. È utile per ingegneria costiera, oceanografia, operazioni marittime e verifiche didattiche quando le approssimazioni per acque basse o profonde non sono sufficientemente accurate.
Che cosa descrive la velocità di gruppo
Le singole creste avanzano alla velocità di fase, mentre un insieme riconoscibile di componenti vicine si muove in genere a una velocità diversa. La velocità di gruppo descrive la propagazione dell’inviluppo e, nella teoria lineare, dell’energia. La distinzione è importante per stimare quando il moto ondoso raggiungerà la costa, confrontare una misura con una previsione o seguire la trasformazione delle onde sulla batimetria. Il calcolo parte dalla lunghezza d’onda ed è quindi comodo per misure ricavate da immagini, modelli spaziali, vasche sperimentali o spettri del numero d’onda. La velocità di fase restituita consente un confronto immediato. In acque molto profonde la velocità di gruppo tende a metà di quella di fase; in acque basse le due convergono, perché le onde lunghe diventano quasi non dispersive. La relazione completa descrive anche il regime intermedio senza richiedere una scelta prematura dell’approssimazione.
Come funziona il calcolo a profondità finita
Il calcolo assume un’onda gravitazionale superficiale progressiva, di piccola ampiezza, su profondità uniforme. Converte la lunghezza L nel numero d’onda k tramite k = 2π/L, quindi risolve ω² = gk tanh(kh), dove ω è la frequenza angolare, g l’accelerazione di gravità e h la profondità. La velocità di fase è ω/k. Quella di gruppo si ottiene moltiplicandola per la metà di 1 + 2kh/sinh(2kh). Il prodotto adimensionale kh, restituito come profondità relativa, indica l’influenza del fondale: valori piccoli corrispondono ad acque basse e valori grandi ad acque profonde. Si usa la gravità standard, salvo che Lei fornisca un altro valore positivo. Non servono iterazioni, perché la lunghezza determina già k. Per profondità relative estreme viene valutato direttamente il limite, evitando che il seno iperbolico superi l’intervallo numerico.
Scelta dei dati e interpretazione
Inserisca lunghezza d’onda e profondità in metri, mantenendo coerente la scala fisica. La profondità è la distanza dalla superficie indisturbata al fondale, non l’altezza d’onda, il pescaggio o una quota rispetto a un riferimento arbitrario. La lunghezza d’onda è la distanza orizzontale fra fasi corrispondenti, normalmente da cresta a cresta. Una profondità nulla o negativa viene rifiutata perché la relazione non definisce una soluzione oceanica; sono rifiutati anche lunghezza o gravità non positive e valori non finiti. Consideri l’uscita una stima della teoria lineare. Correnti forti, elevata ripidità, frangimento, batimetria rapidamente variabile, viscosità, tensione superficiale per onde molto corte e dispersione direzionale possono richiedere modelli più completi. Come controllo, il fattore di gruppo tende a 1 in acque basse e a 0.5 in acque profonde; un valore intermedio è normalmente plausibile.
Casi d'uso
Stimare l’arrivo dell’energia del moto ondoso
Converta lunghezza osservata o modellata e profondità al largo nella velocità di propagazione verso un punto di monitoraggio.
Verificare calcoli di ingegneria costiera
Confronti velocità di gruppo e fase prima di calcolare flusso energetico, shoaling o tempo di percorrenza su un tratto uniforme.
Spiegare la dispersione a profondità finita
Mostri come la profondità relativa kh collochi un’onda fra i limiti delle acque basse e profonde.
Domande frequenti
Quanto costa il calcolo?
Ogni richiesta API costa $0.002. Il calcolo può essere eseguito anche nel browser, poiché usa aritmetica deterministica e nessun servizio di rete.
Perché velocità di gruppo e fase sono diverse?
La velocità di fase segue le creste; quella di gruppo segue l’inviluppo e l’energia. La dispersione determina la differenza.
Che cosa accade con profondità nulla o negativa?
La richiesta restituisce un errore di input, perché la relazione per le onde oceaniche richiede una profondità maggiore di zero.
Quale gravità viene usata automaticamente?
Viene adottata l’accelerazione di gravità standard. Lei può indicare un altro valore positivo per una convenzione o un ambiente diverso.
Sono inclusi correnti o frangimento?
No. Si applica la teoria lineare a profondità uniforme, senza modellare correnti, frangimento, forte non linearità o batimetria variabile.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"wavelength_m": 100,
"depth_m": 20
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "earth.wave_group_velocity",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |