randomtrade_numpy2 のソースコード

"""
概要:
    NumPy を用いたランダム資産交換シミュレーションと可視化を行います。
詳細説明:
    資産分布と、その粗視化分布の Shannon エントロピーを可視化します。
    Boltzmann ゲームの振る舞いを確認できます。
"""

import argparse
from pathlib import Path

import matplotlib as mpl
from matplotlib import pyplot as plt
from matplotlib.animation import FuncAnimation, PillowWriter
import numpy as np


mpl.rcParams.update({
    "font.family": ["Yu Mincho", "MS Mincho", "serif"],
    "axes.unicode_minus": False,
    "text.usetex": False,
})


[ドキュメント] def parse_args(): """ 概要: コマンドライン引数を解析します。 詳細説明: ランダム資産交換シミュレーションに必要なパラメータを設定し、解析結果を返します。 戻り値: :returns: 解析されたコマンドライン引数を格納したNamespace。 :rtype: argparse.Namespace """ parser = argparse.ArgumentParser(description="ランダムな資産交換を NumPy で可視化します。") parser.add_argument("--npersons", type=int, default=200, help="人数(既定値: 200)") parser.add_argument("--value", type=int, default=50, help="一人当たりの初期資産(既定値: 50)") parser.add_argument("--vtrade", type=int, default=1, help="一回の交換額(既定値: 1)") parser.add_argument("--niter", type=int, default=10000, help="スイープ数(既定値: 10000)") parser.add_argument("--record-every", type=int, default=100, help="状態を記録する間隔(既定値: 100)") parser.add_argument("--nbins", type=int, default=21, help="資産分布のビン数(既定値: 21)") parser.add_argument("--interval", type=int, default=200, help="GIF のフレーム間隔 [ms](既定値: 200)") parser.add_argument("--gif-fps", type=int, default=5, help="GIF の毎秒フレーム数(既定値: 5)") parser.add_argument("--seed", type=int, default=None, help="乱数シード") parser.add_argument("--save-png", type=Path, metavar="FILE", help="最終状態を PNG 保存") parser.add_argument("--save-gif", type=Path, metavar="FILE", help="時間発展を GIF 保存") parser.add_argument("--dpi", type=int, default=150, help="保存画像の dpi(既定値: 150)") parser.add_argument("--no-show", action="store_true", help="画面にグラフを表示しない") args = parser.parse_args() if args.npersons <= 0 or args.value < 0 or args.vtrade <= 0: parser.error("--npersons は正、--value は非負、--vtrade は正にしてください。") if args.niter < 0 or args.record_every <= 0 or args.nbins < 2: parser.error("--niter は非負、--record-every は正、--nbins は 2 以上にしてください。") return args
[ドキュメント] def 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 """ targets = rng.integers(0, len(money), size=len(money)) for giver, receiver in enumerate(targets): amount = min(money[giver], vtrade) money[giver] -= amount money[receiver] += amount
[ドキュメント] def 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 """ counts, _ = np.histogram(money, bins=nbins, range=(0, hist_max)) p = counts[counts > 0] / len(money) return -np.sum(p * np.log(p))
[ドキュメント] def 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 """ ax1, ax2, ax3, ax4 = axes for ax in axes: ax.clear() sweep, money = frames[frame_index] n = args.npersons sorted_money = np.sort(money) mean_money = np.mean(money) ax1.bar(np.arange(n), money, width=1.0) ax1.axhline(args.value, linestyle="--", color="red", linewidth=0.8, label="初期平均") ax1.set_title(f"ランダム交換(sweep = {sweep}/{args.niter}, N = {n})") ax1.set_xlabel("個人 i") ax1.set_ylabel("資産") ax1.set_xlim(-0.5, n - 0.5) ax1.legend(loc="upper right") ax2.bar(np.arange(n), sorted_money, width=1.0) ax2.axhline(args.value, linestyle="--", color="red", linewidth=0.8, label="初期平均") ax2.set_xlabel("順位 i") ax2.set_ylabel("資産(昇順)") ax2.set_xlim(-0.5, n - 0.5) ax2.legend(loc="upper right") counts, _, _ = ax3.hist(money, bins=args.nbins, range=(0, hist_max), density=True, histtype="stepfilled", alpha=0.45, label="シミュレーション") x_theory = np.linspace(0, hist_max, 201) y_theory = np.exp(-x_theory / mean_money) / mean_money if mean_money > 0 else np.zeros_like(x_theory) ax3.plot(x_theory, y_theory, "r--", linewidth=1.2, label="指数分布") ax3.set_xlabel("一人あたりの資産 m") ax3.set_ylabel("確率密度") ax3.set_xlim(0, hist_max) ymax = max(np.max(counts, initial=0), np.max(y_theory, initial=0)) ax3.set_ylim(0, 1.15 * ymax if ymax > 0 else 1) ax3.legend(loc="upper right") sweeps = [item[0] for item in frames[:frame_index + 1]] ax4.plot(sweeps, entropy_history[:frame_index + 1], color="green") ax4.set_title(r"資産分布の Shannon エントロピー $H=-\sum_j p_j\log p_j$") ax4.set_xlabel("スイープ数") ax4.set_ylabel("H") ax4.set_xlim(0, max(args.niter, 1)) ax4.set_ylim(0, max(np.log(args.nbins) * 1.05, max(entropy_history, default=0) * 1.05, 1))
[ドキュメント] def prepare_output(path): """ 概要: 出力先ディレクトリが存在しない場合は作成します。 引数: :param path: 保存先のファイルパス。 :type path: pathlib.Path """ path.parent.mkdir(parents=True, exist_ok=True)
[ドキュメント] def main(): """ 概要: メインのシミュレーションと可視化処理を実行します。 詳細説明: コマンドライン引数に基づいて資産交換シミュレーションを行い、 結果をグラフとして表示または保存します。 例外: :raises RuntimeError: GIF保存時にPillowがインストールされていない場合。 """ args = parse_args() rng = np.random.default_rng(args.seed) money = np.full(args.npersons, args.value, dtype=np.int64) frames = [(0, money.copy())] for sweep in range(1, args.niter + 1): trade_one_sweep(money, args.vtrade, rng) if sweep % args.record_every == 0 or sweep == args.niter: frames.append((sweep, money.copy())) # 全記録時刻の最大値を使うので、ビン範囲は GIF の全フレームで不変である。 hist_max = max(np.max(values) for _, values in frames) hist_max = max(float(hist_max), 1.0) entropy_history = [shannon_entropy(values, args.nbins, hist_max) for _, values in frames] fig, axes = plt.subplots(4, 1, figsize=(6, 8), constrained_layout=True) draw_state(axes, len(frames) - 1, frames, entropy_history, args, hist_max) if args.save_png: prepare_output(args.save_png) fig.savefig(args.save_png, dpi=args.dpi, bbox_inches="tight") print(f"PNG を保存しました: {args.save_png}") if args.save_gif: prepare_output(args.save_gif) def update(frame_index): draw_state(axes, frame_index, frames, entropy_history, args, hist_max) return axes animation = FuncAnimation(fig, update, frames=len(frames), interval=args.interval, repeat=True) try: animation.save(args.save_gif, writer=PillowWriter(fps=args.gif_fps), dpi=args.dpi) except (ImportError, ModuleNotFoundError) as exc: raise RuntimeError("GIF 保存には Pillow が必要です: python -m pip install pillow") from exc print(f"GIF を保存しました: {args.save_gif}") if not args.no_show: plt.show()
if __name__ == "__main__": main()