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

91 lines
4.0 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 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:])