randomtrade_numpy2.py ダウンロード/コピー

randomtrade_numpy2.py をダウンロード

randomtrade_numpy2.py
randomtrade_numpy2.py
  1"""
  2概要:
  3    NumPyを用いたランダム資産交換シミュレーションを行います。
  4詳細説明:
  5    資産分布とその粗視化分布のShannonエントロピーを計算し、状態の推移を可視化します。
  6"""
  7
  8import argparse
  9from pathlib import Path
 10
 11import matplotlib as mpl
 12from matplotlib import pyplot as plt
 13from matplotlib.animation import FuncAnimation, PillowWriter
 14import numpy as np
 15
 16
 17mpl.rcParams.update({
 18    "font.family": ["Yu Mincho", "MS Mincho", "serif"],
 19    "axes.unicode_minus": False,
 20    "text.usetex": False,
 21})
 22
 23
 24def parse_args():
 25    """
 26    概要:
 27        コマンドライン引数を解析します。
 28    戻り値:
 29        :returns: 解析された引数を格納したオブジェクト。
 30        :rtype: argparse.Namespace
 31    """
 32    parser = argparse.ArgumentParser(description="ランダムな資産交換を NumPy で可視化します。")
 33    parser.add_argument("--npersons", type=int, default=200, help="人数(既定値: 200)")
 34    parser.add_argument("--value", type=int, default=50, help="一人当たりの初期資産(既定値: 50)")
 35    parser.add_argument("--vtrade", type=int, default=1, help="一回の交換額(既定値: 1)")
 36    parser.add_argument("--niter", type=int, default=10000, help="スイープ数(既定値: 10000)")
 37    parser.add_argument("--record-every", type=int, default=100, help="状態を記録する間隔(既定値: 100)")
 38    parser.add_argument("--nbins", type=int, default=21, help="資産分布のビン数(既定値: 21)")
 39    parser.add_argument("--interval", type=int, default=200, help="GIF のフレーム間隔 [ms](既定値: 200)")
 40    parser.add_argument("--gif-fps", type=int, default=5, help="GIF の毎秒フレーム数(既定値: 5)")
 41    parser.add_argument("--seed", type=int, default=None, help="乱数シード")
 42    parser.add_argument("--save-png", type=Path, metavar="FILE", help="最終状態を PNG 保存")
 43    parser.add_argument("--save-gif", type=Path, metavar="FILE", help="時間発展を GIF 保存")
 44    parser.add_argument("--dpi", type=int, default=150, help="保存画像の dpi(既定値: 150)")
 45    parser.add_argument("--no-show", action="store_true", help="画面にグラフを表示しない")
 46    args = parser.parse_args()
 47    if args.npersons <= 0 or args.value < 0 or args.vtrade <= 0:
 48        parser.error("--npersons は正、--value は非負、--vtrade は正にしてください。")
 49    if args.niter < 0 or args.record_every <= 0 or args.nbins < 2:
 50        parser.error("--niter は非負、--record-every は正、--nbins は 2 以上にしてください。")
 51    return args
 52
 53
 54def trade_one_sweep(money, vtrade, rng):
 55    """
 56    概要:
 57        全員が一回ずつ、乱数で選んだ相手へ資産を渡します。
 58    引数:
 59        :param money: 各個人の資産を格納した配列。
 60        :type money: numpy.ndarray
 61        :param vtrade: 一回の交換で渡す資産額。
 62        :type vtrade: int
 63        :param rng: 乱数生成器。
 64        :type rng: numpy.random.Generator
 65    """
 66    targets = rng.integers(0, len(money), size=len(money))
 67    for giver, receiver in enumerate(targets):
 68        amount = min(money[giver], vtrade)
 69        money[giver] -= amount
 70        money[receiver] += amount
 71
 72
 73def shannon_entropy(money, nbins, hist_max):
 74    """
 75    概要:
 76        固定ビンの資産分布からShannonエントロピーを計算します。
 77    詳細説明:
 78        数式 H = -Σp log(p) に基づき計算を行います。
 79    引数:
 80        :param money: 各個人の資産を格納した配列。
 81        :type money: numpy.ndarray
 82        :param nbins: ヒストグラムのビン数。
 83        :type nbins: int
 84        :param hist_max: ヒストグラムの最大範囲。
 85        :type hist_max: float
 86    戻り値:
 87        :returns: 計算されたエントロピーの値。
 88        :rtype: float
 89    """
 90    counts, _ = np.histogram(money, bins=nbins, range=(0, hist_max))
 91    p = counts[counts > 0] / len(money)
 92    return -np.sum(p * np.log(p))
 93
 94
 95def draw_state(axes, frame_index, frames, entropy_history, args, hist_max):
 96    """
 97    概要:
 98        指定されたフレームのシミュレーション状態をグラフに描画します。
 99    引数:
100        :param axes: 描画先のMatplotlibのAxes配列。
101        :type axes: numpy.ndarray
102        :param frame_index: 描画するフレームのインデックス。
103        :type frame_index: int
104        :param frames: スイープ数と資産配列のタプルを格納したリスト。
105        :type frames: list
106        :param entropy_history: 各フレームで計算されたエントロピーの履歴。
107        :type entropy_history: list
108        :param args: コマンドライン引数を格納したオブジェクト。
109        :type args: argparse.Namespace
110        :param hist_max: ヒストグラムの最大範囲。
111        :type hist_max: float
112    """
113    ax1, ax2, ax3, ax4 = axes
114    for ax in axes:
115        ax.clear()
116
117    sweep, money = frames[frame_index]
118    n = args.npersons
119    sorted_money = np.sort(money)
120    mean_money = np.mean(money)
121
122    ax1.bar(np.arange(n), money, width=1.0)
123    ax1.axhline(args.value, linestyle="--", color="red", linewidth=0.8, label="初期平均")
124    ax1.set_title(f"ランダム交換(sweep = {sweep}/{args.niter}, N = {n})")
125    ax1.set_xlabel("個人 i")
126    ax1.set_ylabel("資産")
127    ax1.set_xlim(-0.5, n - 0.5)
128    ax1.legend(loc="upper right")
129
130    ax2.bar(np.arange(n), sorted_money, width=1.0)
131    ax2.axhline(args.value, linestyle="--", color="red", linewidth=0.8, label="初期平均")
132    ax2.set_xlabel("順位 i")
133    ax2.set_ylabel("資産(昇順)")
134    ax2.set_xlim(-0.5, n - 0.5)
135    ax2.legend(loc="upper right")
136
137    counts, _, _ = ax3.hist(money, bins=args.nbins, range=(0, hist_max), density=True,
138                             histtype="stepfilled", alpha=0.45, label="シミュレーション")
139    x_theory = np.linspace(0, hist_max, 201)
140    y_theory = np.exp(-x_theory / mean_money) / mean_money if mean_money > 0 else np.zeros_like(x_theory)
141    ax3.plot(x_theory, y_theory, "r--", linewidth=1.2, label="指数分布")
142    ax3.set_xlabel("一人あたりの資産 m")
143    ax3.set_ylabel("確率密度")
144    ax3.set_xlim(0, hist_max)
145    ymax = max(np.max(counts, initial=0), np.max(y_theory, initial=0))
146    ax3.set_ylim(0, 1.15 * ymax if ymax > 0 else 1)
147    ax3.legend(loc="upper right")
148
149    sweeps = [item[0] for item in frames[:frame_index + 1]]
150    ax4.plot(sweeps, entropy_history[:frame_index + 1], color="green")
151    ax4.set_title(r"資産分布の Shannon エントロピー  $H=-\sum_j p_j\log p_j$")
152    ax4.set_xlabel("スイープ数")
153    ax4.set_ylabel("H")
154    ax4.set_xlim(0, max(args.niter, 1))
155    ax4.set_ylim(0, max(np.log(args.nbins) * 1.05, max(entropy_history, default=0) * 1.05, 1))
156
157
158def prepare_output(path):
159    """
160    概要:
161        ファイル出力先の親ディレクトリを作成します。
162    引数:
163        :param path: 保存先のファイルパス。
164        :type path: pathlib.Path
165    """
166    path.parent.mkdir(parents=True, exist_ok=True)
167
168
169def main():
170    """
171    概要:
172        ランダム資産交換シミュレーションを実行し、結果を可視化します。
173    詳細説明:
174        コマンドライン引数に基づいてシミュレーションを行い、エントロピーの履歴とともにグラフを画面に表示、または画像として保存します。
175    """
176    args = parse_args()
177    rng = np.random.default_rng(args.seed)
178    money = np.full(args.npersons, args.value, dtype=np.int64)
179    frames = [(0, money.copy())]
180
181    for sweep in range(1, args.niter + 1):
182        trade_one_sweep(money, args.vtrade, rng)
183        if sweep % args.record_every == 0 or sweep == args.niter:
184            frames.append((sweep, money.copy()))
185
186    # 全記録時刻の最大値を使うので、ビン範囲は GIF の全フレームで不変である。
187    hist_max = max(np.max(values) for _, values in frames)
188    hist_max = max(float(hist_max), 1.0)
189    entropy_history = [shannon_entropy(values, args.nbins, hist_max) for _, values in frames]
190
191    fig, axes = plt.subplots(4, 1, figsize=(6, 8), constrained_layout=True)
192    draw_state(axes, len(frames) - 1, frames, entropy_history, args, hist_max)
193
194    if args.save_png:
195        prepare_output(args.save_png)
196        fig.savefig(args.save_png, dpi=args.dpi, bbox_inches="tight")
197        print(f"PNG を保存しました: {args.save_png}")
198
199    if args.save_gif:
200        prepare_output(args.save_gif)
201
202        def update(frame_index):
203            draw_state(axes, frame_index, frames, entropy_history, args, hist_max)
204            return axes
205
206        animation = FuncAnimation(fig, update, frames=len(frames), interval=args.interval, repeat=True)
207        try:
208            animation.save(args.save_gif, writer=PillowWriter(fps=args.gif_fps), dpi=args.dpi)
209        except (ImportError, ModuleNotFoundError) as exc:
210            raise RuntimeError("GIF 保存には Pillow が必要です: python -m pip install pillow") from exc
211        print(f"GIF を保存しました: {args.save_gif}")
212
213    if not args.no_show:
214        plt.show()
215
216
217if __name__ == "__main__":
218    main()