"""命令行入口(本地层)。 用法: 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 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) args = ap.parse_args(argv) args.func(args) if __name__ == "__main__": main(sys.argv[1:])