系外惑星トランジット時間計算

軌道長半径が正でない場合は invalid_input で失敗します。この式では物理的な閉軌道を定義できないためです。

中心食トランジット時間の意味と応答の内容

トランジット時間とは、遠方の観測者から見て惑星が主星の前にいる時間であり、単純な幾何モデルで恒星弦全体を考えるときの第一接触から第四接触までを測ります。円軌道で完全な中心食のとき衝突パラメータは零で、惑星の経路は恒星円盤の中心を通り、惑星半径を恒星に対して無視すると半弦角は R-star を a で割った arcsin に帰着します。その角に公転周期を π で割った値を掛けると、周期と同じ時間単位での全所要時間が得られます。恒星カタログへのネットワーク照会も衝突パラメータのモンテカルロ抽選もありません。本機能は系外惑星カタログの大半で使われる日を周期の単位として受け取り、日単位の所要時間に二十四を掛けて主フィールド duration_hours がホットジュピターやスーパーアースのイベントを観測者が時間で引用する慣行と一致するようにします。応答は清掃済み入力 period、stellar_radius、semi_major_axis を返し、簡易チェック用に radius_over_a を示し、それらの単位を好むワークシート向けに duration_days と duration_minutes も含みます。small_angle_hours フィールドは x の arcsin を x 自身に置き換えた線形近似を示し、恒星が軌道間隔よりはるかに小さいときに正確です。method と formula の文字列は経路が circular_orbit_b0_rp_neglected の central_transit であることを記録し、クライアントがこの見積もりを完全な Mandel–Agol 光度曲線フィットと混同しないようにします。三つの数値が有効な中心食を定義すればエンジンは決定論的な浮動小数を返し、そうでなければ破られた幾何または正値性の規則を示す invalid_input で失敗します。

入力契約、単位、エラー時の振る舞い

AU の太陽半径を使って a を天文単位から換算するときは R-star と a の両方に太陽半径を用いるのが一般的です。零と負は、正でない軌道長半径が閉じたトランジット幾何として非物理であるという明確なメッセージで拒否され、課金されません。科学的な事情で傾斜や惑星半径の補正が必要ならご自身で組み合わせてください。必須の有限数三つを含む JSON 本体を POST してください。period は日単位の公転周期で厳密に零より大きく、stellar_radius は選んだ任意の長さ単位での主星半径、semi_major_axis は同じ長さ単位での軌道長半径です。両フィールドが SI ならメートルでも同様に機能します。各フィールドは JSON の数でも数値文字列でもよく、欠落・空文字・NaN・Infinity は invalid_input で失敗します。呼び出し側が覚える製品規則は semi_major_axis が正でなければならないことです。period と stellar_radius も正でなければなりません。stellar_radius が semi_major_axis 以上だと R-star 対 a の比が開いた単位区間を離れ、実の中心弦では arcsin が定義されないため、ハンドラは NaN を返す代わりに拒否します。例：period が三点五日、stellar_radius が一、semi_major_axis が十のとき radius_over_a は零点一となり、所要時間はおよそ二点六八時間で、小角参照は期待どおりわずかに短くなります。このエンドポイントは中心・円軌道・Rp 無視の書き換えのみに答えます。

系外惑星トランジット時間 API が役立つ場面

ソフトウェア開発者は決定論的な duration_hours で単体テストとプロパティ検査を用意し、誰かが誤って arcsin を線形係数に差し替えたときに CI が失敗するようにします。実装は純粋な parse のティア A のため、成功した呼び出しは公開の基本価格 $0.002 のみで、モデルトークンも外向きネットワークも使いません。