"""
概要:
    NumPyを用いたランダム資産交換シミュレーションを行います。
詳細説明:
    資産分布とその粗視化分布のShannonエントロピーを計算し、状態の推移を可視化します。
"""

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: 解析された引数を格納したオブジェクト。
        :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):
    """
    概要:
        全員が一回ずつ、乱数で選んだ相手へ資産を渡します。
    引数:
        :param money: 各個人の資産を格納した配列。
        :type money: numpy.ndarray
        :param vtrade: 一回の交換で渡す資産額。
        :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: 計算されたエントロピーの値。
        :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):
    """
    概要:
        指定されたフレームのシミュレーション状態をグラフに描画します。
    引数:
        :param axes: 描画先のMatplotlibの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: コマンドライン引数を格納したオブジェクト。
        :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():
    """
    概要:
        ランダム資産交換シミュレーションを実行し、結果を可視化します。
    詳細説明:
        コマンドライン引数に基づいてシミュレーションを行い、エントロピーの履歴とともにグラフを画面に表示、または画像として保存します。
    """
    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()