randomtrade_canonical_entropy_save.py ドキュメント

概要

randomtrade_canonical_entropy_save.py は、統計力学の小正準集団(ミクロカノニカルアンサンブル)のアナロジーを用いた閉じた資産交換模型のシミュレーションプログラムです。 全体系を人数の少ない系 A(小さい部分系)と人数の多い系 B(大きい熱浴)に分割し、各人が持つ資産をランダムに交換する過程を追跡します。 シミュレーションの進行に伴う平均資産、シャノンエントロピー、および状態数から求めた小正準エントロピーの推移を計算し、グラフや資産分布のアニメーションとして可視化します。

理論と計算アルゴリズム

経験分布のシャノンエントロピー

ある時点における系内の資産値 \(m\) の経験分布(確率分布)を \(p(m)\) としたとき、シャノンエントロピー \(H\) は以下の式で計算されます。

\[H = - \sum_m p(m) \log p(m)\]

この値は系 A、系 B、および全体系それぞれについて計算され、分布の広がり具合を評価する指標として利用されます。整数の資産値をそのまま集計しているため、ヒストグラムのビン分割による見かけ上のエントロピー変化は発生しません。

状態数と小正準エントロピー

非負整数の総資産 \(M\) を \(N\) 人の構成員に分配する微視的状態数 \(\Omega_N(M)\) は、重複組合せの考え方に基づき以下の式で表されます。

\[\Omega_N(M) = \frac{(M+N-1)!}{M!(N-1)!}\]

この状態数から、ボルツマンの原理に基づいて小正準エントロピー \(S\) を計算します(プログラム内では無次元化された \(S/k_{\mathrm{B}}\) として扱われます)。

\[\frac{S}{k_{\mathrm{B}}} = \log \Omega_N(M)\]

プログラムの実装においては、階乗計算時のオーバーフローを回避するため、ガンマ関数の自然対数 \(\log \Gamma(x)\) を利用して次のように算出しています。

\[\log \Omega_N(M) = \log \Gamma(M+N) - \log \Gamma(M+1) - \log \Gamma(N)\]

ランダム資産交換プロセス

全体系の総人数 \(N_{\mathrm{total}} = N_A + N_B\) に対し、資産の交換を以下の手順で進行させます。

  1. 全体系の中からランダムに贈与者と受容者をそれぞれ 1 名ずつ選定します。

  2. 贈与者と受容者が同一人物である場合、または贈与者の所持資産が 1 回の交換額 \(V_{\mathrm{trade}}\) に満たない場合は、交換を行わずスキップします。

  3. 条件を満たした場合、贈与者の資産から \(V_{\mathrm{trade}}\) を減算し、受容者の資産に \(V_{\mathrm{trade}}\) を加算します。

  4. この 1 回の交換試行を \(N_{\mathrm{total}}\) 回繰り返すプロセスを「 1 スイープ」と定義し、指定されたスイープ数に到達するまで反復します。

入出力仕様

必要な非標準ライブラリ

本プログラムを実行するためには、以下の外部ライブラリが必要です。

  • matplotlib

  • numpy

  • pillow (GIF アニメーションの保存時のみ必要)

CLIオプション

本プログラムはコマンドライン引数(CLIオプション)からパラメータを受け取ります。

  • --na : 系 A の人数

  • --nb : 系 B の人数

  • --ma0 : 系 A の一人あたりの初期資産

  • --mb0 : 系 B の一人あたりの初期資産

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

  • --niter : シミュレーションを実行するスイープ回数

  • --record-every : 指標を記録する間隔(スイープ数)

  • --animation-every : アニメーション用の分布データを記録する間隔(スイープ数)

  • --animation-interval : アニメーション描画時のフレーム間隔(ミリ秒)

  • --bin-width : アニメーション表示用の資産分布ヒストグラムのビン幅

  • --seed : 乱数シード(シミュレーションの再現用)

  • --save-png : 時系列グラフを保存する PNG ファイルの出力先パス

  • --save-gif : 資産分布アニメーションを保存する GIF ファイルの出力先パス

  • --gif-fps : GIF 保存時のフレームレート設定

  • --dpi : 画像保存時の解像度

  • --no-show : 描画ウィンドウを画面に表示しない場合に指定

出力仕様

  • 標準出力 : シミュレーション開始時および終了時のシャノンエントロピー値の出力、画像保存時の進行状況メッセージ。

  • 画面表示 : --no-show が指定されていない場合、各種指標の推移グラフとヒストグラムアニメーションをウィンドウに表示します。

  • ファイル出力 : --save-png または --save-gif を指定した場合、シミュレーション結果を画像ファイルとして指定されたパスに保存します(保存先のディレクトリが存在しない場合は自動的に作成されます)。

実行例

以下は、系 A を 50 人、系 B を 500 人とし、シミュレーションを 5000 スイープ実行して結果をファイルに保存する例です。描画ウィンドウは表示せずバックグラウンドで処理を完結させます。

python randomtrade_canonical_entropy_save.py \
    --na 50 \
    --nb 500 \
    --ma0 100 \
    --mb0 50 \
    --niter 5000 \
    --seed 1234 \
    --save-png output/timeseries.png \
    --save-gif output/distribution.gif \
    --no-show