ForHosting KIT · Ciencia

Altura significativa del oleaje

Escriba las alturas de un registro y obtenga Hs, la media del tercio más alto: nueve olas encabezadas por 2,4, 2,1 y 1,8 dan una Hs de 2,1 en la misma unidad. Sirve para registros de boyas, obras costeras y prácticas de oceanografía. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto

La altura significativa del oleaje, escrita Hs, es el resumen estándar del estado del mar en predicción marina, ingeniería costera, rutas de buques y diseño offshore. En la definición por olas individuales (cruce por cero), Hs no es la cresta más alta del registro ni la media aritmética de todas las olas: es el promedio del tercio superior de las alturas medidas tras ordenar la serie de mayor a menor. Esa definición coincide con cómo los observadores entrenados estimaban históricamente «la altura de las olas significativas» y sigue siendo la magnitud a la que aluden muchas normas y códigos de diseño al decir altura significativa. Esta calculadora acepta una lista de alturas individuales en cualquier unidad lineal coherente (metros, pies o centímetros), devuelve Hs junto con el tamaño de la muestra, cuántas olas entraron en el promedio del tercio superior y estadísticas de apoyo (máximo, mínimo y media de todas).

Qué significa la altura significativa y cómo se calcula Hs

Parta de una serie temporal de elevación de la superficie e identifique olas individuales sucesivas con un método estándar de cruce por cero, o recoja alturas cresta-valle ya extraídas de un registro de sensor. Obtendrá entonces una lista de N alturas no negativas H1…HN en una sola unidad lineal. Ordene esa lista en sentido descendente de modo que la mayor altura quede primero.

El tercio superior de la muestra son las primeras n alturas, donde n es floor(N dividido entre tres), salvo que cuando N es uno o dos la calculadora usa al menos una altura para que un registro no vacío siempre produzca una Hs definida. La altura significativa es la media aritmética de esas n valores mayores.

Para un registro de nueve olas ordenado como 2.4, 2.1, 1.8, 1.6, 1.5, 1.2, 1.1, 0.9, 0.8, n vale tres y Hs es la media de 2.4, 2.1 y 1.8, es decir 2.1 en la misma unidad. Hs suele ser mayor que la media de todas las olas porque se descartan los dos tercios inferiores antes de promediar. Suele ser menor que la altura máxima única salvo que el tercio superior se reduzca a esa sola cresta.

Las definiciones espectrales de Hs a partir del momento cero del espectro de varianza están estrechamente relacionadas en aguas profundas para mares de banda estrecha, pero esta capacidad implementa solo el promedio temporal por olas individuales: usted aporta las alturas y recibe la media del tercio superior, sin estimación espectral ni batimetría externa.

Para qué sirve calcular la altura significativa

Ingenieros costeros y operadores de marinas postprocesan ráfagas de sensores de presión o acústicos en alturas individuales y necesitan una Hs reproducible para registros, paneles y comprobaciones de diseño sin abrir un paquete oceanográfico completo. Materiales de formación en predicción marina y laboratorios universitarios de oceanografía usan una calculadora en vivo para que los estudiantes verifiquen que la media del tercio superior queda por encima de la media muestral y por debajo de la cresta extrema.

La validación fallida—sobre todo el caso de registro vacío—no consume saldo, así que las comprobaciones de salud con cargas incorrectas siguen siendo baratas.

Postproceso de boyas y sensores

Convierta una lista de alturas de olas por cruce por cero de una ráfaga en una sola Hs para registros, alertas y paneles de vigilancia costera.

Laboratorios de oceanografía y deberes

Permita a los estudiantes contrastar la definición del tercio superior de la altura significativa con cálculos manuales sobre registros cortos.

Operaciones marinas y diseño

Alimente scripts con alturas individuales medidas que necesitan una Hs reproducible sin un modelo espectral completo del oleaje.

¿Cómo se calcula la altura significativa Hs a partir de un registro?

Ordene la lista no vacía de alturas individuales de mayor a menor, tome los floor(N/3) valores más altos (al menos uno) y promedie. Ese promedio es Hs en la misma unidad que las alturas de entrada.

¿Pueden ser negativas las alturas de ola?

No. Cada altura debe ser un número finito no negativo.

¿Es lo mismo que el Hm0 espectral?

No. Esta herramienta implementa la definición temporal por olas individuales (media del tercio superior). El Hm0 espectral del espectro de varianza está relacionado pero se calcula de otro modo y no se estima aquí.

¿Por qué la altura significativa es mayor que la ola media?

Porque antes de promediar se descartan los dos tercios más bajos del registro. En el ejemplo de nueve olas, la media de todas queda por debajo de 1,5, mientras que Hs, la media de las tres mayores, es 2,1.

¿Tengo que pasar las alturas de ola a metros antes?

No. Puede usar metros, pies o centímetros, siempre que todas las alturas de la lista estén en la misma unidad. El resultado sale en esa misma unidad, sin ninguna conversión.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/earth/significant-wave-height

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/earth/significant-wave-height \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wave_heights":[0.8,1.2,1.5,0.9,2.1,1.8,1.1,2.4,1.6]}'
{
  "wave_heights": [
    0.8,
    1.2,
    1.5,
    0.9,
    2.1,
    1.8,
    1.1,
    2.4,
    1.6
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "earth.significant_wave_height",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Un registro vacío falla con invalid_input en lugar de inventar una altura.

Contrato de entrada, campos de respuesta y errores

Las unidades no se convierten: si usted envía metros obtiene metros; si envía pies obtiene pies. No mezcle unidades en una misma lista. Combine la salida con sus propios gráficos o herramientas espectrales si necesita Hm0, periodo de pico o espectros direccionales: este extremo solo responde al promedio clásico de Hs a partir del registro. Envíe por POST un cuerpo JSON con un campo obligatorio, wave_heights: un array no vacío de números finitos no negativos (se aceptan los alias heights, waves, H y values). Cada entrada puede ser un número JSON o una cadena numérica; el formulario de texto libre también admite una lista separada por comas o espacios. Arrays vacíos, campos ausentes, tokens no numéricos y alturas negativas fallan con invalid_input y no se facturan. Hay un tope duro de cien mil valores por llamada para que un pegado descontrolado no monopolice un worker. En el éxito la respuesta incluye wave_count (N), highest_third_count (n usado en el promedio de Hs), significant_wave_height (Hs redondeada a doce decimales para goldens estables), max_height y min_height de toda la muestra, mean_all sobre cada altura, y una cadena breve de fórmula que reafirma la regla. Como la implementación es parse puro de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente.

Dónde una API de altura significativa aporta valor

Scripts de operaciones marítimas y offshore que ya almacenan alturas de cruce por cero pueden llamar a una API pequeña en lugar de reimplementar la lógica de ordenar y recortar en cada lenguaje.

¿Qué ocurre si la muestra de alturas de ola está vacía?

La tarea falla con invalid_input. La altura significativa no está definida para un registro vacío, así que la API no inventa una altura y la llamada no se factura.

¿Cuánto cuesta la calculadora de altura significativa del oleaje?

La herramienta del navegador es gratuita. Las peticiones API usan saldo prepago KIT a $0.002 por llamada exitosa; la entrada inválida no se factura.

Ver la documentación completa del KIT →