Celeridad de ola en aguas profundas desde el período

Los períodos nulos o no numéricos fallan con invalid_input en lugar de producir un resultado infinito o vacío.

Contrato de entrada, forma de la respuesta y comportamiento ante errores

El período debe ser estrictamente positivo: el cero se rechaza porque c igual a g T entre dos pi sería cero mientras que la frecuencia uno entre T no está definida, y los períodos negativos carecen de sentido físico. Ejemplo: period igual a diez segundos con gravedad por defecto produce una velocidad de fase de unos quince punto seis uno metros por segundo y una longitud de onda de unos ciento cincuenta y seis metros, coherente con c por T. Los valores se redondean a doce decimales para goldens estables entre entornos. La validación fallida no se factura. Envíe un cuerpo JSON con el campo obligatorio period, el período de ola T en segundos entre crestas sucesivas. Se aceptan los alias t, T, period_s y wave_period. El período puede ser un número JSON o una cadena numérica; los valores ausentes, vacíos, no finitos y no numéricos fallan con invalid_input nombrando el campo. La gravedad opcional, g o g_ms2, sustituye el valor por defecto nueve punto ocho cero seis seis cinco metros por segundo al cuadrado; si se proporciona, debe ser un número finito estrictamente positivo. En caso de éxito el cuerpo incluye period y gravity tal como se usaron, phase_speed y celerity como alias idénticos de la velocidad en metros por segundo, wavelength en metros a partir de L igual a g T al cuadrado entre dos pi, frequency en hertz como uno entre T, etiquetas de unidad, cadenas formula y equation para visualización, method deep_water_dispersion y un breve array steps. Combine la respuesta con sus propias comprobaciones de profundidad si necesita decidir si la hipótesis de aguas profundas es válida en un sitio concreto; este endpoint no recibe profundidad y no resuelve la ecuación trascendente de dispersión a profundidad intermedia.

Dónde resulta útil una API de celeridad en aguas profundas

Las plataformas de formación marina usan una calculadora de celeridad de ola en aguas profundas a partir del período para que el alumnado compruebe respuestas de libro sobre períodos de swell sin un modelo de olas completo. Un período o una gravedad no válidos no consumen saldo. Las mesas de previsión y los cuadernos de ingeniería costera convierten los períodos de pico de boyas o modelos en velocidades de grupo y de fase aproximadas para tiempos de viaje y estimaciones de fetch; una API de parseo compacta evita incrustar constantes de gravedad ad hoc y errores de unidades en cada script. Como la implementación es pure parse de nivel A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo ni red externa. Mantenga las peticiones pequeñas, fije phase_speed y wavelength redondeados en las pruebas y obtendrá celeridades de aguas profundas reproducibles para ejercicios, paneles y workers de borde sin levantar un modelo oceánico propio.