randommoney.py ドキュメント

概要

本プログラム randommoney.py は、外部からのランダムな揺らぎによる資金増減の動態をシミュレーションし、その分布の変化を可視化するPythonスクリプトです。各参加者の所持金が毎ステップランダムに増減する一次元ランダムウォークをモデル化しており、所持金が負にならない境界条件(反射壁)を設定することで、最終的な資金分布がどのように変化するかを観察できます。

動作環境と依存ライブラリ

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

  • matplotlib

コードの先頭でインポートされている以下の標準ライブラリを使用しています。

  • sys

  • random

  • math (本プログラムでは exp がインポートされていますが、コード中では使用されていません)

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

本シミュレーションは、参加者間の資金移動(保存系)ではなく、外部からの資金供給・没収(非保存系)を伴うランダムウォークとして定式化されています。

各ステップ \(t\) における参加者 \(j\) の所持金 \(v_j(t)\) は、以下の更新規則に従います。

\[v_j(t+1) = \max(v_j(t) + \Delta v, 0)\]

ここで、\(\Delta v\) は \([-1, 1]\) の範囲で一様分布する確率変数です。

\[\Delta v \sim U(-1, 1)\]

この系は、原点 \(v=0\) に反射壁を持つ一次元ランダムウォークの集合とみなすことができます。通常のランダムウォークであれば、所持金の分散はステップ数 \(t\) に比例して増大し、分布はガウス分布に漸近します。しかし、本モデルでは \(v_j(t) \ge 0\) という境界条件が課されているため、初期所持金が小さい場合やステップ数が極めて大きい場合、原点付近の反射壁の影響により分布が非対称に歪む様子が観察されます。

入出力仕様

入力(コマンドライン引数)

コマンドライン引数として、以下のパラメータを順に指定できます。引数を省略した場合は、コード内で定義されているデフォルト値が使用されます。

  • 第1引数 (npersons): 参加者数(デフォルト: 50)

  • 第2引数 (value): 各参加者の初期所持金(デフォルト: 50.0)

  • 第3引数 (niter): シミュレーションの最大反復ステップ数(デフォルト: 500)

  • 第4引数 (nplotinterval): グラフを更新して描画するステップ間隔(デフォルト: 100)

  • 第5引数 (nfx): 分布関数(ヒストグラム)を計算・描画するための分割数(デフォルト: 21)

出力

シミュレーションの進行状況が matplotlib によるグラフとしてリアルタイムに表示されます。ウィンドウには以下の3つのサブプロットが縦に並んで描画されます。

  • 上段: 各参加者の現在の所持金(参加者インデックス順の棒グラフ)と全体平均値の推移

  • 中段: 現在の所持金を昇順にソートした棒グラフ

  • 下段: 所持金の度数分布(ヒストグラムに基づく折れ線グラフ)

シミュレーション終了時、コンソールに Press ENTER to exit>> と表示され、エンターキーを入力するとプログラムが終了します。

実行例

引数なしで実行すると、使用方法に関するメッセージが出力された後、デフォルト設定でシミュレーションが開始されます。

python randommoney.py

引数を指定して、参加者数を 200 人、初期所持金を 50、反復回数を 10000 回、プロット更新間隔を 100 回、分布の分割数を 21 に設定して実行する例です。

python randommoney.py 200 50 10000 100 21