概要

randomtrade_numpy2.py は、ランダムな資産交換シミュレーション(Boltzmann ゲーム)を numpy を用いて実行し、資産分布の時間発展およびその Shannon エントロピーを可視化するプログラムです。本プログラムは統計力学におけるエネルギー交換モデルのアナロジーとして、閉鎖系での資産のやり取りがどのような分布状態に収束するかを視覚的に示します。

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

ランダム資産交換モデル

本シミュレーションでは、総数 \(N\) の個人がそれぞれ一定の初期資産を持ちます。各ステップ(スイープ)において、全員が \(1\) 回ずつ乱数によって選ばれた相手に対して一定の額面を渡します。ただし、所持金が設定された交換額を下回る場合は、手持ちの全額を渡します(資産は負にならない制約を持ちます)。 このプロセスは、理想気体における分子間のランダムなエネルギー交換と数理的に等価なモデルです。

資産分布と指数分布

系全体の総資産が保存され、かつ各個人の資産が \(0\) 以上であるという制約のもとで、ランダムな交換を十分に繰り返すと、個人の資産 \(m\) が従う確率密度関数 \(p(m)\) は Boltzmann 分布(指数分布)に漸近します。一人当たりの平均資産を \(\langle m \rangle\) とすると、理論的な確率密度関数は以下のように表されます。

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

プログラム内では、シミュレーション結果のヒストグラムとともに上記の理論曲線が描画され、分布の収束状況を視覚的に確認できます。

Shannon エントロピー

資産分布の粗視化された状態の乱雑さを評価するため、ヒストグラムの各ビン \(j\) における確率 \(p_j\) を用いて Shannon エントロピー \(H\) を計算します。

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

シミュレーションの進行に伴い、エントロピー \(H\) が時間の経過(スイープ数)とともに上昇し、熱力学的平衡状態に相当する一定値に飽和していく様子がグラフとして描画されます。

動作仕様

処理の流れ

  1. コマンドライン引数で指定された人数と初期資産に基づいて、各個人の資産を numpy 配列で初期化します。

  2. 指定されたスイープ数にわたってランダムな資産交換を実行し、一定間隔で資産分布の状態を記録します。

  3. 全記録に対して Shannon エントロピーを計算します。

  4. matplotlib を用いて以下の \(4\) つのグラフを描画します。

    • 個人の資産グラフ

    • 昇順にソートされた資産グラフ

    • 資産の確率密度ヒストグラムと理論上の指数分布曲線

    • 資産分布の Shannon エントロピーの時間発展グラフ

  5. オプション指定に応じて、最終状態の PNG 画像、または時間発展のアニメーション GIF を保存し、グラフを画面表示します。

依存ライブラリ

本プログラムは以下の非標準ライブラリを使用します。

  • numpy

  • matplotlib

また、GIF 保存機能を使用する場合は pillow が実行環境にインストールされている必要があります。

入出力仕様

コマンドライン引数

プログラムの動作条件や保存形式は、以下のコマンドライン引数で制御します。

  • --npersons : シミュレーションの人数 (正の整数)

  • --value : 一人当たりの初期資産 (非負の整数)

  • --vtrade : 一回の交換額 (正の整数)

  • --niter : 総スイープ数 (非負の整数)

  • --record-every : 状態を記録する間隔のスイープ数 (正の整数)

  • --nbins : 資産分布ヒストグラムのビン数 (\(2\) 以上の整数)

  • --interval : GIF のフレーム間隔 (\(ms\) 単位)

  • --gif-fps : GIF の毎秒フレーム数

  • --seed : 乱数生成器のシード値

  • --save-png : 最終状態のプロットを保存する PNG ファイルのパス

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

  • --dpi : 保存される画像の解像度 (dpi)

  • --no-show : グラフの画面表示を無効化するフラグ

入力データファイルなどの読み込み機能は実装されていません。出力は画面へのプロット表示、および指定されたパスへの画像ファイルの保存となります。

実行例

シミュレーションを既定の設定で実行し、結果を画面に表示する基本的なコマンドです。

python randomtrade_numpy2.py

人数を \(500\) 人、スイープ数を \(20000\) 回に変更し、結果を画面に表示せずに最終状態を result.png に保存する実行例です。

python randomtrade_numpy2.py --npersons 500 --niter 20000 --save-png result.png --no-show

シード値を固定し、時間発展のアニメーションを animation.gif として出力する実行例です。

python randomtrade_numpy2.py --seed 42 --save-gif animation.gif --no-show