randomtrade_numpy2.py ドキュメント

概要

randomtrade_numpy2.py は、NumPy を用いてランダムな資産交換(Boltzmann ゲーム)をシミュレーションし、その過程における資産分布の変化と Shannon エントロピーの時間発展を可視化する Python スクリプトです。

閉じた経済系において、ランダムに選ばれた個人間で一定額の資産を交換し続けると、最終的な資産分布がどのような平衡状態に至るかを統計力学的な観点から観察することができます。

理論的背景

本シミュレーションは、統計力学における理想気体のエネルギー交換プロセスと数学的なアナロジーを持ちます。総資産(総エネルギー)と総人数(総粒子数)が保存される系において、ランダムな資産交換を繰り返すと、最終的な資産分布は指数分布(Boltzmann 分布)に漸近します。

資産の指数分布

一人あたりの平均資産を \(\mu\) とし、ある個人が資産 \(m\) を持つ確率密度を \(p(m)\) とすると、平衡状態における分布は以下の式で表されます。

\[p(m) = \frac{1}{\mu} \exp\left(-\frac{m}{\mu}\right)\]

プログラム内では、シミュレーションによって得られた資産の確率密度ヒストグラムと、上記の理論的な指数分布関数を重ねて描画し、両者の整合性を視覚的に確認します。

Shannon エントロピー

系が平衡状態に近づく過程を定量的に評価するため、資産分布の粗視化された Shannon エントロピー \(H\) を計算します。状態空間を固定幅のビンで区切り、各ビン \(j\) に属する確率を \(p_j\) としたとき、エントロピーは以下の式で定義されます。

\[H = -\sum_{j} p_j \log p_j\]

ここで、エントロピー \(H\) が最大化される状態が、熱力学的な平衡状態(Boltzmann 分布)に対応します。シミュレーションの進行(スイープ数の増加)に伴い、\(H\) が上昇して一定値に漸近する様子がプロットされます。

必要要件

本プログラムの実行には、以下の非標準ライブラリが必要です。

  • matplotlib

  • numpy

  • Pillow (GIF アニメーションを保存する場合のみ必要)

入出力仕様

入力パラメータ(コマンドライン引数)

動作はコマンドライン引数(argparse)によって制御されます。指定可能なオプションは以下の通りです。

  • --npersons : シミュレーションに参加する人数(既定値: \(200\))

  • --value : 一人当たりの初期資産(既定値: \(50\))

  • --vtrade : 一回の交換額(既定値: \(1\))

  • --niter : スイープ数(既定値: \(10000\))

  • --record-every : 状態を記録する間隔(既定値: \(100\))

  • --nbins : 資産分布ヒストグラムのビン数(既定値: \(21\))

  • --interval : GIF アニメーションのフレーム間隔 \(\mathrm{ms}\) (既定値: \(200\))

  • --gif-fps : GIF の毎秒フレーム数 \(\mathrm{fps}\) (既定値: \(5\))

  • --seed : 乱数シード(再現性のある結果を得る場合に指定)

  • --save-png : 最終状態のグラフを保存する PNG ファイルのパス

  • --save-gif : 時間発展を保存する GIF アニメーションのパス

  • --dpi : 保存画像の解像度 \(\mathrm{dpi}\) (既定値: \(150\))

  • --no-show : 画面へのグラフ描画(GUI ウィンドウ)を無効化

出力仕様

シミュレーションの実行に伴い、画面(または画像ファイル)に以下の 4 つのサブプロットを含むグラフが出力されます。

  1. 個人の資産状態 : 各個人の現在の資産を示す棒グラフ

  2. 資産(昇順) : 資産額でソートされた個人の資産を示す棒グラフ(ローレンツ曲線に相当する形状)

  3. 確率密度 : 資産分布のヒストグラムと理論的な指数分布の比較

  4. Shannon エントロピー : スイープ数に対するエントロピーの推移

また、--save-png や --save-gif を指定した場合は、指定されたパスに親ディレクトリを自動作成(存在しない場合)した上でファイルを出力します。

実行例

初期状態から画面表示のみを行う基本実行例です。

python randomtrade_numpy2.py

人数を \(500\) 人、スイープ数を \(20000\) に増やし、結果を GIF アニメーションとして保存する実行例です。画面表示は無効化しています。

python randomtrade_numpy2.py --npersons 500 --niter 20000 --save-gif output/trade_sim.gif --no-show

最終状態のグラフのみを高解像度(\(300\,\mathrm{dpi}\))で PNG 画像として保存する実行例です。

python randomtrade_numpy2.py --save-png result.png --dpi 300 --no-show