"""
概要:
    閉じた資産交換模型のシミュレーションを実行します。
詳細説明:
    全体系を A（小さい部分系）と B（大きい熱浴）に分け、各人がもつ資産を
    1 単位ずつランダムに交換します。資産は負にならず、全資産は保存されます。

    下段の H は一人を無作為に選んだときの資産値の経験分布の Shannon エントロピー
    H = - sum_m p(m) log p(m) です。整数の資産値をそのまま数えているため、
    時刻ごとにヒストグラムのビンを取り直すことによる見かけの変化はありません。
    これは熱力学的エントロピー k_B log W そのものではない点に注意します。

    第3段は、この離散模型の状態数 Omega_N(M) = (M+N-1)! / [M! (N-1)!] から
    計算する小正準エントロピー S/k_B = log Omega です。
"""

from collections import Counter
import argparse
import math
import random
from pathlib import Path

import matplotlib as mpl
import numpy as np

# 日本語フォントは、環境内で実際に認識された名前を使う。
mpl.rcdefaults()
mpl.rcParams.update(
    {
        "font.family": "Yu Mincho",
        "font.size": 14,
        "axes.unicode_minus": False,
        "text.usetex": False,
    }
)

import matplotlib.pyplot as plt
from matplotlib.animation import FuncAnimation


# ----- パラメータ -----
NA = 50          # グループ A の人数（小さい部分系）
NB = 500         # グループ B の人数（大きい熱浴）
MA0 = 100          # 各人の初期資産
MB0 = 50          # 各人の初期資産
VTRADE = 1       # 1 回の交換額（整数にする）
NITER = 10_000   # スイープ回数
RECORD_EVERY = 1 # 何スイープごとに記録するか
ANIMATION_EVERY = 100  # 分布アニメーションの記録間隔（スイープ数）
ANIMATION_INTERVAL_MS = 150
DISPLAY_BIN_WIDTH = 5  # アニメーション表示用の資産ビン幅
SEED = None      # 再現したいときは、例えば 1234 を指定する


def parse_args():
    """
    概要:
        コマンドライン引数をパースします。
    戻り値:
        :returns: コマンドライン引数を格納したNamespace。
        :rtype: argparse.Namespace
    """
    parser = argparse.ArgumentParser(
        description="小系 A と有限熱浴 B のランダム資産交換模型"
    )
    parser.add_argument("--na", type=int, default=NA, help=f"系 A の人数（既定値: {NA}）")
    parser.add_argument("--nb", type=int, default=NB, help=f"系 B の人数（既定値: {NB}）")
    parser.add_argument("--ma0", type=int, default=MA0, help=f"A の一人あたり初期資産（既定値: {MA0}）")
    parser.add_argument("--mb0", type=int, default=MB0, help=f"B の一人あたり初期資産（既定値: {MB0}）")
    parser.add_argument("--vtrade", type=int, default=VTRADE, help=f"1 回の交換額（既定値: {VTRADE}）")
    parser.add_argument("--niter", type=int, default=NITER, help=f"スイープ回数（既定値: {NITER}）")
    parser.add_argument("--record-every", type=int, default=RECORD_EVERY, help="記録間隔（スイープ数）")
    parser.add_argument("--animation-every", type=int, default=ANIMATION_EVERY, help="アニメーションの記録間隔")
    parser.add_argument("--animation-interval", type=int, default=ANIMATION_INTERVAL_MS, help="アニメーションのフレーム間隔 [ms]")
    parser.add_argument("--bin-width", type=int, default=DISPLAY_BIN_WIDTH, help="分布表示用ビン幅")
    parser.add_argument("--seed", type=int, default=SEED, help="乱数種")
    parser.add_argument("--save-png", metavar="PATH", help="時系列グラフを PNG へ保存")
    parser.add_argument("--save-gif", metavar="PATH", help="資産分布アニメーションを GIF へ保存（Pillow が必要）")
    parser.add_argument("--gif-fps", type=float, default=None, help="GIF のフレームレート [fps]")
    parser.add_argument("--dpi", type=int, default=150, help="PNG/GIF 保存時の解像度")
    parser.add_argument("--no-show", action="store_true", help="描画ウィンドウを開かない")
    args = parser.parse_args()

    for name in ("na", "nb", "vtrade", "niter", "record_every", "animation_every", "animation_interval", "bin_width", "dpi"):
        if getattr(args, name) <= 0:
            parser.error(f"--{name.replace('_', '-')} は正の値にしてください。")
    if args.ma0 < 0 or args.mb0 < 0:
        parser.error("--ma0 と --mb0 は 0 以上にしてください。")
    if args.gif_fps is not None and args.gif_fps <= 0:
        parser.error("--gif-fps は正の値にしてください。")
    return args


def output_path(path_text):
    """
    概要:
        保存先の親ディレクトリを作成して Path を返します。
    引数:
        :param path_text: 保存先を示すパス文字列。
        :type path_text: str
    戻り値:
        :returns: 作成されたディレクトリを含むパスオブジェクト。
        :rtype: pathlib.Path
    """
    path = Path(path_text)
    path.parent.mkdir(parents=True, exist_ok=True)
    return path


def shannon_entropy(values):
    """
    概要:
        資産値の経験分布の Shannon エントロピーを返します。
    詳細説明:
        自然対数を使用してエントロピーを計算します。
    引数:
        :param values: 資産値のリストなどのイテラブル。
        :type values: list
    戻り値:
        :returns: 計算された Shannon エントロピー。
        :rtype: float
    """
    n = len(values)
    counts = Counter(values).values()
    return -sum((count / n) * math.log(count / n) for count in counts)


def log_omega(n_people, total_money):
    """
    概要:
        非負整数の総資産を複数人へ配る状態数の自然対数を計算します。
    詳細説明:
        状態数の対数 log(n!) は Stirling 近似ではなく math.lgamma を用いて計算します。
    引数:
        :param n_people: 対象の人数。
        :type n_people: int
        :param total_money: 割り当てる総資産。
        :type total_money: int
    戻り値:
        :returns: 状態数の自然対数。
        :rtype: float
    例外:
        :raises ValueError: 総資産が負の場合に発生します。
    """
    if total_money < 0:
        raise ValueError("総資産は非負でなければなりません。")
    return (
        math.lgamma(total_money + n_people)
        - math.lgamma(total_money + 1)
        - math.lgamma(n_people)
    )


def main(args):
    """
    概要:
        資産交換シミュレーションのメイン処理を実行します。
    詳細説明:
        系AとBの間で資産をランダムに交換し、平均資産、エントロピー、および
        資産分布の推移を計算します。結果はプロットされ、必要に応じて
        画像やアニメーションとして保存されます。
    引数:
        :param args: コマンドライン引数を格納したNamespace。
        :type args: argparse.Namespace
    """
    NA = args.na
    NB = args.nb
    MA0 = args.ma0
    MB0 = args.mb0
    VTRADE = args.vtrade
    NITER = args.niter
    RECORD_EVERY = args.record_every
    ANIMATION_EVERY = args.animation_every
    ANIMATION_INTERVAL_MS = args.animation_interval
    DISPLAY_BIN_WIDTH = args.bin_width

    rng = random.Random(args.seed)
    n_total = NA + NB
    money = [MA0] * n_total
    money[NA:n_total] = [MB0] * NB
    total_money = sum(money)

    steps = []
    mean_a_history = []
    mean_b_history = []
    entropy_a_history = []
    entropy_b_history = []
    entropy_all_history = []
    micro_entropy_a_history = []
    micro_entropy_b_history = []
    micro_entropy_total_history = []
    distribution_frames = []

    def record(step):
        money_a = money[:NA]
        money_b = money[NA:]

        steps.append(step)
        mean_a_history.append(sum(money_a) / NA)
        mean_b_history.append(sum(money_b) / NB)
        entropy_a_history.append(shannon_entropy(money_a))
        entropy_b_history.append(shannon_entropy(money_b))
        entropy_all_history.append(shannon_entropy(money))

        # これは資産ヒストグラムの Shannon エントロピーとは別物である。
        # A の全資産 M_A に対し、Omega_A(M_A) 個の微視的資産配置を数える。
        total_money_a = sum(money_a)
        total_money_b = total_money - total_money_a
        s_a = log_omega(NA, total_money_a)
        s_b = log_omega(NB, total_money_b)
        micro_entropy_a_history.append(s_a)
        micro_entropy_b_history.append(s_b)
        micro_entropy_total_history.append(s_a + s_b)

        if step % ANIMATION_EVERY == 0:
            # 後から状態が変わってもよいように、ここでコピーを保存する。
            distribution_frames.append((step, money_a.copy(), money_b.copy()))

    # t = 0 も記録する。全員が M0 なので、ここで H = 0 になる。
    record(0)

    # 1 スイープ = 全人数と同じ回数だけ交換相手を選ぶ。
    for step in range(1, NITER + 1):
        for _ in range(n_total):
            giver = rng.randrange(n_total)
            receiver = rng.randrange(n_total)

            if giver == receiver or money[giver] < VTRADE:
                continue

            money[giver] -= VTRADE
            money[receiver] += VTRADE

        if step % RECORD_EVERY == 0:
            record(step)

    assert sum(money) == total_money, "全資産が保存されていません。"

    fig, (ax_mean, ax_entropy, ax_micro) = plt.subplots(
        3, 1, figsize=(6, 8), sharex=True, constrained_layout=True
    )

    ax_mean.plot(steps, mean_a_history, label=r"$\langle M \rangle_A$")
    ax_mean.plot(steps, mean_b_history, label=r"$\langle M \rangle_B$")
    ax_mean.axhline(MA0, color="0.5", linestyle=":", linewidth=1.5, label="A初期平均")
    ax_mean.axhline(MB0, color="0.5", linestyle="--", linewidth=1.5, label="B初期平均")
    ax_mean.set_title("平均資産の推移")
    ax_mean.set_ylabel("平均資産")
    ax_mean.legend()
    ax_mean.grid(alpha=0.25)

    ax_entropy.plot(steps, entropy_all_history, color="0.25", label="全体系")
    ax_entropy.plot(steps, entropy_a_history, label=r"$H_A$")
    ax_entropy.plot(steps, entropy_b_history, label=r"$H_B$")
    ax_entropy.set_title("資産分布の Shannon エントロピー")
    ax_entropy.set_ylabel(r"$H=-\sum_m p(m)\log p(m)$")
    ax_entropy.legend()
    ax_entropy.grid(alpha=0.25)

    ax_micro.plot(steps, micro_entropy_a_history, label=r"$S_A/k_{\rm B}$")
    ax_micro.plot(steps, micro_entropy_b_history, label=r"$S_B/k_{\rm B}$")
    ax_micro.plot(
        steps,
        micro_entropy_total_history,
        color="0.2",
        linewidth=2,
        label=r"$(S_A+S_B)/k_{\rm B}$",
    )
    ax_micro.set_title("状態数から求めた小正準エントロピー")
    ax_micro.set_xlabel("スイープ数")
    ax_micro.set_ylabel(r"$S/k_{\rm B}=\log\Omega$")
    ax_micro.legend()
    ax_micro.grid(alpha=0.25)

    # ----- A, B の資産分布のアニメーション -----
    # 全フレームで同じ粗いビンを使う。縦軸は各フレームで A・B 共通に
    # 自動調整し、初期状態の高さ 1 によって平衡後の分布が潰れないようにする。
    largest_money = max(
        max(max(money_a), max(money_b))
        for _, money_a, money_b in distribution_frames
    )
    bins = list(range(0, largest_money + DISPLAY_BIN_WIDTH + 1, DISPLAY_BIN_WIDTH))
    if bins[-1] <= largest_money:
        bins.append(bins[-1] + DISPLAY_BIN_WIDTH)

    fig_dist, (ax_a, ax_b) = plt.subplots(
        2, 1, figsize=(8, 6), sharex=True, sharey=True, constrained_layout=True
    )

    def draw_distribution(frame_index):
        step, money_a, money_b = distribution_frames[frame_index]
        count_a, _ = np.histogram(money_a, bins=bins)
        count_b, _ = np.histogram(money_b, bins=bins)
        y_max = 1.10 * max(count_a.max() / NA, count_b.max() / NB, 0.02)

        ax_a.clear()
        ax_b.clear()
        ax_a.hist(
            money_a,
            bins=bins,
            weights=[1 / NA] * NA,
            color="tab:blue",
            edgecolor="white",
        )
        ax_b.hist(
            money_b,
            bins=bins,
            weights=[1 / NB] * NB,
            color="tab:orange",
            edgecolor="white",
        )

        ax_a.set_title(f"系 A の資産分布（sweep = {step}）")
        ax_b.set_title(f"系 B の資産分布（sweep = {step}）")
        ax_a.set_ylabel("確率")
        ax_b.set_ylabel("確率")
        ax_b.set_xlabel("一人あたりの資産 $m$")
        for ax in (ax_a, ax_b):
            ax.set_xlim(0, bins[-1])
            ax.set_ylim(0, y_max)
            ax.grid(alpha=0.25)

    animation = FuncAnimation(
        fig_dist,
        draw_distribution,
        frames=len(distribution_frames),
        interval=ANIMATION_INTERVAL_MS,
        repeat=True,
        blit=False,
    )
    # 参照を figure にも保持し、アニメーションが破棄されないようにする。
    fig_dist._distribution_animation = animation

    if args.save_png:
        png_path = output_path(args.save_png)
        fig.savefig(png_path, dpi=args.dpi)
        print(f"時系列グラフを保存しました: {png_path}")

    if args.save_gif:
        gif_path = output_path(args.save_gif)
        gif_fps = args.gif_fps or 1000 / ANIMATION_INTERVAL_MS
        try:
            animation.save(gif_path, writer="pillow", fps=gif_fps, dpi=args.dpi)
        except (ImportError, ValueError) as exc:
            raise RuntimeError(
                "GIF 保存には Pillow が必要です。"
                " 例: python -m pip install pillow"
            ) from exc
        print(f"分布アニメーションを保存しました: {gif_path}")

    print(f"初期値: H_A = {entropy_a_history[0]:.6f}, "
          f"H_B = {entropy_b_history[0]:.6f}, "
          f"H_all = {entropy_all_history[0]:.6f}")
    print(f"最終値: H_A = {entropy_a_history[-1]:.6f}, "
          f"H_B = {entropy_b_history[-1]:.6f}, "
          f"H_all = {entropy_all_history[-1]:.6f}")
    print(
        f"分布アニメーション: 0 から {NITER} sweep まで、"
        f"{ANIMATION_EVERY} sweep 間隔で表示します。"
    )

    if not args.no_show:
        plt.show()
    else:
        plt.close("all")


if __name__ == "__main__":
    main(parse_args())