"""van der Pauw形状補正因子を計算・描画する。

実行: python vdPauw_verbose.py --max_R 100
依存ライブラリ: numpy, scipy, matplotlib
"""

import argparse

import numpy as np
import matplotlib.pyplot as plt
from scipy.optimize import brentq


def vdp_factor(r: float) -> float:
    """正の抵抗比r = R_AB,CD / R_AD,BCに対する補正因子fを返す。

    Rs = pi/ln(2) * (R_AB,CD + R_AD,BC)/2 * f と定義する。
    x = pi*R_AD,BC/Rsとしてvan der Pauw方程式を解く。
    """
    if not np.isfinite(r) or r <= 0:
        raise ValueError("抵抗比rは有限の正の値にしてください")

    def equation(x):
        return np.exp(-x * r) + np.exp(-x) - 1

    x = brentq(equation, 1e-10, 100)
    return 2 * np.log(2) / (x * (r + 1))


def calculate_factors(r_values: np.ndarray, *, show_progress=False) -> np.ndarray:
    """補正因子を計算する。表示が必要な場合だけ進捗を出す。"""
    f_values = np.empty(len(r_values))
    for i, r in enumerate(r_values):
        f_values[i] = vdp_factor(r)
        if show_progress and ((i + 1) % 100 == 0 or i + 1 == len(r_values)):
            print(f"計算中: {i + 1}/{len(r_values)} 点 (R={r:.6g})", flush=True)
    return f_values


def print_results(r_values: np.ndarray, f_values: np.ndarray):
    """代表的な抵抗比の係数と、方程式の左辺・残差を表示する。"""
    print("\n代表値（Rは抵抗比 R_AB,CD / R_AD,BC）")
    print(f"{'R':>12} {'f':>14} {'左辺 exp(-xR)+exp(-x)':>27} {'残差 (左辺-1)':>20}")
    # 両端と、その間の代表値を重複なく表示する。
    representatives = sorted({float(r_values[0]), float(r_values[-1])} |
                             {r for r in (0.01, 0.1, 1, 2, 10, 100)
                              if r_values[0] <= r <= r_values[-1]})
    for r in representatives:
        f = vdp_factor(r)
        x = 2 * np.log(2) / (f * (r + 1))
        lhs = np.exp(-x * r) + np.exp(-x)
        print(f"{r:12.6g} {f:14.10f} {lhs:27.15f} {lhs - 1:20.3e}")
    x_values = 2 * np.log(2) / (f_values * (r_values + 1))
    residuals = np.exp(-x_values * r_values) + np.exp(-x_values) - 1
    print(f"全{len(r_values)}点の最大絶対残差: {np.max(np.abs(residuals)):.3e}")


def plot_factors(r_values: np.ndarray, f_values: np.ndarray):
    """結果を描画してFigureとAxesを返す。画面表示は呼出し元で行う。"""
    fig, ax = plt.subplots(figsize=(8, 6))
    ax.semilogx(r_values, f_values, lw=2)
    ax.set_xlabel(r"$R_{AB,CD}/R_{AD,BC}$", fontsize=14)
    ax.set_ylabel("Correction factor f", fontsize=14)
    ax.set_title("van der Pauw Correction Factor", fontsize=16)
    ax.grid(True, which="both", alpha=0.3)
    ax.set_ylim(0, 1.05)
    fig.tight_layout()
    return fig, ax


def initialize(argv=None):
    """コマンドライン引数を読み、設定値を検査する。"""
    parser = argparse.ArgumentParser(description="van der Pauw補正因子の計算")
    parser.add_argument("--max_R", type=float, default=100.0,
                        help="抵抗比Rの上限（下限0.01、既定値100）")
    args = parser.parse_args(argv)
    if not np.isfinite(args.max_R) or args.max_R < 0.01:
        parser.error("max_Rは0.01以上の有限値にしてください")
    return args


def main(argv=None):
    """設定を表示し、計算・結果表示・描画を順に行う。"""
    args = initialize(argv)
    min_R, n_points = 0.01, 500
    print(f"設定: max_R={args.max_R:g}, min_R={min_R:g}, n_points={n_points}",
          flush=True)
    r_values = np.geomspace(min_R, args.max_R, n_points)
    f_values = calculate_factors(r_values, show_progress=True)
    print_results(r_values, f_values)
    print("計算完了。グラフを表示します。", flush=True)
    plot_factors(r_values, f_values)
    plt.show()


if __name__ == "__main__":
    main()
