randommoney2.py ドキュメント
概要
外部からのランダムな増減を受ける資産モデルのシミュレーションを行い、その時間発展を可視化するプログラムです。 各個人の資産が、他者との取引ではなく外部要因(独立な一様乱数)によって増減する過程をシミュレートします。 資産分布やシャノンエントロピーの推移を計算し、グラフとして画面表示や画像ファイル(PNG形式やGIFアニメーション形式)へ保存することができます。
必要なライブラリ
本プログラムは標準ライブラリのほか、以下の非標準ライブラリを使用します。
matplotlibPillow(GIFアニメーションを保存する場合に必須)
理論的背景と数式
本シミュレーションは、各個人の資産が独立したランダムウォークに従うモデルを記述します。
ある時刻 \(t\) における個人 \(i\) の資産を \(m_i^{(t)}\) とします。1回のスイープ(時間ステップ)において、外部要因による資産の変動量 \(\Delta m_i^{(t)}\) は、最大変動幅 \(v\) (プログラム中では vtrade )に対する一様分布から与えられます。
資産は負にならないという制約(非負条件)があるため、更新規則は次のように下限でクリップされます。
この独立なランダム変動の繰り返しにより、全体の資産分布がどのように変化するかを評価します。 分布の偏りや広がりを定量化するため、資産の最大値までの範囲を一定数のビン(区間)に分割し、シャノンエントロピー \(H\) を計算します。各ビン \(j\) に属する確率を \(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