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