Files
chenproject/fiber_delay_sim/cli.py
2026-10-12 16:25:51 +08:00

167 lines
7.5 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""命令行入口(本地层)。
用法:
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)并汇总记录包。"""
from .experiments import (exp01_m0_baseline, exp02_fiber_design,
exp03_m2_calibration, exp04_m3_algorithms,
exp05_m4_statistics)
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("\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)
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}
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)
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")
p2.add_argument("which", choices=["m0", "m1", "m2", "m3", "m4"])
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:])