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