update at 2026-10-12 14:26:51

This commit is contained in:
douboer
2026-10-12 14:26:51 +08:00
parent ae1c774606
commit 7a225ff2b1
51 changed files with 13426 additions and 8 deletions

90
fiber_delay_sim/cli.py Normal file
View File

@@ -0,0 +1,90 @@
"""命令行入口(本地层)。
用法:
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:])