randommoney2.py ドキュメント

概要

外部からのランダムな増減を受ける資産モデルのシミュレーションを行い、その時間発展を可視化するプログラムです。 各個人の資産が、他者との取引ではなく外部要因(独立な一様乱数)によって増減する過程をシミュレートします。 資産分布やシャノンエントロピーの推移を計算し、グラフとして画面表示や画像ファイル(PNG形式やGIFアニメーション形式)へ保存することができます。

必要なライブラリ

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

  • matplotlib

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

理論的背景と数式

本シミュレーションは、各個人の資産が独立したランダムウォークに従うモデルを記述します。 ある時刻 \(t\) における個人 \(i\) の資産を \(m_i^{(t)}\) とします。1回のスイープ(時間ステップ)において、外部要因による資産の変動量 \(\Delta m_i^{(t)}\) は、最大変動幅 \(v\) (プログラム中では vtrade )に対する一様分布から与えられます。

\[\Delta m_i^{(t)} \sim U(-v, v)\]

資産は負にならないという制約(非負条件)があるため、更新規則は次のように下限でクリップされます。

\[m_i^{(t+1)} = \max\left(0, m_i^{(t)} + \Delta m_i^{(t)}\right)\]

この独立なランダム変動の繰り返しにより、全体の資産分布がどのように変化するかを評価します。 分布の偏りや広がりを定量化するため、資産の最大値までの範囲を一定数のビン(区間)に分割し、シャノンエントロピー \(H\) を計算します。各ビン \(j\) に属する確率を \(p_j\) としたとき、エントロピーは以下で定義されます。

\[H = -\sum_{j=1}^{N_{\text{bins}}} p_j \log p_j\]

エントロピーの増大は、資産分布が平滑化し、不確実性が高まっている状態(資産がより均等に分散しているか、広く一様に広がっている状態)を示します。

入出力仕様

プログラムはコマンドライン引数による入力設定を受け取り、結果としてグラフの画面表示、またはファイルへの出力を行います。

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

  • --npersons : シミュレーションの対象となる人数(正の整数)

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

  • --vtrade : 一回の外部変動の最大絶対値(正の実数)

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

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

  • --nbins : 資産分布のヒストグラム計算に使用するビン数(2以上の整数)

  • --interval : GIFのフレーム間隔(ミリ秒単位)

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

  • --seed : 乱数シード(再現性を持たせる場合に指定)

  • --save-png : 最終状態のグラフを保存する画像ファイル名(PNG形式)

  • --save-gif : 時間発展を保存するアニメーションファイル名(GIF形式)

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

  • --no-show : このオプションを指定すると、画面へのグラフ表示を行いません

出力

  • グラフ表示 : 指定されたスイープ数にわたる資産状態(個人ごとの資産、順位別資産、確率密度のヒストグラム)およびエントロピー推移をプロットしたウィンドウが表示されます( --no-show 指定時を除く)。

  • ファイル出力 : --save-png や --save-gif が指定された場合、指定されたファイル名で画像やアニメーションが出力されます。保存先として指定された親ディレクトリが存在しない場合は、自動的に作成されます。

  • 標準出力 : ファイル保存が完了した際、コンソールに保存完了のメッセージ(保存先ファイル名)が出力されます。

実行例

基本的なシミュレーションを実行し、画面にグラフを表示する例です。

python randommoney2.py --npersons 200 --value 100 --vtrade 1 --niter 100000

乱数シードを固定し、最終状態をPNG形式で保存しつつ、画面表示を行わずにバックグラウンドで処理を完了させる例です。

python randommoney2.py --npersons 500 --value 50 --niter 50000 --seed 42 --save-png result.png --no-show

シミュレーションの過程をGIFアニメーションとして記録し、保存する例です。

python randommoney2.py --record-every 500 --save-gif animation.gif