trajectories.py ドキュメント

概要

本プログラムは、1次元における複数粒子の分子動力学(MD)シミュレーションを実行し、その時間発展や位相空間上の軌跡をアニメーションとして出力するスクリプトです。粒子の運動方程式は速度Verlet法を用いて数値積分されます。

理論的背景とアルゴリズム

本シミュレーションでは、質量 \(m = 1\) の粒子群に対して、調和振動子(フックの法則に従う復元力)に相当する力が働く系を想定しています。

各粒子に働く力 \(F(x_i)\) は、以下の式で定義されます。

\[F(x_i) = -0.2 x_i + f_{ij}(x_i, \{x\})\]

ここで \(x_i\) は対象粒子の位置を表し、第2項の \(f_{ij}\) は粒子間の相互作用を示します。プログラムのデフォルト実装では \(f_{ij} = 0.0\) と定義されているため、各粒子は相互作用を持たない独立した調和振動子として振る舞います。

時間発展の計算には速度Verlet法が用いられます。時間刻みを \(\Delta t\) としたとき、位置 \(x\) と速度 \(v\) は次のように更新されます。

\[x(t + \Delta t) = x(t) + v(t)\Delta t + \frac{1}{2} F(x(t)) \Delta t^2\]
\[v(t + \Delta t) = v(t) + \frac{1}{2} [F(x(t)) + F(x(t + \Delta t))] \Delta t\]

質量 \(m = 1\) の系であるため、プログラム内では速度 \(v\) をそのまま運動量 \(p\) として扱っています。

依存ライブラリ

本プログラムでは、非標準ライブラリとして以下を使用しています。

  • numpy

  • matplotlib

入出力仕様

  • 入力 外部ファイルからのデータ読み込みはありません。初期位置 \(x\) および初期速度 \(v\) は、コマンドライン引数で指定された乱数シードに基づく正規分布から自動的に生成されます。

  • 出力 シミュレーション結果は、実行モードに応じてGIF形式のアニメーションファイルとして保存されます。

    • md モード: md_simulation.gif

    • trajectory モード: trajectory.gif

CLIオプション

コマンドラインから以下の引数を指定して、シミュレーション条件を変更可能です。

  • --N : 粒子数(デフォルト: \(5\))

  • --dt : 時間刻み \(\Delta t\)(デフォルト: \(0.05\))

  • --nstep : シミュレーションのステップ数(デフォルト: \(200\))

  • --nplotinterval : グラフを更新(描画)するステップ間隔(デフォルト: \(10\))

  • --tpause : 描画更新時のポーズ時間(デフォルト: \(1.0 \times 10^{-3}\))

  • --seed : 乱数生成器のシード値(デフォルト: \(42\))

  • --mode : シミュレーションモード(デフォルト: md)。以下のいずれかを指定します。

    • md : 時間 \(t\) に対する位置 \(x\) および運動量 \(p\) の推移を描画するモード

    • trajectory : 位相空間上(位置 \(x\) と運動量 \(p\))の軌跡を描画するモード

実行例

md モードでの実行例です。時間発展のアニメーション( md_simulation.gif )が生成されます。

python trajectories.py --mode md --N 10 --nstep 300

trajectory モードでの実行例です。位相空間の軌跡を描画したアニメーション( trajectory.gif )が生成されます。

python trajectories.py --mode trajectory --dt 0.01 --seed 123