Calculadora de duração de trânsito de exoplaneta

Valores não positivos do semieixo maior falham com invalid_input porque não definem uma órbita fechada física para esta fórmula.

O que a duração do trânsito central significa e o que a resposta contém

A duração do trânsito é o tempo que um planeta permanece à frente da sua estrela visto por um observador distante, medido do primeiro ao quarto contacto quando se considera a corda estelar completa sob o modelo geométrico simples. Em uma órbita circular com trânsito perfeitamente central o parâmetro de impacto é zero, a trajetória do planeta passa pelo centro do disco estelar e, quando o raio do planeta é desprezado em relação à estrela, o semiângulo da corda reduz-se ao arcsin de R-star sobre a. Multiplicar esse ângulo pelo período orbital sobre pi recupera a duração completa na mesma unidade de tempo do período. Esta capacidade toma o período em dias — a unidade da maioria dos catálogos de exoplanetas — e multiplica a duração em dias por vinte e quatro para que o campo principal duration_hours coincida com a forma como observadores citam eventos de júpiteres quentes e super-Terras. A resposta ecoa as entradas limpas period, stellar_radius e semi_major_axis, reporta radius_over_a para verificações rápidas e inclui duration_days e duration_minutes para planilhas que preferem essas unidades. O campo small_angle_hours mostra a aproximação linear obtida ao substituir arcsin de x por x, precisa quando a estrela é muito menor que a separação orbital. As cadeias method e formula documentam que o caminho é central_transit com circular_orbit_b0_rp_neglected para que os clientes não confundam esta estimativa com um ajuste completo Mandel–Agol de curva de luz. Não há consulta de rede a catálogos estelares nem sorteio Monte Carlo de parâmetros de impacto: ou os três números definem um trânsito central válido e o motor devolve flutuantes determinísticos, ou o pedido falha com invalid_input nomeando a regra geométrica ou de positividade violada.

Contrato de entrada, unidades e comportamento de erro

Raios solares para R-star e a são comuns quando você converte a a partir de unidades astronômicas usando o raio solar em AU; metros funcionam igualmente se ambos os campos estiverem em SI. Envie por POST um corpo JSON com três números finitos obrigatórios: period, o período orbital em dias e estritamente maior que zero; stellar_radius, o raio da estrela hospedeira em qualquer unidade de comprimento que você escolher; e semi_major_axis, o semieixo maior orbital nessa mesma unidade. Cada campo pode chegar como número JSON ou como string numérica; campos ausentes, strings vazias, NaN e Infinity falham com invalid_input. A regra de produto que os chamadores devem lembrar é que semi_major_axis deve ser positivo: zero e negativos são rejeitados com mensagem clara de que um semieixo não positivo não é físico para uma geometria de trânsito fechada, e essas falhas não são cobradas. period e stellar_radius também devem ser positivos. Exemplo: period igual a três ponto cinco dias, stellar_radius igual a um e semi_major_axis igual a dez produz radius_over_a igual a zero ponto um e uma duração de cerca de dois ponto seis oito horas, com a referência de ângulo pequeno um pouco mais curta como esperado. Combine a resposta com as suas próprias correções de inclinação ou raio planetário se o seu caso científico as exigir; este endpoint responde apenas a reescrita central, circular e com Rp desprezado.

Onde uma API de duração de trânsito de exoplaneta agrega valor

Desenvolvedores de software semeiam testes unitários e verificações de propriedades com valores determinísticos de duration_hours para que o CI falhe se alguém trocar arcsin por um fator linear por engano. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo nem rede de saída.