Calculadora de duración de tránsito exoplanetario

Los valores no positivos del semieje mayor fallan con invalid_input porque no definen una órbita cerrada física para esta fórmula.

Qué significa la duración del tránsito central y qué contiene la respuesta

La duración del tránsito es el tiempo que un planeta permanece delante de su estrella visto por un observador lejano, medido del primer al cuarto contacto cuando se considera la cuerda estelar completa bajo el modelo geométrico simple. En una órbita circular con tránsito perfectamente central el parámetro de impacto es cero, la trayectoria del planeta atraviesa el centro del disco estelar y, si se desprecia el radio del planeta frente a la estrella, el semiángulo de la cuerda se reduce al arcsin de R-star sobre a. Multiplicar ese ángulo por el periodo orbital entre pi recupera la duración completa en la misma unidad de tiempo que el periodo. Esta capacidad toma el periodo en días —la unidad de la mayoría de catálogos de exoplanetas— y multiplica la duración en días por veinticuatro para que el campo principal duration_hours coincida con cómo los observadores citan eventos de júpiter calientes y super-Tierras. La respuesta repite las entradas limpias period, stellar_radius y semi_major_axis, informa radius_over_a para comprobaciones rápidas e incluye duration_days y duration_minutes para hojas que prefieren esas unidades. El campo small_angle_hours muestra la aproximación lineal al sustituir arcsin de x por x, precisa cuando la estrella es mucho menor que la separación orbital. Las cadenas method y formula documentan que la ruta es central_transit con circular_orbit_b0_rp_neglected para que los clientes no confundan esta estimación con un ajuste completo Mandel–Agol de curva de luz. No hay consulta de red a catálogos estelares ni muestreo Monte Carlo de parámetros de impacto: o bien los tres números definen un tránsito central válido y el motor devuelve flotantes deterministas, o la petición falla con invalid_input nombrando la regla geométrica o de positividad incumplida.

Contrato de entrada, unidades y comportamiento ante errores

Los radios solares para R-star y a son habituales cuando convierte a desde unidades astronómicas usando el radio solar en AU; los metros valen igual si ambos campos están en SI. Combine la respuesta con sus propias correcciones de inclinación o radio planetario si su caso científico las necesita; este extremo solo responde la reescritura central, circular y con Rp despreciado. Envíe por POST un cuerpo JSON con tres números finitos obligatorios: period, el periodo orbital en días y estrictamente mayor que cero; stellar_radius, el radio de la estrella anfitriona en la unidad de longitud que usted elija; y semi_major_axis, el semieje mayor orbital en esa misma unidad. Cada campo puede llegar como número JSON o como cadena numérica; campos ausentes, cadenas vacías, NaN e Infinity fallan con invalid_input. La regla de producto que los llamadores deben recordar es que semi_major_axis debe ser positivo: cero y negativos se rechazan con un mensaje claro de que un semieje no positivo no es físico para una geometría de tránsito cerrada, y esos fallos no se facturan. period y stellar_radius también deben ser positivos. Si stellar_radius es mayor o igual que semi_major_axis, la razón R-star sobre a sale del intervalo unitario abierto y el arcsin no está definido para una cuerda central real, de modo que el manejador rechaza el caso en lugar de devolver NaN. Ejemplo: period igual a tres punto cinco días, stellar_radius igual a uno y semi_major_axis igual a diez produce radius_over_a igual a cero punto uno y una duración de aproximadamente dos punto seis ocho horas, con la referencia de ángulo pequeño un poco más corta como se espera.

Dónde una API de duración de tránsito exoplanetario aporta valor

Como la implementación es parse pura de nivel A, cada llamada con éxito cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente.