"""M5:简单图形界面(tkinter 六页面)+ 一键导出记录包。 对应任务书"软件界面与操作顺序"六页面: 1. 参数与方案 2. 原始采样 3. 校准与重建 4. 拟合与比较 5. 参数扫描 6. 结果导出 全部计算复用 core/pipeline(零重写);每个页面产出图表与数值, 结果导出页一键将当前会话的全部参数、数据、图表落盘为可复现记录包。 运行:python -m fiber_delay_sim.gui 自检(无界面):python -m fiber_delay_sim.gui --selftest """ import argparse import csv import json import os import tempfile import threading import traceback import numpy as np from . import pipeline from .core import acquisition, calibration, fiber, fitting, signal, statistics from .export import record try: import matplotlib matplotlib.use("TkAgg") matplotlib.rcParams["font.sans-serif"] = [ "PingFang SC", "Hiragino Sans GB", "Arial Unicode MS", "SimHei", "sans-serif"] matplotlib.rcParams["axes.unicode_minus"] = False from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg from matplotlib.figure import Figure import tkinter as tk from tkinter import ttk HAS_TK = True except Exception: # pragma: no cover - 无显示环境 HAS_TK = False DEFAULT_SEED = 42 def _json_default(o): """ndarray → list;numpy 标量 → 原生 float。""" if isinstance(o, np.ndarray): return o.tolist() if isinstance(o, np.generic): return o.item() raise TypeError(f"Object of type {type(o).__name__} is not JSON serializable") # ===================================================================== # 计算层:每个页面一次"运行",产出 dict(图 + 数值),GUI 与导出共用 # ===================================================================== def run_page1(params): """参数与方案:荧光 / ADC / 光纤 → 参数表 + 延时/相位表。""" p = dict(params) sig = signal.resolve_preset(p["preset"], tau=p.get("tau2")) lens = [float(x) for x in p["lengths"]] fwd = fiber.forward_design(lengths_m=lens, n_g=float(p["ng"])) inv = fiber.inverse_design([0.0, p["dt"] / 4, p["dt"] / 2, 3 * p["dt"] / 4], dt_ns=float(p["dt"]), n_g=float(p["ng"])) return { "signal": {k: float(v) for k, v in sig.items()}, "forward": fwd, "inverse": inv, "dt_ns": float(p["dt"]), } def run_page2(params, seed): """原始采样:单通道 + 四通道,连续曲线 + 采样点。""" p = dict(params) sig_params = signal.resolve_preset(p["preset"]) t = np.arange(0.0, float(p["window_ns"]) + pipeline.CONT_STEP_NS / 2, pipeline.CONT_STEP_NS) y = signal.generate(t, sig_params) rng = np.random.default_rng(seed) acq_s = acquisition.run_single_channel(t, y, { "dt_ns": p["dt"], "window_ns": p["window_ns"], "snr_db": p["snr_db"], "bits": p["bits"]}, rng) acq_m = acquisition.run_multi_channel(t, y, { "delays": [float(x) * 4.9 for x in p["lengths"]], "dt_ns": p["dt"], "window_ns": p["window_ns"], "snr_db": p["snr_db"], "bits": p["bits"]}, rng) return { "t": t.tolist(), "y": y.tolist(), "single": {"t": acq_s["t_samples"].tolist(), "y": acq_s["y_samples"].tolist()}, "multi": [{"t": ch["t_adc"].tolist(), "y": ch["y_samples"].tolist(), "delay": float(ch["delay_ns"])} for ch in acq_m["channels"]], "n_single": int(acq_s["n_samples"]), "n_multi": int(sum(len(ch["t_adc"]) for ch in acq_m["channels"])), } def run_page3(params, seed, method="nominal"): """校准与重建:三方案对比(不校准/基线+增益/完整校准)。""" p = dict(params) p["gain_errors"] = [0.0, 0.10 * p.get("gain_amp", 1.0), -0.08 * p.get("gain_amp", 1.0), 0.06 * p.get("gain_amp", 1.0)] p["delay_errors"] = [0.0, 0.5 * p.get("delay_amp", 1.0), -0.4 * p.get("delay_amp", 1.0), 0.3 * p.get("delay_amp", 1.0)] p["baselines"] = [0.0, 0.02 * p.get("base_amp", 1.0), -0.015 * p.get("base_amp", 1.0), 0.01 * p.get("base_amp", 1.0)] rec = pipeline.run_m2(p, int(seed)) out = {"tau_true": rec["tau_true"]} for key in ("raw", "nominal", "calibrated"): d = rec[key] out[key] = {"t": d["t"].tolist(), "y": d["y"].tolist(), "tau": d["tau_hat"], "n": d["n_points"], "jump": d["continuity"]["mean_jump"]} return out def run_page4(params, seed, snr=None): """拟合与比较:NLS vs 对数线性 + 置信区间。""" snr = float(params.get("snr_db", 50)) if snr is None else float(snr) dt = float(params["dt"]) t = np.arange(0.0, float(params["window_ns"]) + dt / 2, dt) y_true = np.exp(-t / 52.8) sigma = np.max(y_true) * 10 ** (-snr / 20) rng = np.random.default_rng(int(seed)) yn = y_true + rng.normal(0, sigma, len(t)) r1 = fitting.fit_single_exp_nls(t, yn) r2 = fitting.fit_log_linear(t, yn) r3 = fitting.fit_single_exp_robust(t, yn) return { "t": t.tolist(), "y": yn.tolist(), "true": 52.8, "nls": {"tau": r1["tau"], "A": r1["A"], "B": r1["B"]}, "ll": {"tau": r2["tau"], "A": r2["A"], "B": r2["B_est"], "dropped": r2["dropped_points"]}, "rob": {"tau": r3["tau"], "A": r3["A"], "B": r3["B"]}, } def run_page5(params, seed, repeats=8): """第5页:扫描窗口 → 单通道 vs 四相位 τ₂ rel_std。""" wins = [100, 200, 300, 400] rows = [] for w in wins: p = dict(pipeline.M4_DEFAULTS) p["window_ns"] = float(w) p["snr_db"] = float(params.get("snr_db", 50)) st_s = statistics.monte_carlo(lambda sd: pipeline._gen_single(sd, p), repeats=repeats, seed=seed, tau_true=52.8) st_f = statistics.monte_carlo(lambda sd: pipeline._gen_fiber(sd, p), repeats=repeats, seed=seed, tau_true=52.8) rows.append({"window": w, "single": st_s["rel_std"] * 100 if st_s["rel_std"] else None, "fiber": st_f["rel_std"] * 100 if st_f["rel_std"] else None}) return {"rows": rows} def run_page6(all_results, params, seed): """第6页:一键导出当前会话 → 记录包。""" notes = params.get("notes", "M5 GUI 会话导出") with tempfile.TemporaryDirectory() as tmp: run_dir = record.save_run( tmp, "m5_gui_session", records=[{"scan": all_results.get("page5", {}).get("rows", [])}], data_csvs=[("page5_scan", all_results.get("page5", {}).get("rows", []))], notes=notes, seed=seed, extra_meta={"gui_params": params}, ) # 读取并返回内容供 UI 展示(不依赖 mpl 图) return run_dir # ===================================================================== # tkinter 界面 # ===================================================================== class GuiApp: def __init__(self, root, workdir="runs"): self.root = root self.workdir = workdir self.params = { "preset": "monte_carlo", "tau": 52.8, "a": 1.0, "dt": 10.0, "bits": 12, "window_ns": 400.0, "snr_db": 50.0, "ng": 1.468, "lengths": [0.0, 9.7, 19.4, 29.1], "gain_amp": 1.0, "delay_amp": 1.0, "base_amp": 1.0, } self.seed = DEFAULT_SEED self.results = {} self._build() # ---------- 布局 ---------- def _build(self): self.root.title("光纤延时等效采样 · 教学实验仿真(M5 GUI)") nb = ttk.Notebook(self.root) nb.pack(fill="both", expand=True) self.p1 = ttk.Frame(nb) self.p2 = ttk.Frame(nb) self.p3 = ttk.Frame(nb) self.p4 = ttk.Frame(nb) self.p5 = ttk.Frame(nb) self.p6 = ttk.Frame(nb) nb.add(self.p1, text="1 参数方案") nb.add(self.p2, text="2 原始采样") nb.add(self.p3, text="3 校准重建") nb.add(self.p4, text="4 拟合比较") nb.add(self.p5, text="5 参数扫描") nb.add(self.p6, text="6 结果导出") self._build_p1() self._build_p2() self._build_p3() self._build_p4() self._build_p5() self._build_p6() # 状态栏 self.status = tk.Label(self.root, text="就绪", anchor="w", relief="sunken") self.status.pack(fill="x", side="bottom") def _canvas(self, parent): fig = Figure(figsize=(5.2, 3.4), dpi=100) ax = fig.add_subplot(111) canvas = FigureCanvasTkAgg(fig, master=parent) canvas.get_tk_widget().pack(fill="both", expand=True) return fig, ax, canvas def _p1(self): return self.p1, self._canvas(self.p1) # ====== 页面 1:参数方案 ====== def _build_p1(self): fr = ttk.LabelFrame(self.p1, text="物理参数") fr.pack(fill="x", padx=6, pady=4) self.v_tau = tk.DoubleVar(value=self.params["tau"]) self.v_dt = tk.DoubleVar(value=self.params["dt"]) self.v_ng = tk.DoubleVar(value=self.params["ng"]) ttk.Label(fr, text="τ₂ (ns)").grid(row=0, column=0, sticky="e") ttk.Entry(fr, textvariable=self.v_tau, width=8).grid(row=0, column=1) ttk.Label(fr, text="采样间隔 (ns)").grid(row=0, column=2, sticky="e") ttk.Entry(fr, textvariable=self.v_dt, width=8).grid(row=0, column=3) ttk.Label(fr, text="n_g").grid(row=0, column=4, sticky="e") ttk.Entry(fr, textvariable=self.v_ng, width=8).grid(row=0, column=5) self.v_len = [tk.DoubleVar(value=v) for v in self.params["lengths"]] ttk.Label(fr, text="光纤长度 L0-L3 (m)").grid(row=1, column=0, sticky="e") for i, v in enumerate(self.v_len): ttk.Entry(fr, textvariable=v, width=6).grid(row=1, column=1 + i) self.lbl_fwd = ttk.Label(fr, text="", foreground="#234") self.lbl_fwd.grid(row=2, column=0, columnspan=6, sticky="w") self.fig_p1, self.ax_p1, self.canvas_p1 = self._canvas(self.p1) btn = ttk.Button(self.p1, text="运行 · 参数方案", command=self._run_p1) btn.pack(pady=4) def _run_p1(self): try: lengths = [v.get() for v in self.v_len] res = run_page1({ "preset": "monte_carlo", "tau": self.v_tau.get(), "dt": self.v_dt.get(), "ng": self.v_ng.get(), "lengths": lengths, }) self.results["page1"] = res self._draw_phase(None, res["forward"]) self._msg("参数方案已运行:均匀性 " + str(res["forward"].get("uniformity"))) except Exception: self._msg("失败:" + traceback.format_exc(limit=2)) # ====== 页面2:原始采样 ====== def _build_p2(self): fr = ttk.LabelFrame(self.p2, text="采样参数") fr.pack(fill="x", padx=6, pady=4) self.v_snr = tk.DoubleVar(value=self.params["snr_db"]) self.v_bits = tk.IntVar(value=self.params["bits"]) ttk.Label(fr, text="SNR (dB)").grid(row=0, column=0, sticky="e") ttk.Entry(fr, textvariable=self.v_snr, width=8).grid(row=0, column=1) ttk.Label(fr, text="ADC bits").grid(row=0, column=2, sticky="e") ttk.Entry(fr, textvariable=self.v_bits, width=6).grid(row=0, column=3) ttk.Button(fr, text="重新采样", command=self._run_p2).grid(row=0, column=4, padx=6) self.lbl_p2 = ttk.Label(fr, text="", foreground="#234") self.lbl_p2.grid(row=1, column=0, columnspan=5, sticky="w") self.fig_p2, self.ax_p2, self.canvas_p2 = self._canvas(self.p2) self.canvas_p2.get_tk_widget().pack_forget() # 需要时再显示 def _run_p2(self): try: p = dict(self.params) p["snr_db"] = float(self.v_snr.get()) p["bits"] = int(self.v_bits.get()) res = run_page2(p, self.seed) self.results["page2"] = res self.ax_p2.clear() self.ax_p2.plot(res["t"], res["y"], "-", lw=1, label="理想") self.ax_p2.plot(res["single"]["t"], res["single"]["y"], "o", ms=3, label="单通道") for ch in res["multi"]: self.ax_p2.plot([t + ch["delay"] for t in ch["t"]], ch["y"], "x", ms=3, label=f"CH φ={ch['delay'] % 10:.1f}ns") self.ax_p2.set_xlabel("t (ns)"); self.ax_p2.set_ylabel("I") self.ax_p2.legend(fontsize=7, ncol=2) self.canvas_p2.draw() self.lbl_p2.config(text=f"单通道 {res['n_single']} 点 / 四通道共 {res['n_multi']} 点") except Exception: self._msg("失败:" + traceback.format_exc(limit=2)) # ====== 页面3:校准重建 ====== def _build_p3(self): fr = ttk.LabelFrame(self.p3, text="误差注入与校准") fr.pack(fill="x", padx=6, pady=4) self.v_gain = tk.StringVar(value="1.0") self.v_delay = tk.StringVar(value="1.0") self.v_base = tk.StringVar(value="1.0") for i, (txt, v) in enumerate([("增益失配", self.v_gain), ("延时误差", self.v_delay), ("基线偏置", self.v_base)]): ttk.Label(fr, text=txt).grid(row=0, column=i * 2, sticky="e") ttk.Entry(fr, textvariable=v, width=6).grid(row=0, column=i * 2 + 1) self.fig_p3, self.ax_p3, self.canvas_p3 = self._canvas(self.p3) self.lbl_p3 = ttk.Label(self.p3, text="") self.lbl_p3.pack() ttk.Button(self.p3, text="运行校准对比", command=self._run_p3).pack(pady=2) def _run_p3(self): try: p = dict(self.params) p["gain_amp"] = float(self.v_gain.get()) p["delay_amp"] = float(self.v_delay.get()) p["base_amp"] = float(self.v_base.get()) res = run_page3(p, self.seed) self.results["page3"] = res self.ax_p3.clear() for key, color, label in (("raw", "#C25B2A", "不校准"), ("nominal", "#6B2A35", "基线+增益"), ("calibrated", "#2D5F8A", "完整校准")): d = res[key] self.ax_p3.plot(d["t"], d["y"], ".", ms=2, color=color, label=label) self.ax_p3.legend(fontsize=7) self.canvas_p3.draw() self.lbl_p3.config(text=(f"τ̂ 不校准={res['raw']['tau']:.2f} | 完整校准={res['calibrated']['tau']:.2f} | " f"连续度 {res['raw']['jump']:.4f}→{res['calibrated']['jump']:.4f}")) except Exception: self._msg("失败:" + traceback.format_exc(limit=2)) # ====== 页面4:拟合比较 ====== def _build_p4(self): fr = ttk.LabelFrame(self.p4, text="拟合算法比较") fr.pack(fill="x", padx=6, pady=4) self.v_snr4 = tk.StringVar(value="50") ttk.Label(fr, text="SNR (dB)").pack(side="left", padx=4) ttk.Entry(fr, textvariable=self.v_snr4, width=6).pack(side="left") ttk.Button(fr, text="比较", command=self._run_p4).pack(side="left", padx=8) self.lbl_p4 = ttk.Label(fr, text="") self.lbl_p4.pack(side="left", padx=8) self.fig_p4, self.ax_p4, self.canvas_p4 = self._canvas(self.p4) def _run_p4(self): try: res = run_page4(self.params, self.seed, snr=self.v_snr4.get()) self.results["page4"] = res self.ax_p4.clear() self.ax_p4.plot(res["t"], res["y"], "o", ms=2, label="数据") for name, r, c, ls in (("NLS", res["nls"], "#2D5F8A", "-"), ("对数线性", res["ll"], "#C25B2A", "--"), ("稳健", res["rob"], "#4b8a5a", ":")): if r["tau"]: self.ax_p4.plot(res["t"], [r["A"] * np.exp(-t / r["tau"]) + (r.get("B") or 0) for t in res["t"]], ls, color=c, label=name) self.ax_p4.legend(fontsize=7) self.canvas_p4.draw() self.lbl_p4.config(text=(f"NLS τ={res['nls']['tau']:.2f} | 对数线性 τ={res['ll']['tau']:.2f} | " f"稳健 τ={res['rob']['tau']:.2f}(真值 52.8)")) except Exception: self._msg("失败:" + traceback.format_exc(limit=2)) # ====== 页面5:参数扫描 ====== def _build_p5(self): fr = ttk.LabelFrame(self.p5, text="窗口 × SNR 扫描") fr.pack(fill="x", padx=6, pady=4) self.v_snr5 = tk.StringVar(value="50") self.v_reps = tk.StringVar(value="8") ttk.Label(fr, text="SNR (dB)").pack(side="left", padx=4) ttk.Entry(fr, textvariable=self.v_snr5, width=6).pack(side="left") ttk.Label(fr, text="reps").pack(side="left", padx=4) ttk.Entry(fr, textvariable=self.v_reps, width=6).pack(side="left") ttk.Button(fr, text="扫描", command=self._run_p5).pack(side="left", padx=8) self.lbl_p5 = ttk.Label(fr, text="") self.lbl_p5.pack(side="left", padx=8) self.fig_p5, self.ax_p5, self.canvas_p5 = self._canvas(self.p5) def _run_p5(self): try: rows = run_page5(self.params, self.seed, repeats=int(self.v_reps.get()))["rows"] self.results["page5"] = {"rows": rows} self.ax_p5.clear() ws = [r["window"] for r in rows] self.ax_p5.plot(ws, [r["single"] for r in rows], "o-", label="单通道") self.ax_p5.plot(ws, [r["fiber"] for r in rows], "s-", label="四相位") self.ax_p5.set_xlabel("窗口 (ns)"); self.ax_p5.set_ylabel("σ/τ (%)") self.ax_p5.legend(); self.ax_p5.grid(alpha=0.3) self.canvas_p5.draw() self.lbl_p5.config(text=f"SNR={self.v_snr5.get()} dB, reps={self.v_reps.get()}") except Exception: self._msg("失败:" + traceback.format_exc(limit=2)) # ====== 页面6:结果导出 ====== def _build_p6(self): self.lbl_p6 = ttk.Label(self.p6, text="一键导出当前会话:参数 / 数据 / 图表 / 运行信息 全部落盘。") self.lbl_p6.pack(padx=8, pady=8) ttk.Button(self.p6, text="一键导出记录包", command=self._run_p6).pack(pady=4) self.out_p6 = tk.Text(self.p6, height=10, width=70) self.out_p6.pack(fill="both", expand=True, padx=8, pady=8) def _run_p6(self): try: ts = __import__("datetime").datetime.now().strftime("%Y%m%d-%H%M%S") d = os.path.join(self.workdir, f"{ts}-m5_gui_session") os.makedirs(os.path.join(d, "figures"), exist_ok=True) # 1) 页面图表:SVG + PNG figs = [("page1_phases", getattr(self, "canvas_p1", None)), ("page2_sampling", getattr(self, "canvas_p2", None)), ("page3_calibration", getattr(self, "canvas_p3", None)), ("page4_fitting", getattr(self, "canvas_p4", None)), ("page5_scan", getattr(self, "canvas_p5", None))] saved = [] for name, canvas in figs: if canvas is None or not hasattr(canvas, "figure"): continue fig = canvas.figure fig.savefig(os.path.join(d, "figures", f"{name}.png"), dpi=150) fig.savefig(os.path.join(d, "figures", f"{name}.svg")) saved.append(name) # 2) 会话数据 JSON(参数 + 各页结果) with open(os.path.join(d, "session.json"), "w") as f: json.dump({"params": self.params, "seed": self.seed, "results": {k: v for k, v in self.results.items() if k.startswith("page")}}, f, ensure_ascii=False, indent=2, default=_json_default) # 3) page5 扫描表落 CSV rows5 = self.results.get("page5", {}).get("rows", []) if rows5: with open(os.path.join(d, "page5_scan.csv"), "w", newline="") as f: w = csv.DictWriter(f, fieldnames=list(rows5[0].keys())) w.writeheader(); w.writerows(rows5) # 4) meta(诚信标注) with open(os.path.join(d, "meta.json"), "w") as f: json.dump({"created": __import__("datetime").datetime.now().isoformat(timespec="seconds"), "data_origin": "software-simulated", "seed": self.seed, "gui_session": True}, f, ensure_ascii=False, indent=2) # 5) README 说明 with open(os.path.join(d, "README.md"), "w") as f: f.write("# 记录包:M5 GUI 会话导出\n\n" f"- 时间:{ts}\n- 数据来源:**软件仿真(software-simulated)**\n" f"- 图表:{', '.join(saved) if saved else '(无)'}\n") self.out_p6.delete("1.0", "end") self.out_p6.insert("end", f"导出完成:{d}\n") self.out_p6.insert("end", f"包含:session.json(参数+结果)、meta.json、" f"{'page5_scan.csv、' if rows5 else ''}figures/({'、'.join(saved)})\n") self._msg("记录包已导出:" + d) except Exception: self._msg("失败:" + traceback.format_exc(limit=2)) def _draw_phase(self, fig, fwd): self.ax_p1.clear() ch = fwd["channels"] self.ax_p1.scatter([c["delay_ns"] for c in ch], range(len(ch)), s=60, color="#2D5F8A") for c in ch: self.ax_p1.annotate(f"CH{c['index']+1} φ={c['phase_ns']:.2f}ns", (c["delay_ns"], c["index"]), fontsize=8) self.ax_p1.set_xlabel("延时 (ns)"); self.ax_p1.set_ylabel("通道") self.ax_p1.set_title(f"等效网格: " + " / ".join(f"{x:.2f}" for x in fwd.get("sorted_phases_ns", [])) + " ns") self.canvas_p1.draw() def _msg(self, s): self.status.config(text=s) def _msg6(self, s): self.status.config(text=s) def run(self): self.root.mainloop() def main(argv=None): ap = argparse.ArgumentParser(description="M5 图形界面") ap.add_argument("--selftest", action="store_true", help="无界面自检(仅验证可导入与数据函数)") ap.add_argument("--runs-dir", default="runs") a = ap.parse_args(argv) if a.selftest: # 无头自检:验证各页面数据函数可用(不打开窗口) print("[selftest] 校验页面数据函数…") base = {"preset": "monte_carlo", "dt": 10.0, "window_ns": 400.0, "snr_db": 50.0, "ng": 1.468, "lengths": [0.0, 9.7, 19.4, 29.1], "bits": 12, "gain_amp": 1.0, "delay_amp": 1.0, "base_amp": 1.0, "tau": 52.8} print(" page1:", sorted(run_page1(base)["forward"].keys())) r2 = run_page2(base, 42) print(" page2: n_single=%d n_multi=%d" % (r2["n_single"], r2["n_multi"])) r3 = run_page3(base, 42) print(" page3: tau=", round(r3["calibrated"]["tau"], 3)) r4 = run_page4(base, 42) print(" page4: nls=%.3f ll=%.3f" % (r4["nls"]["tau"], r4["ll"]["tau"])) r5 = run_page5(base, 42, repeats=4) print(" page5: rows=%d" % len(r5["rows"])) print("[selftest] 全部通过") return 0 if not HAS_TK: print("当前环境无 tkinter,无法打开 GUI(headless 下可用 --selftest 自检)。") return 1 root = tk.Tk() GuiApp(root, workdir=a.runs_dir) root.mainloop() return 0 if __name__ == "__main__": import os import sys sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__)))) raise SystemExit(main())