このコードは誰向けか
教育用サンプル (アルゴリズムを学ぶ人向け)
Python中級者以上向け (修正・拡張を行う人向け)
研究室内の個人用解析コード向け (プロトタイプを再利用する人向け)
CLIツール (手軽にパラメータを振って実行したい人向け)
公開ライブラリ利用者向けではない
数値積分手法の違いによるエネルギーや角運動量の保存性を比較するという目的に特化しており、シミュレーションの内部実装を読む人や、新たな積分スキームを追加・検証する人に適した構造となっています。
コードの長所
モジュール化と拡張性: 積分手法(
step_euler,step_rk4など)が個別の関数として分離されており、STEPPERS辞書に登録する構造のため、新しいアルゴリズムの追加が容易です。ベクトル化: NumPy配列を活用し、
positionやvelocityの更新、重心系へのシフト (np.average)、全運動エネルギーの計算 (np.sum) などでループを減らしたベクトル演算が適用されています。異常系対策:
acceleration関数内で天体間距離の2乗r2がゼロになった場合にFloatingPointErrorを送出する処理や、mainでのdt <= 0.0等の引数チェックが実装されています。argparseによるCLI設計: 時間刻み (
--dt) やシミュレーション期間 (--years)、出力先 (--output) などをコマンドラインから柔軟に変更できる構造になっています。可視化の構造:
plot_resultsにおいて、軌道、エネルギーの相対誤差、誤差の絶対値(対数スケール)、角運動量誤差が2x2のサブプロットに整理されており、手法間の差異を直感的に比較できる設計です。型アノテーションとコメント: 関数の引数や戻り値に型ヒントが付与されており、充実したdocstringにより各関数の責務が明確化されています。
問題点や制限
メモリ消費:
integrate関数内でnsteps + 1個の全履歴をnp.emptyで一括確保しています。ステップ数が非常に大きくなる条件では、メモリを枯渇させる可能性があります。global state依存: 重力定数
Gがグローバルスコープで定義され、accelerationやtotal_energy関数から暗黙的に参照されています。他の単位系や異なる物理定数を用いた計算へ再利用する際の障壁となります。shape仮定 (2次元特化):
initial_stateにおけるposition = np.zeros((len(names), 2))や、角運動量をz軸周りのスカラーとして計算するangular_momentum_zの実装から、運動が2次元平面にハードコードされています。ハードコードされた依存関係:
plot_results関数内のcolors辞書に手法名が直接記述されています。STEPPERSに新しい手法を追加した際、同時にcolorsにも追加しないとKeyErrorが発生する密結合が存在します。初期条件の制約:
initial_state内で、惑星が常に +x 軸上に配置され +y 方向に初速を持つように決め打ちされており、外部から任意の空間的配置を渡しにくい設計です。
数値計算コードとしての評価
極限条件と特異点:
r2 == 0.0の厳密一致を判定して例外を出す配慮が確認できます。しかし、浮動小数点計算で厳密にゼロになる確率は低いため、天体が極端に接近した場合にはinv_r3 = r2 ** -1.5が巨大な値となり、オーバーフローや極端な軌道の飛び(数値的不安定性)を引き起こす可能性があります(ソフトニングの導入などの対策は含まれていません)。単位系: 冒頭で SI 単位系の
G_SIから、シミュレーション内部で用いる AU, day, 太陽質量 の単位系への変換が明示的に行われており、スケールの調整による桁落ちやオーバーフローを回避する意図が読み取れます。収束性と適応的制御: すべての積分スキームは固定の時間ステップ (
dt) で実行されます。適応的時間刻み(adaptive step size)の仕組みは存在しないため、近接遭遇時などにおける局所的な誤差増大については、実行時の結果検証が必要です。物理モデル依存性: ニュートン力学の万有引力のみに依存したモデルであり、相対論的補正や潮汐力等の追加を考慮したAPIにはなっていません。
アーキテクチャや設計の評価
関数分離とテスト容易性: 微分方程式の右辺 (
rhs,acceleration) と時間進行 (step_euler等) が純粋関数に近い形で分離されており、単体テストを記述しやすい設計です。CLI/API分離: 計算ロジックとCLI解析 (
parse_args,main) が明確に分かれています。モジュールとしてインポートし、integrate関数を直接呼び出す再利用が可能です。API設計: 各
step_*関数が(position, velocity, dt, masses)という統一されたシグネチャを持っており、ポリモーフィズム的に扱える優れたインターフェースとなっています。
優先順位が高い改善点
メモリ消費の抑制:
integrate内で全ステップを保存するのではなく、間引き保存を行う引数(例:save_interval)を追加するか、イテレータを返すジェネレータ関数に分離する。
グローバル変数の排除:
Gをaccelerationやtotal_energyの引数として渡すか、シミュレーション設定を保持するデータクラス(例:SimulationContext)を定義して注入する構造に変更する。
特異点付近の数値安定性向上:
r2 == 0.0の判定を、微小な閾値を用いた判定(例:if r2 < epsilon:)に変更するか、ポテンシャルにソフトニングパラメータ(例:r2 + eps**2)を導入してゼロ除算や発散を防ぐ。
可視化メソッドの密結合解消:
plot_results内のcolors辞書を廃止し、動的にカラーパレットから色を割り当てるか、軌道データ側にメタデータとして描画設定を持たせる。
次元数の汎用化:
initial_state内の配列確保サイズ2を、例えば変数ndimとして定義し、将来的な3次元軌道計算 (ndim=3) への拡張に対応できるようにする。
用途に対する適性のまとめ
本コードは、アルゴリズムの挙動比較や数値積分の教材といった教育用途、および手元でパラメータを変更しながら結果を確認する研究用解析コードのプロトタイプとして非常に適しています。コードベースが整理されており、異なるアルゴリズムの実装・検証が容易です。
一方で、現状は2次元特化・固定の初期配置・グローバルな物理定数・一括のメモリ確保という設計から、そのまま汎用的な公開ライブラリや大規模・長期間の高精度な数値計算として利用するには制約があります。上記の改善点、特にメモリ管理とハードコードされた設定の抽象化を行うことで、より長期的な保守や他プロジェクトでの再利用に耐えうるコードになります。