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()