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

tb_valley_1d.py をダウンロード

tb_valley_1d.py
tb_valley_1d.py
  1#!/usr/bin/env python3
  2"""CLI for scanning 1D tight-binding bands along a path in (t1, t2) space.
  3
  4The model itself is implemented in :mod:`tb_valley_core`.  See
  5``tb_valley_gui.py`` for an interactive GUI using the same library.
  6"""
  7
  8from __future__ import annotations
  9
 10import argparse
 11import math
 12
 13import matplotlib.pyplot as plt
 14import numpy as np
 15
 16from tb_valley_core import analytic_minimum, band, k_grid, parameter_path
 17
 18
 19def parse_args() -> argparse.Namespace:
 20    parser = argparse.ArgumentParser(
 21        description="Plot paired 1D TB bands with first/second-neighbor hopping.")
 22    parser.add_argument("--t1-min", type=float, default=0.0)
 23    parser.add_argument("--t1-max", type=float, default=1.0)
 24    parser.add_argument("--t2-min", type=float, default=0.5)
 25    parser.add_argument("--t2-max", type=float, default=0.1)
 26    parser.add_argument("-n", "--n", type=int, default=5,
 27                        help="number of paired (t1, t2) parameter points")
 28    parser.add_argument("--nk", type=int, default=100,
 29                        help="number of k intervals; the plot uses nk+1 points")
 30    parser.add_argument("--epsilon0", type=float, default=0.0,
 31                        help="on-site energy")
 32    parser.add_argument("--output", type=str, default=None,
 33                        help="optional output image, e.g. tb_valley.png")
 34    parser.add_argument("--dpi", type=int, default=160)
 35    parser.add_argument("--no-show", action="store_true",
 36                        help="do not open an interactive plot window")
 37    return parser.parse_args()
 38
 39
 40def main() -> None:
 41    args = parse_args()
 42    try:
 43        params = parameter_path(args.t1_min, args.t1_max, args.t2_min,
 44                                args.t2_max, args.n, args.epsilon0)
 45        k = k_grid(args.nk)
 46    except ValueError as exc:
 47        raise SystemExit(str(exc)) from exc
 48
 49    curves = [band(k, p.t1, p.t2, p.epsilon0) for p in params]
 50    e_low = min(float(np.min(energy)) for energy in curves)
 51    e_high = max(float(np.max(energy)) for energy in curves)
 52    margin = 0.06 * max(e_high - e_low, 1.0)
 53
 54    ncols = min(3, args.n)
 55    nrows = math.ceil(args.n / ncols)
 56    fig, axes = plt.subplots(nrows, ncols, figsize=(4.1 * ncols, 3.3 * nrows),
 57                             squeeze=False, sharex=True, sharey=True)
 58
 59    print("\n=== 1D tight-binding valley scan ===")
 60    print(f"{'i':>3s} {'t1':>11s} {'t2':>11s} {'|k_min|/pi':>13s} "
 61          f"{'E_min':>14s}  location")
 62    print("-" * 72)
 63
 64    for i, (p, energy) in enumerate(zip(params, curves)):
 65        ax = axes.flat[i]
 66        k_min, e_min, label = analytic_minimum(p.t1, p.t2, p.epsilon0)
 67        ax.plot(k / np.pi, energy, color="tab:blue", lw=2)
 68        if np.isclose(k_min, 0.0) or np.isclose(k_min, np.pi):
 69            ax.scatter([k_min / np.pi if k_min else 0.0], [e_min],
 70                       color="tab:red", s=35, zorder=4)
 71            if np.isclose(k_min, np.pi):
 72                ax.scatter([-1.0], [e_min], color="tab:red", s=35, zorder=4)
 73        else:
 74            ax.scatter([-k_min / np.pi, k_min / np.pi], [e_min, e_min],
 75                       color="tab:red", s=35, zorder=4)
 76
 77        ax.axvline(0.0, color="0.75", lw=0.8)
 78        ax.set_title(f"$t_1$={p.t1:.3g}, $t_2$={p.t2:.3g}\n"
 79                     f"$|k_{{min}}|/\\pi$={k_min / np.pi:.3f} ({label})",
 80                     fontsize=10)
 81        ax.set_xlim(-1.0, 1.0)
 82        ax.set_ylim(e_low - margin, e_high + margin)
 83        ax.set_xticks([-1.0, -0.5, 0.0, 0.5, 1.0])
 84        ax.set_xticklabels([r"$-\pi$", r"$-\pi/2$", "0", r"$\pi/2$", r"$\pi$"])
 85        ax.grid(alpha=0.25)
 86        print(f"{i:3d} {p.t1:11.6f} {p.t2:11.6f} {k_min / np.pi:13.7f} "
 87              f"{e_min:14.8f}  {label}")
 88
 89    for i in range(args.n, nrows * ncols):
 90        axes.flat[i].set_visible(False)
 91    for row in range(nrows):
 92        axes[row, 0].set_ylabel("Energy")
 93    for ax in axes[-1, :]:
 94        if ax.get_visible():
 95            ax.set_xlabel("Wave vector $k$")
 96
 97    fig.suptitle(r"1D TB bands: $E(k)=\epsilon_0+2t_1\cos k+2t_2\cos(2k)$",
 98                 fontsize=14)
 99    fig.tight_layout(rect=(0, 0, 1, 0.96))
100    if args.output:
101        fig.savefig(args.output, dpi=args.dpi, bbox_inches="tight")
102        print(f"\nSaved figure: {args.output}")
103    if args.no_show:
104        plt.close(fig)
105    else:
106        plt.show()
107
108
109if __name__ == "__main__":
110    main()