#!/usr/bin/env python3 """CLI for scanning 1D tight-binding bands along a path in (t1, t2) space. The model itself is implemented in :mod:`tb_valley_core`. See ``tb_valley_gui.py`` for an interactive GUI using the same library. """ from __future__ import annotations import argparse import math import matplotlib.pyplot as plt import numpy as np from tb_valley_core import analytic_minimum, band, k_grid, parameter_path def parse_args() -> argparse.Namespace: parser = argparse.ArgumentParser( description="Plot paired 1D TB bands with first/second-neighbor hopping.") parser.add_argument("--t1-min", type=float, default=0.0) parser.add_argument("--t1-max", type=float, default=1.0) parser.add_argument("--t2-min", type=float, default=0.5) parser.add_argument("--t2-max", type=float, default=0.1) parser.add_argument("-n", "--n", type=int, default=5, help="number of paired (t1, t2) parameter points") parser.add_argument("--nk", type=int, default=100, help="number of k intervals; the plot uses nk+1 points") parser.add_argument("--epsilon0", type=float, default=0.0, help="on-site energy") parser.add_argument("--output", type=str, default=None, help="optional output image, e.g. tb_valley.png") parser.add_argument("--dpi", type=int, default=160) parser.add_argument("--no-show", action="store_true", help="do not open an interactive plot window") return parser.parse_args() def main() -> None: args = parse_args() try: params = parameter_path(args.t1_min, args.t1_max, args.t2_min, args.t2_max, args.n, args.epsilon0) k = k_grid(args.nk) except ValueError as exc: raise SystemExit(str(exc)) from exc curves = [band(k, p.t1, p.t2, p.epsilon0) for p in params] e_low = min(float(np.min(energy)) for energy in curves) e_high = max(float(np.max(energy)) for energy in curves) margin = 0.06 * max(e_high - e_low, 1.0) ncols = min(3, args.n) nrows = math.ceil(args.n / ncols) fig, axes = plt.subplots(nrows, ncols, figsize=(4.1 * ncols, 3.3 * nrows), squeeze=False, sharex=True, sharey=True) print("\n=== 1D tight-binding valley scan ===") print(f"{'i':>3s} {'t1':>11s} {'t2':>11s} {'|k_min|/pi':>13s} " f"{'E_min':>14s} location") print("-" * 72) for i, (p, energy) in enumerate(zip(params, curves)): ax = axes.flat[i] k_min, e_min, label = analytic_minimum(p.t1, p.t2, p.epsilon0) ax.plot(k / np.pi, energy, color="tab:blue", lw=2) if np.isclose(k_min, 0.0) or np.isclose(k_min, np.pi): ax.scatter([k_min / np.pi if k_min else 0.0], [e_min], color="tab:red", s=35, zorder=4) if np.isclose(k_min, np.pi): ax.scatter([-1.0], [e_min], color="tab:red", s=35, zorder=4) else: ax.scatter([-k_min / np.pi, k_min / np.pi], [e_min, e_min], color="tab:red", s=35, zorder=4) ax.axvline(0.0, color="0.75", lw=0.8) ax.set_title(f"$t_1$={p.t1:.3g}, $t_2$={p.t2:.3g}\n" f"$|k_{{min}}|/\\pi$={k_min / np.pi:.3f} ({label})", fontsize=10) ax.set_xlim(-1.0, 1.0) ax.set_ylim(e_low - margin, e_high + margin) ax.set_xticks([-1.0, -0.5, 0.0, 0.5, 1.0]) ax.set_xticklabels([r"$-\pi$", r"$-\pi/2$", "0", r"$\pi/2$", r"$\pi$"]) ax.grid(alpha=0.25) print(f"{i:3d} {p.t1:11.6f} {p.t2:11.6f} {k_min / np.pi:13.7f} " f"{e_min:14.8f} {label}") for i in range(args.n, nrows * ncols): axes.flat[i].set_visible(False) for row in range(nrows): axes[row, 0].set_ylabel("Energy") for ax in axes[-1, :]: if ax.get_visible(): ax.set_xlabel("Wave vector $k$") fig.suptitle(r"1D TB bands: $E(k)=\epsilon_0+2t_1\cos k+2t_2\cos(2k)$", fontsize=14) fig.tight_layout(rect=(0, 0, 1, 0.96)) if args.output: fig.savefig(args.output, dpi=args.dpi, bbox_inches="tight") print(f"\nSaved figure: {args.output}") if args.no_show: plt.close(fig) else: plt.show() if __name__ == "__main__": main()