"""命令行入口(本地层)。 用法: python -m fiber_delay_sim.cli m0 [--tau 52.8] [--snr-db 50] [--repeats 20] [--seed 42] python -m fiber_delay_sim.cli design [--nominal | --lengths 0,9.7,19.4,29.1 | --targets 0,2.5,5,7.5] """ import argparse import sys def cmd_m0(args): from .experiments import exp01_m0_baseline exp01_m0_baseline.run(tau=args.tau, window_ns=args.window_ns, snr_db=args.snr_db, bits=args.bits, repeats=args.repeats, seed=args.seed, runs_dir=args.runs_dir) def cmd_design(args): from .core import fiber if args.targets: targets = [float(x) for x in args.targets.split(",")] inv = fiber.inverse_design(targets, dt_ns=args.dt, n_g=args.ng) print(f"目标相位:{inv['target_phases_ns']} ns(Δt = {args.dt} ns,n_g = {args.ng})") print(f"均匀网格:{'是' if inv['is_uniform_grid'] else '否(等效网格将不均匀)'}") if inv["construction"]: print(f"构造式:{inv['construction']}") if inv["recommended"]: print("\n推荐解:") print(f"{'目标相位 ns':>12} {'通道 k':>8} {'延时 ns':>10} {'长度 m':>10}") for e in inv["recommended"]: print(f"{e['phase_ns']:>12.2f} {e['k']:>8d} {e['delay_ns']:>10.2f} " f"{e['length_m']:>10.3f}") else: print("\n候选表(每相位前 5 个):") for cand in inv["candidates"]: ph = cand[0]["phase_ns"] print(f" φ = {ph:.2f} ns:", ", ".join( f"m={c['m']}→δ={c['delay_ns']:.1f}ns,L={c['length_m']:.2f}m" for c in cand[:5])) else: lengths = (fiber.NOMINAL_LENGTHS_M if args.nominal else [float(x) for x in args.lengths.split(",")]) fwd = fiber.forward_design(lengths_m=lengths, n_g=args.ng, dt_ns=args.dt) print(f"{'通道':>6} {'长度 m':>10} {'延时 ns':>12} {'相位 ns':>10}") for ch in fwd["channels"]: print(f"{'CH%d' % (ch['index'] + 1):>6} {ch['length_m']:>10.3f} " f"{ch['delay_ns']:>12.3f} {ch['phase_ns']:>10.3f}") print(f"排序后等效采样网格:{[round(p, 3) for p in fwd['sorted_phases_ns']]} ns") u = fwd["uniformity"] print(f"均匀性:理想步长 {u['ideal_step_ns']} ns," f"最大间隔偏差 {u['max_gap_dev_ns']:.3g} ns") if args.plot: from .experiments import exp02_fiber_design exp02_fiber_design.run(runs_dir=args.runs_dir) def cmd_all(args): """M5:一键运行全部实验(M0–M4 + M4 扫描)并汇总记录包。""" from .experiments import (exp01_m0_baseline, exp02_fiber_design, exp03_m2_calibration, exp04_m3_algorithms, exp05_m4_statistics, exp06_m4_scan) dirs = [] print("=" * 60) print("M0 最小程序") dirs.append(exp01_m0_baseline.run(tau=args.tau, window_ns=args.window_ns, snr_db=args.snr_db, bits=args.bits, repeats=args.repeats, seed=args.seed, runs_dir=args.runs_dir)) print("=" * 60) print("M1 光纤设计") dirs.append(exp02_fiber_design.run(runs_dir=args.runs_dir)) print("=" * 60) print("M2 误差与校准") dirs.append(exp03_m2_calibration.run(seed=args.seed, runs_dir=args.runs_dir)) print("=" * 60) print("M3 算法对比") dirs.append(exp04_m3_algorithms.run(seeds=args.seeds, runs_dir=args.runs_dir)) print("=" * 60) print("M4 统计分析") dirs.append(exp05_m4_statistics.run(repeats=args.repeats, runs_dir=args.runs_dir)) print("=" * 60) print("M4 补充:SNR×窗口 参数扫描") dirs.append(exp06_m4_scan.run(repeats=min(args.repeats, 40), runs_dir=args.runs_dir)) print("\n全部完成,记录包:") for d in dirs: print(f" - {d}") def cmd_run_one(args): from .experiments import (exp01_m0_baseline, exp02_fiber_design, exp03_m2_calibration, exp04_m3_algorithms, exp05_m4_statistics, exp06_m4_scan) table = {"m0": exp01_m0_baseline.run, "m1": exp02_fiber_design.run, "m2": exp03_m2_calibration.run, "m3": exp04_m3_algorithms.run, "m4": exp05_m4_statistics.run, "scan": exp06_m4_scan.run} if args.which not in table: print(f"未知实验 {args.which},可选:{list(table)}") return if args.which == "m0": table["m0"](tau=args.tau, window_ns=args.window_ns, snr_db=args.snr_db, bits=args.bits, repeats=args.repeats, seed=args.seed, runs_dir=args.runs_dir) elif args.which == "m1": table["m1"](runs_dir=args.runs_dir) elif args.which == "m2": table["m2"](seed=args.seed, runs_dir=args.runs_dir) elif args.which == "m3": table["m3"](seeds=args.seeds, runs_dir=args.runs_dir) elif args.which == "m4": table["m4"](repeats=args.repeats, runs_dir=args.runs_dir) elif args.which == "scan": table["scan"](repeats=min(args.repeats, 40), runs_dir=args.runs_dir) def cmd_gui(args): """M5:图形界面(tkinter 六页面 + 一键导出)。""" from .gui import main as gui_main argv = ["--selftest"] if args.selftest else [] argv += ["--runs-dir", args.runs_dir] gui_main(argv) def main(argv=None): ap = argparse.ArgumentParser(prog="fiber_delay_sim", description="光纤延时等效采样教学实验仿真软件") sub = ap.add_subparsers(dest="cmd", required=True) p0 = sub.add_parser("m0", help="M0 最小实验:信号+采样+噪声+拟合") p0.add_argument("--tau", type=float, default=52.8) p0.add_argument("--window-ns", type=float, default=400.0) p0.add_argument("--snr-db", type=float, default=50.0) p0.add_argument("--bits", type=int, default=12) p0.add_argument("--repeats", type=int, default=20) p0.add_argument("--seed", type=int, default=42) p0.add_argument("--runs-dir", default="runs") p0.set_defaults(func=cmd_m0) p1 = sub.add_parser("design", help="光纤长度设计:正向/反向") g = p1.add_mutually_exclusive_group(required=True) g.add_argument("--nominal", action="store_true", help="载入原项目名义四组") g.add_argument("--lengths", help="逗号分隔的光纤长度(m)") g.add_argument("--targets", help="逗号分隔的目标相位(ns)") p1.add_argument("--dt", type=float, default=10.0) p1.add_argument("--ng", type=float, default=1.468) p1.add_argument("--plot", action="store_true", help="生成图表并落盘记录包") p1.add_argument("--runs-dir", default="runs") p1.set_defaults(func=cmd_design) p2 = sub.add_parser("run", help="运行单个实验:m0/m1/m2/m3/m4/scan") p2.add_argument("which", choices=["m0", "m1", "m2", "m3", "m4", "scan"]) p2.add_argument("--tau", type=float, default=52.8) p2.add_argument("--window-ns", type=float, default=400.0) p2.add_argument("--snr-db", type=float, default=50.0) p2.add_argument("--bits", type=int, default=12) p2.add_argument("--repeats", type=int, default=100) p2.add_argument("--seeds", type=int, default=8) p2.add_argument("--seed", type=int, default=42) p2.add_argument("--runs-dir", default="runs") p2.set_defaults(func=cmd_run_one) p3 = sub.add_parser("all", help="M5:一键运行全部实验(M0–M4 + 扫描)") p3.add_argument("--tau", type=float, default=52.8) p3.add_argument("--window-ns", type=float, default=400.0) p3.add_argument("--snr-db", type=float, default=50.0) p3.add_argument("--bits", type=int, default=12) p3.add_argument("--repeats", type=int, default=100) p3.add_argument("--seeds", type=int, default=8) p3.add_argument("--seed", type=int, default=42) p3.add_argument("--runs-dir", default="runs") p3.set_defaults(func=cmd_all) p4 = sub.add_parser("gui", help="M5:图形界面(六页面)") p4.add_argument("--selftest", action="store_true", help="无界面自检") p4.add_argument("--runs-dir", default="runs") p4.set_defaults(func=cmd_gui) args = ap.parse_args(argv) args.func(args) if __name__ == "__main__": main(sys.argv[1:])