randomtrade_numpy2 プログラム仕様

概要:

NumPy を用いたランダム資産交換シミュレーションと可視化を行います。

詳細説明:

資産分布と、その粗視化分布の Shannon エントロピーを可視化します。 Boltzmann ゲームの振る舞いを確認できます。

randomtrade_numpy2.draw_state(axes, frame_index, frames, entropy_history, args, hist_max)[ソース]
概要:

指定されたフレームのシミュレーション状態をグラフに描画します。

詳細説明:

4つのサブプロットに対し、資産の分布やエントロピーの時間変化を描画します。

引数:
param axes:

描画対象のAxesオブジェクトの配列。

type axes:

numpy.ndarray

param frame_index:

描画するフレームのインデックス。

type frame_index:

int

param frames:

全フレームのデータを格納したリスト。

type frames:

list

param entropy_history:

エントロピーの履歴を格納したリスト。

type entropy_history:

list

param args:

コマンドライン引数を格納したNamespace。

type args:

argparse.Namespace

param hist_max:

ヒストグラムの最大値。

type hist_max:

float

randomtrade_numpy2.main()[ソース]
概要:

メインのシミュレーションと可視化処理を実行します。

詳細説明:

コマンドライン引数に基づいて資産交換シミュレーションを行い、 結果をグラフとして表示または保存します。

例外:
raises RuntimeError:

GIF保存時にPillowがインストールされていない場合。

randomtrade_numpy2.parse_args()[ソース]
概要:

コマンドライン引数を解析します。

詳細説明:

ランダム資産交換シミュレーションに必要なパラメータを設定し、解析結果を返します。

戻り値:
returns:

解析されたコマンドライン引数を格納したNamespace。

rtype:

argparse.Namespace

randomtrade_numpy2.prepare_output(path)[ソース]
概要:

出力先ディレクトリが存在しない場合は作成します。

引数:
param path:

保存先のファイルパス。

type path:

pathlib.Path

randomtrade_numpy2.shannon_entropy(money, nbins, hist_max)[ソース]
概要:

固定ビンの資産分布から Shannon エントロピーを計算します。

詳細説明:

計算式は H = -Σp log(p) を使用します。

引数:
param money:

資産の配列。

type money:

numpy.ndarray

param nbins:

ヒストグラムのビン数。

type nbins:

int

param hist_max:

ヒストグラムの最大値。

type hist_max:

float

戻り値:
returns:

計算された Shannon エントロピーの値。

rtype:

float

randomtrade_numpy2.trade_one_sweep(money, vtrade, rng)[ソース]
概要:

全員が一回ずつ乱数で選んだ相手へ資産を渡します。

詳細説明:

1回のスイープで各個人がランダムな相手に一定額の資産を渡す処理を実行します。

引数:
param money:

各個人の資産を格納した配列。

type money:

numpy.ndarray

param vtrade:

1回の交換額。

type vtrade:

int

param rng:

乱数生成器。

type rng:

numpy.random.Generator