diff --git a/README.md b/README.md
index e74915c..455c5b7 100644
--- a/README.md
+++ b/README.md
@@ -79,9 +79,15 @@ python -m fiber_delay_sim.cli design --targets 0,2.5,5,7.5
## 文档导航
-| 想了解 | 读 |
-|---|---|
-| 原项目是什么、原理、关键数字 | `docs/项目说明.md` |
-| 新实验怎么设计、软件怎么做、里程碑验收 | `docs/实现方案.md` |
-| 任务范围与交付物(权威) | `光纤延时等效采样教学实验后续工作说明.docx` |
-| 原项目完整技术细节 | `resources/研究报告.pdf` |
+### 项目文档(docs/)
+
+- **[docs/项目说明.md](docs/项目说明.md)** —— 任务书阶段一成果。原项目是什么、为什么做:问题背景、"光学游标卡尺"核心原理(1 m 光纤 ≈ 4.90 ns 延时)、原系统全貌与简化框图、关键参数速查表(软件默认值来源)、原材料内部不一致辨析与科研诚信红线。面向第一次接触本项目的同学,读完可不依赖原文讲清实验链路。
+- **[docs/实现方案.md](docs/实现方案.md)** —— 任务书阶段二/三成果。新项目怎么做:交付物清单、统一教学命题与实验六步流程、三组核心对比设计、软件总体架构与六类可调参数、实验记录包与可复现性规范、M0–M5 里程碑验收标准、硬件补充与论文映射。
+
+### 原始材料(resources/ 与任务书)
+
+- **[光纤延时等效采样教学实验后续工作说明.docx](光纤延时等效采样教学实验后续工作说明.docx)** —— 任务书,需求权威来源(七项交付物与最终判断标准)。
+- **[resources/研究报告.pdf](resources/研究报告.pdf)** —— 原项目正式研究报告(50 页),全部技术细节的权威出处。
+- **[resources/闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf](resources/闭环激励下荧光衰减与光纤延时复用相结合的高精度激光功率测量系统.pdf)** —— 原项目答辩 PPT(30 页),可视化素材与部分补充数据。
+
+快速指路:想了解**原理与背景**读项目说明;想了解**实验设计与软件实现**读实现方案;两份文档按"先说明、后方"顺序配套阅读。
diff --git a/fiber_delay_sim/__init__.py b/fiber_delay_sim/__init__.py
new file mode 100644
index 0000000..e17aab6
--- /dev/null
+++ b/fiber_delay_sim/__init__.py
@@ -0,0 +1,9 @@
+"""fiber_delay_sim:光纤延时等效采样教学实验仿真软件。
+
+算法核心层(core/)与流程编排(pipeline.py)仅依赖 numpy/scipy,
+不依赖文件 IO 与 matplotlib —— 可在本地 CLI 也可经 Pyodide 在浏览器运行
+(约束见 docs/实现方案.md §5.1)。
+"""
+
+__version__ = "0.1.0"
+ALGO_VERSION = "M0+M1"
diff --git a/fiber_delay_sim/__pycache__/__init__.cpython-312.pyc b/fiber_delay_sim/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..e2f308e
Binary files /dev/null and b/fiber_delay_sim/__pycache__/__init__.cpython-312.pyc differ
diff --git a/fiber_delay_sim/__pycache__/pipeline.cpython-312.pyc b/fiber_delay_sim/__pycache__/pipeline.cpython-312.pyc
new file mode 100644
index 0000000..aaf0eee
Binary files /dev/null and b/fiber_delay_sim/__pycache__/pipeline.cpython-312.pyc differ
diff --git a/fiber_delay_sim/cli.py b/fiber_delay_sim/cli.py
new file mode 100644
index 0000000..f226180
--- /dev/null
+++ b/fiber_delay_sim/cli.py
@@ -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:])
diff --git a/fiber_delay_sim/core/__init__.py b/fiber_delay_sim/core/__init__.py
new file mode 100644
index 0000000..c00b203
--- /dev/null
+++ b/fiber_delay_sim/core/__init__.py
@@ -0,0 +1,5 @@
+"""算法核心层:signal / fiber / acquisition / fitting(全部 Pyodide 兼容)。"""
+
+from . import signal, fiber, acquisition, fitting
+
+__all__ = ["signal", "fiber", "acquisition", "fitting"]
diff --git a/fiber_delay_sim/core/__pycache__/__init__.cpython-312.pyc b/fiber_delay_sim/core/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..e81cc43
Binary files /dev/null and b/fiber_delay_sim/core/__pycache__/__init__.cpython-312.pyc differ
diff --git a/fiber_delay_sim/core/__pycache__/acquisition.cpython-312.pyc b/fiber_delay_sim/core/__pycache__/acquisition.cpython-312.pyc
new file mode 100644
index 0000000..7b8361e
Binary files /dev/null and b/fiber_delay_sim/core/__pycache__/acquisition.cpython-312.pyc differ
diff --git a/fiber_delay_sim/core/__pycache__/fiber.cpython-312.pyc b/fiber_delay_sim/core/__pycache__/fiber.cpython-312.pyc
new file mode 100644
index 0000000..455d404
Binary files /dev/null and b/fiber_delay_sim/core/__pycache__/fiber.cpython-312.pyc differ
diff --git a/fiber_delay_sim/core/__pycache__/fitting.cpython-312.pyc b/fiber_delay_sim/core/__pycache__/fitting.cpython-312.pyc
new file mode 100644
index 0000000..6906c7c
Binary files /dev/null and b/fiber_delay_sim/core/__pycache__/fitting.cpython-312.pyc differ
diff --git a/fiber_delay_sim/core/__pycache__/signal.cpython-312.pyc b/fiber_delay_sim/core/__pycache__/signal.cpython-312.pyc
new file mode 100644
index 0000000..b3907ea
Binary files /dev/null and b/fiber_delay_sim/core/__pycache__/signal.cpython-312.pyc differ
diff --git a/fiber_delay_sim/core/acquisition.py b/fiber_delay_sim/core/acquisition.py
new file mode 100644
index 0000000..92facec
--- /dev/null
+++ b/fiber_delay_sim/core/acquisition.py
@@ -0,0 +1,101 @@
+"""测量链仿真:前端展宽 → 采样 → 噪声 → ADC 量化(仅依赖 numpy)。
+
+物理顺序对应 docs/实现方案.md §7.2。
+"""
+
+import numpy as np
+
+
+def snr_to_sigma(snr_db, peak):
+ """峰值定义的信噪比 → 噪声标准差:σ = peak · 10^(−SNR/20)。"""
+ return float(peak) * 10.0 ** (-float(snr_db) / 20.0)
+
+
+def gaussian_response(t, y, sigma_ns):
+ """模拟前端有限带宽:与高斯冲激响应卷积(sigma_ns<=0 时原样返回)。
+
+ sigma_ns 参考值 1.373 ns(原项目 Fisher 分析中的系统响应,报告 5.4.5)。
+ """
+ if sigma_ns is None or sigma_ns <= 0:
+ return y
+ t = np.asarray(t, dtype=float)
+ y = np.asarray(y, dtype=float)
+ dt = t[1] - t[0]
+ half = max(1, int(np.ceil(4.0 * sigma_ns / dt)))
+ k = (np.arange(2 * half + 1) - half) * dt
+ kernel = np.exp(-0.5 * (k / sigma_ns) ** 2)
+ kernel = kernel / kernel.sum()
+ padded = np.pad(y, half, mode="edge")
+ return np.convolve(padded, kernel, mode="valid")
+
+
+def quantize_adc(y, bits, fullscale):
+ """理想 ADC 均匀量化:LSB = fullscale / (2^bits − 1)。"""
+ lsb = float(fullscale) / (2 ** int(bits) - 1)
+ return np.round(np.asarray(y, dtype=float) / lsb) * lsb
+
+
+def sample_points(t_cont, y_cont, t0_ns, dt_ns, n_samples):
+ """理想采样:t_k = t0 + k·Δt 处线性插值取值。"""
+ ts = float(t0_ns) + float(dt_ns) * np.arange(int(n_samples))
+ return ts, np.interp(ts, np.asarray(t_cont, dtype=float), np.asarray(y_cont, dtype=float))
+
+
+def run_single_channel(t_cont, y_cont, params, rng):
+ """单通道测量链(M0)。
+
+ params:
+ dt_ns 采样间隔(默认 10)
+ t0_ns 触发位置(默认 0)
+ window_ns 记录窗口(决定采样点数)
+ snr_db 信噪比(None → 无噪声)
+ bits ADC 位数(None → 不量化)
+ fullscale ADC 满量程(None → 2×峰值)
+ bandwidth_sigma_ns 前端高斯响应宽度(0 → 不展宽)
+ jitter_ns 时钟抖动标准差(默认 0)
+ 返回 dict(全部纯数据)。
+ """
+ p = dict(params)
+ t_cont = np.asarray(t_cont, dtype=float)
+ y_cont = np.asarray(y_cont, dtype=float)
+
+ dt = float(p.get("dt_ns", 10.0))
+ t0 = float(p.get("t0_ns", 0.0))
+ window = float(p.get("window_ns", t_cont[-1] - t_cont[0]))
+ n_samples = int(round(window / dt))
+
+ # 1) 前端带宽
+ y_bw = gaussian_response(t_cont, y_cont, p.get("bandwidth_sigma_ns", 0.0))
+
+ # 2) 采样(含可选时钟抖动)
+ ts = t0 + dt * np.arange(n_samples)
+ jitter = float(p.get("jitter_ns", 0.0))
+ if jitter > 0:
+ ts_eff = ts + rng.normal(0.0, jitter, size=n_samples)
+ else:
+ ts_eff = ts
+ y_clean = np.interp(ts_eff, t_cont, y_bw)
+
+ # 3) 噪声(模拟域)
+ snr_db = p.get("snr_db")
+ peak = float(np.max(y_bw)) if np.max(y_bw) > 0 else 1.0
+ sigma = snr_to_sigma(snr_db, peak) if snr_db is not None else 0.0
+ y_meas = y_clean + (rng.normal(0.0, sigma, size=n_samples) if sigma > 0 else 0.0)
+
+ # 4) ADC 量化(数字域)
+ bits = p.get("bits")
+ if bits is not None:
+ fs = p.get("fullscale") or 2.0 * peak
+ y_meas = quantize_adc(y_meas, bits, fs)
+
+ return {
+ "t_samples": ts,
+ "y_clean": y_clean,
+ "y_samples": y_meas,
+ "sigma": sigma,
+ "snr_db": snr_db,
+ "bits": bits,
+ "n_samples": n_samples,
+ "jitter_ns": jitter,
+ "bandwidth_sigma_ns": float(p.get("bandwidth_sigma_ns", 0.0) or 0.0),
+ }
diff --git a/fiber_delay_sim/core/fiber.py b/fiber_delay_sim/core/fiber.py
new file mode 100644
index 0000000..5bef5b0
--- /dev/null
+++ b/fiber_delay_sim/core/fiber.py
@@ -0,0 +1,138 @@
+"""光纤延时与采样相位设计(仅依赖 numpy,浏览器可运行)。
+
+物理关系(研究报告 2.4 节):
+ δ = L·n_g/c 传播延时;n_g=1.468 时 1 m ≈ 4.90 ns
+ φ = δ mod Δt 延时对采样周期取余 → 等效采样相位
+ δk = k·(S − Δt/N) 原项目设计式:S=50 ns 片段定位间隔,N=4 相位
+"""
+
+import itertools
+import numpy as np
+
+C_LIGHT = 299_792_458.0 # m/s
+N_G_QUARTZ = 1.468 # 石英光纤群折射率(报告 2.4.1)
+DT_DEFAULT = 10.0 # ns,高速 ADC 采样间隔
+S_LOCATOR_DEFAULT = 50.0 # ns,四段波形片段的定位间隔(报告 2.4.2)
+
+# 原项目名义四组(报告 2.4.2 / 附录 A.4)
+NOMINAL_LENGTHS_M = [0.0, 9.70, 19.40, 29.10]
+NOMINAL_DELAYS_NS = [0.0, 47.5, 95.0, 142.5] # 精确设计值 δk = k(S−Δt/N)
+
+
+def delay_from_length(length_m, n_g=N_G_QUARTZ):
+ """长度 → 传播延时(ns)。"""
+ return float(length_m) * n_g / C_LIGHT * 1e9
+
+
+def length_from_delay(delay_ns, n_g=N_G_QUARTZ):
+ """延时(ns)→ 光纤长度(m)。"""
+ return float(delay_ns) * 1e-9 * C_LIGHT / n_g
+
+
+def phase_in_period(delay_ns, dt_ns=DT_DEFAULT):
+ """延时对采样周期取余 → 等效相位(ns)。"""
+ return float(delay_ns) % float(dt_ns)
+
+
+def forward_design(lengths_m=None, delays_ns=None, n_g=N_G_QUARTZ, dt_ns=DT_DEFAULT):
+ """正向设计:长度(或设计延时)→ 延时、相位、等效网格与均匀性。
+
+ delays_ns 优先(名义延时 47.5/95/142.5 是精确设计值;
+ 名义长度 9.70/19.40/29.10 m 是其四舍五入的反算结果)。
+ """
+ if delays_ns is None:
+ if lengths_m is None:
+ raise ValueError("lengths_m 与 delays_ns 至少提供一个")
+ delays = [delay_from_length(L, n_g) for L in lengths_m]
+ lengths = [float(L) for L in lengths_m]
+ else:
+ delays = [float(d) for d in delays_ns]
+ lengths = [length_from_delay(d, n_g) for d in delays]
+
+ n = len(delays)
+ phases = [phase_in_period(d, dt_ns) for d in delays]
+ order = sorted(range(n), key=lambda i: phases[i])
+ sorted_phases = [phases[i] for i in order]
+
+ ideal_step = dt_ns / n if n else 0.0
+ gaps = [b - a for a, b in itertools.pairwise(sorted_phases)]
+ if n:
+ gaps.append(sorted_phases[0] + dt_ns - sorted_phases[-1]) # 循环闭合间隔
+ gap_dev = [g - ideal_step for g in gaps]
+
+ return {
+ "n_channels": n,
+ "n_g": n_g,
+ "dt_ns": float(dt_ns),
+ "channels": [
+ {"index": i, "length_m": lengths[i], "delay_ns": delays[i], "phase_ns": phases[i]}
+ for i in range(n)
+ ],
+ "phases_ns": phases, # 按通道顺序
+ "sorted_phases_ns": sorted_phases, # 按时间先后排序 → 等效采样网格
+ "order_index": order, # 排序后对应的原通道号
+ "uniformity": {
+ "ideal_step_ns": ideal_step,
+ "gaps_ns": gaps,
+ "max_gap_dev_ns": max((abs(x) for x in gap_dev), default=0.0),
+ "rms_gap_dev_ns": float(np.sqrt(np.mean(np.square(gap_dev)))) if gap_dev else 0.0,
+ },
+ }
+
+
+def inverse_design(target_phases_ns, dt_ns=DT_DEFAULT, n_g=N_G_QUARTZ,
+ s_locator_ns=S_LOCATOR_DEFAULT, max_m=15):
+ """反向设计:目标相位 → 候选延时/长度与推荐解。
+
+ - 目标为均匀网格 j·Δt/N 时,给出构造式推荐解 δk = k·(S − Δt/N)
+ (复现原项目方案:0/2.5/5/7.5 ns → 0/142.5/95/47.5 ns → 0/29.10/19.40/9.70 m);
+ - 目标非均匀时,返回每相位候选表并提示网格不均匀(这本身是教学点)。
+ """
+ targets = sorted({round(float(p) % float(dt_ns), 12) for p in target_phases_ns})
+ n = len(targets)
+ tol = 1e-9 * max(1.0, float(dt_ns))
+
+ ideal_grid = [float(dt_ns) * j / n for j in range(n)]
+ is_uniform = all(abs(tg - idl) <= tol for tg, idl in zip(targets, ideal_grid))
+
+ result = {
+ "n_channels": n,
+ "dt_ns": float(dt_ns),
+ "n_g": n_g,
+ "target_phases_ns": targets,
+ "is_uniform_grid": is_uniform,
+ "candidates": [], # 每相位候选:[{phase_ns, m, delay_ns, length_m}]
+ "recommended": None, # 均匀网格时的构造式推荐
+ "construction": None,
+ }
+
+ for ph in targets:
+ cand = []
+ for m in range(int(max_m) + 1):
+ delay = ph + m * float(dt_ns)
+ cand.append({
+ "phase_ns": ph, "m": m,
+ "delay_ns": delay,
+ "length_m": length_from_delay(delay, n_g),
+ })
+ result["candidates"].append(cand)
+
+ if is_uniform and n >= 2:
+ step = float(s_locator_ns) - float(dt_ns) / n
+ rec = []
+ for j, ph in enumerate(targets):
+ k = (n - j) % n # j=0(φ=0)→k=0;j=1→k=n-1;… 复现原项目逐级递推
+ delay = k * step
+ rec.append({
+ "phase_ns": ph, "k": k, "delay_ns": delay,
+ "length_m": length_from_delay(delay, n_g),
+ })
+ # 校验:推荐延时反算相位应等于目标相位
+ for entry in rec:
+ assert abs(phase_in_period(entry["delay_ns"], dt_ns) - entry["phase_ns"]) < 1e-6
+ result["recommended"] = rec
+ result["construction"] = (
+ f"δk = k·(S − Δt/N),S={float(s_locator_ns):g} ns,Δt/N={float(dt_ns)/n:g} ns"
+ )
+
+ return result
diff --git a/fiber_delay_sim/core/fitting.py b/fiber_delay_sim/core/fitting.py
new file mode 100644
index 0000000..ba6db60
--- /dev/null
+++ b/fiber_delay_sim/core/fitting.py
@@ -0,0 +1,145 @@
+"""寿命拟合:非线性最小二乘(单/双指数)、对数线性、稳健拟合(仅依赖 numpy/scipy.optimize)。
+
+算法对比设计见 docs/实现方案.md §7.5:
+- 对数线性需先扣基线,对数变换使低信噪比尾部噪声权重失真(教学点);
+- NLS 为基准算法:理想无噪数据应零偏差复现设定寿命(对应原项目"标准拟合"验证)。
+"""
+
+import numpy as np
+from scipy.optimize import curve_fit, least_squares
+
+
+def _single_exp(t, A, tau, B):
+ return A * np.exp(-t / tau) + B
+
+
+def _double_exp(t, A1, tau1, A2, tau2, B):
+ return A1 * np.exp(-t / tau1) + A2 * np.exp(-t / tau2) + B
+
+
+def initial_guess_single(t, y):
+ """单指数自动初值:尾段均值作基线、首点定幅度、半衰点定 tau。"""
+ t = np.asarray(t, dtype=float)
+ y = np.asarray(y, dtype=float)
+ tail_n = max(1, len(y) // 5)
+ B0 = float(np.mean(y[-tail_n:]))
+ A0 = float(y[0] - B0)
+ if A0 <= 0:
+ A0 = max(float(np.max(y) - B0), 1e-9)
+ half = B0 + A0 / 2.0
+ below = np.where(y <= half)[0]
+ t_half = float(t[below[0]]) if len(below) else float(t[len(t) // 2])
+ tau0 = max(t_half / np.log(2.0), 1e-3)
+ return [A0, tau0, B0]
+
+
+def fit_single_exp_nls(t, y, p0=None):
+ """单指数 + 常数基线的非线性最小二乘拟合。"""
+ t = np.asarray(t, dtype=float)
+ y = np.asarray(y, dtype=float)
+ if p0 is None:
+ p0 = initial_guess_single(t, y)
+ popt, pcov = curve_fit(
+ _single_exp, t, y, p0=p0,
+ bounds=([0.0, 1e-9, -np.inf], [np.inf, np.inf, np.inf]),
+ maxfev=50000,
+ )
+ resid = y - _single_exp(t, *popt)
+ perr = np.sqrt(np.abs(np.diag(pcov)))
+ return {
+ "model": "single_exp_baseline",
+ "A": float(popt[0]), "tau": float(popt[1]), "B": float(popt[2]),
+ "A_err": float(perr[0]), "tau_err": float(perr[1]), "B_err": float(perr[2]),
+ "rmse": float(np.sqrt(np.mean(resid ** 2))),
+ "residual": resid,
+ "popt": [float(v) for v in popt],
+ }
+
+
+def fit_log_linear(t, y, tail_frac=0.2, b=None):
+ """对数线性拟合:ln(I−B) 对 t 线性回归 → tau = −1/slope。
+
+ b=None 时用尾段均值估计基线(注意:对 B=0 的纯信号,尾段估计本身
+ 就引入偏差——这正是"基线估计误差"教学点,见 docs/实现方案.md §7.5);
+ b 已知时直接使用(此时对数线性与 NLS 在理想数据上数学等价)。
+ 返回剔除的非正点数(对数前需 I−B>0),供教学观察。
+ """
+ t = np.asarray(t, dtype=float)
+ y = np.asarray(y, dtype=float)
+ if b is None:
+ tail_n = max(1, int(len(y) * tail_frac))
+ B = float(np.mean(y[-tail_n:]))
+ baseline_estimated = True
+ else:
+ B = float(b)
+ baseline_estimated = False
+ yy = y - B
+ mask = yy > 0
+ dropped = int(np.sum(~mask))
+ if mask.sum() < 2:
+ return {"model": "log_linear", "tau": None, "A": None, "B_est": B,
+ "baseline_estimated": baseline_estimated,
+ "dropped_points": dropped, "n_used": int(mask.sum())}
+ slope, intercept = np.polyfit(t[mask], np.log(yy[mask]), 1)
+ tau = -1.0 / slope if slope < 0 else None
+ return {
+ "model": "log_linear",
+ "tau": float(tau) if tau else None,
+ "A": float(np.exp(intercept)),
+ "B_est": B,
+ "baseline_estimated": baseline_estimated,
+ "dropped_points": dropped,
+ "n_used": int(mask.sum()),
+ }
+
+
+def fit_double_exp_nls(t, y, p0=None):
+ """双指数 + 常数基线 NLS(M4 复现蒙特卡洛用)。
+
+ 初值策略:先单指数拟合,快成分取 0.2·A、0.1·tau。
+ """
+ t = np.asarray(t, dtype=float)
+ y = np.asarray(y, dtype=float)
+ if p0 is None:
+ s = fit_single_exp_nls(t, y)
+ p0 = [0.2 * s["A"], max(0.1 * s["tau"], 1e-3), 0.8 * s["A"], s["tau"], s["B"]]
+ popt, pcov = curve_fit(
+ _double_exp, t, y, p0=p0,
+ bounds=([0, 1e-6, 0, 1e-6, -np.inf], [np.inf, np.inf, np.inf, np.inf, np.inf]),
+ maxfev=100000,
+ )
+ resid = y - _double_exp(t, *popt)
+ perr = np.sqrt(np.abs(np.diag(pcov)))
+ return {
+ "model": "double_exp_baseline",
+ "A1": float(popt[0]), "tau1": float(popt[1]),
+ "A2": float(popt[2]), "tau2": float(popt[3]), "B": float(popt[4]),
+ "tau1_err": float(perr[1]), "tau2_err": float(perr[3]),
+ "rmse": float(np.sqrt(np.mean(resid ** 2))),
+ "residual": resid,
+ "popt": [float(v) for v in popt],
+ }
+
+
+def fit_single_exp_robust(t, y, loss="soft_l1", f_scale=None):
+ """稳健拟合(扩展功能):least_squares + huber/soft_l1 损失。"""
+ t = np.asarray(t, dtype=float)
+ y = np.asarray(y, dtype=float)
+ p0 = initial_guess_single(t, y)
+ if f_scale is None:
+ f_scale = max(float(np.std(np.diff(y))) * 2.0, 1e-9)
+
+ def resid_fn(p):
+ A, tau, B = p
+ return A * np.exp(-t / tau) + B - y
+
+ res = least_squares(
+ resid_fn, p0, bounds=([0.0, 1e-9, -np.inf], [np.inf, np.inf, np.inf]),
+ loss=loss, f_scale=f_scale, max_nfev=50000,
+ )
+ return {
+ "model": f"single_exp_robust_{loss}",
+ "A": float(res.x[0]), "tau": float(res.x[1]), "B": float(res.x[2]),
+ "rmse": float(np.sqrt(np.mean(res.fun ** 2))),
+ "success": bool(res.success),
+ }
diff --git a/fiber_delay_sim/core/signal.py b/fiber_delay_sim/core/signal.py
new file mode 100644
index 0000000..3dd7be5
--- /dev/null
+++ b/fiber_delay_sim/core/signal.py
@@ -0,0 +1,49 @@
+"""荧光衰减信号模型与真值预设(仅依赖 numpy,浏览器可运行)。
+
+三套预设的来源与区别见 docs/项目说明.md §3.2 / §6:
+- "monte_carlo" 报告 5.4.4 蒙特卡洛仿真真值(快成分 0.60 ns 为仿真设定值)
+- "single" 单指数教学版(YAG:Ce 标称衰减 52.8 ns)
+- "measured_ref" 实测参考(附图 A1 标注寿命;权重原始材料未给出,沿用 0.16/0.84 为假设值)
+"""
+
+import numpy as np
+
+PRESETS = {
+ "monte_carlo": {"A1": 0.16, "tau1": 0.60, "A2": 0.84, "tau2": 52.80, "B0": 0.0, "B1": 0.0},
+ "single": {"A1": 0.0, "tau1": None, "A2": 1.0, "tau2": 52.8, "B0": 0.0, "B1": 0.0},
+ "measured_ref": {"A1": 0.16, "tau1": 5.0, "A2": 0.84, "tau2": 52.5, "B0": 0.0, "B1": 0.0},
+}
+
+
+def resolve_preset(preset, tau=None, amplitude=1.0, b0=0.0, b1=0.0):
+ """按预设名取参数;允许覆盖 tau/幅度/基线(单指数预设)。"""
+ if preset not in PRESETS:
+ raise ValueError(f"未知预设 {preset!r},可选:{list(PRESETS)}")
+ p = dict(PRESETS[preset])
+ if preset == "single":
+ if tau is not None:
+ p["tau2"] = float(tau)
+ p["A2"] = float(amplitude)
+ if b0:
+ p["B0"] = float(b0)
+ if b1:
+ p["B1"] = float(b1)
+ return p
+
+
+def generate(t, params):
+ """荧光衰减信号 I(t) = A1·exp(-t/tau1) + A2·exp(-t/tau2) + B0 + B1·t。
+
+ tau 为 None 或幅度为 0 时对应项不参与(单指数退化)。
+ """
+ t = np.asarray(t, dtype=float)
+ y = np.full(t.shape, float(params.get("B0", 0.0))) + float(params.get("B1", 0.0)) * t
+ a1 = float(params.get("A1", 0.0))
+ tau1 = params.get("tau1")
+ if a1 != 0.0 and tau1:
+ y = y + a1 * np.exp(-t / float(tau1))
+ a2 = float(params.get("A2", 0.0))
+ tau2 = params.get("tau2")
+ if a2 != 0.0 and tau2:
+ y = y + a2 * np.exp(-t / float(tau2))
+ return y
diff --git a/fiber_delay_sim/experiments/__init__.py b/fiber_delay_sim/experiments/__init__.py
new file mode 100644
index 0000000..d92ca3c
--- /dev/null
+++ b/fiber_delay_sim/experiments/__init__.py
@@ -0,0 +1 @@
+"""实验脚本(本地层:可使用 matplotlib;每个脚本产出论文/教学的一个完整记录包)。"""
diff --git a/fiber_delay_sim/experiments/__pycache__/__init__.cpython-312.pyc b/fiber_delay_sim/experiments/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..3b20b67
Binary files /dev/null and b/fiber_delay_sim/experiments/__pycache__/__init__.cpython-312.pyc differ
diff --git a/fiber_delay_sim/experiments/__pycache__/_plot.cpython-312.pyc b/fiber_delay_sim/experiments/__pycache__/_plot.cpython-312.pyc
new file mode 100644
index 0000000..9ff0fa8
Binary files /dev/null and b/fiber_delay_sim/experiments/__pycache__/_plot.cpython-312.pyc differ
diff --git a/fiber_delay_sim/experiments/__pycache__/exp01_m0_baseline.cpython-312.pyc b/fiber_delay_sim/experiments/__pycache__/exp01_m0_baseline.cpython-312.pyc
new file mode 100644
index 0000000..76b4c5a
Binary files /dev/null and b/fiber_delay_sim/experiments/__pycache__/exp01_m0_baseline.cpython-312.pyc differ
diff --git a/fiber_delay_sim/experiments/__pycache__/exp02_fiber_design.cpython-312.pyc b/fiber_delay_sim/experiments/__pycache__/exp02_fiber_design.cpython-312.pyc
new file mode 100644
index 0000000..0c74bb7
Binary files /dev/null and b/fiber_delay_sim/experiments/__pycache__/exp02_fiber_design.cpython-312.pyc differ
diff --git a/fiber_delay_sim/experiments/_plot.py b/fiber_delay_sim/experiments/_plot.py
new file mode 100644
index 0000000..7e602c0
--- /dev/null
+++ b/fiber_delay_sim/experiments/_plot.py
@@ -0,0 +1,13 @@
+"""matplotlib 绘图样式(本地层专用)。"""
+
+import matplotlib.pyplot as plt
+
+
+def setup_style():
+ plt.rcParams["font.sans-serif"] = [
+ "PingFang SC", "Hiragino Sans GB", "Arial Unicode MS", "SimHei", "sans-serif",
+ ]
+ plt.rcParams["axes.unicode_minus"] = False
+ plt.rcParams["figure.dpi"] = 120
+ plt.rcParams["savefig.bbox"] = "tight"
+ return plt
diff --git a/fiber_delay_sim/experiments/exp01_m0_baseline.py b/fiber_delay_sim/experiments/exp01_m0_baseline.py
new file mode 100644
index 0000000..4004b6f
--- /dev/null
+++ b/fiber_delay_sim/experiments/exp01_m0_baseline.py
@@ -0,0 +1,111 @@
+"""M0 基准实验:单指数信号 + 10ns 直接采样 + 噪声 + NLS 寿命拟合。
+
+场景 A:理想无噪 → 拟合应恢复设定寿命(M0 验收①,对应原项目"标准拟合"基准);
+场景 B:SNR 50 dB + 12bit 量化,重复 N 次 → τ̂ 分布(M0 验收③)。
+
+运行:python -m fiber_delay_sim.experiments.exp01_m0_baseline [--repeats 20] [--seed 42]
+"""
+
+import argparse
+
+import numpy as np
+
+from .. import pipeline
+from ..export import record
+from ._plot import setup_style
+
+
+def run(tau=52.8, window_ns=400.0, snr_db=50.0, bits=12, repeats=20, seed=42, runs_dir="runs"):
+ plt = setup_style()
+
+ # ---------- 场景 A:理想无噪 ----------
+ ideal_params = {"preset": "single", "tau": tau, "snr_db": None, "bits": None,
+ "window_ns": window_ns}
+ rec_ideal = pipeline.run_m0(ideal_params, seed=seed)
+
+ # ---------- 场景 B:加噪重复 ----------
+ noisy_params = {"preset": "single", "tau": tau, "snr_db": snr_db, "bits": bits,
+ "window_ns": window_ns}
+ rec_noise = pipeline.run_m0(noisy_params, seed=seed)
+ reps = pipeline.run_m0_repeats(noisy_params, repeats=repeats, seed=seed)
+
+ # ---------- 图 1:理想采样与拟合(第一张拟合图) ----------
+ fig1, ax = plt.subplots(figsize=(7, 4.2))
+ ax.plot(rec_ideal["t_cont"], rec_ideal["y_cont"], "-", color="#9aa5b1", lw=1.2,
+ label="连续信号(真值)")
+ ax.plot(rec_ideal["t_samples"], rec_ideal["y_samples"], "o", color="#2D5F8A", ms=6,
+ label=f"10 ns 直接采样({rec_ideal['n_samples']} 点)")
+ t_fit = rec_ideal["t_samples"]
+ f = rec_ideal["fit"]
+ ax.plot(t_fit, f["A"] * np.exp(-t_fit / f["tau"]) + f["B"], "r--", lw=1.5,
+ label=f"NLS 拟合:τ̂ = {f['tau']:.4f} ns")
+ ax.set_xlabel("时间 (ns)")
+ ax.set_ylabel("归一化强度")
+ ax.set_title(f"M0 理想无噪基准:设定 τ = {tau} ns,恢复偏差 "
+ f"{rec_ideal['rel_error']:.2e}(相对)")
+ ax.legend()
+ ax.grid(alpha=0.3)
+
+ # ---------- 图 2:加噪单次 ----------
+ fig2, ax = plt.subplots(figsize=(7, 4.2))
+ ax.plot(rec_noise["t_cont"], rec_noise["y_cont"], "-", color="#9aa5b1", lw=1.2,
+ label="连续信号(真值)")
+ ax.plot(rec_noise["t_samples"], rec_noise["y_samples"], "o", color="#C25B2A", ms=5,
+ label=f"采样点(SNR {snr_db} dB,{rec_noise['bits']} bit)")
+ fn = rec_noise["fit"]
+ ax.plot(t_fit, fn["A"] * np.exp(-t_fit / fn["tau"]) + fn["B"], "r--", lw=1.5,
+ label=f"NLS 拟合:τ̂ = {fn['tau']:.3f} ns")
+ ax.set_xlabel("时间 (ns)")
+ ax.set_ylabel("归一化强度")
+ ax.set_title(f"M0 加噪单次:SNR = {snr_db} dB,12 bit 量化")
+ ax.legend()
+ ax.grid(alpha=0.3)
+
+ # ---------- 图 3:重复实验 τ̂ 分布 ----------
+ fig3, ax = plt.subplots(figsize=(7, 4.2))
+ ax.hist(reps["tau_hats"], bins=max(10, repeats // 2), color="#2D5F8A",
+ alpha=0.75, edgecolor="white")
+ ax.axvline(reps["tau_true"], color="#C25B2A", ls="--", lw=2,
+ label=f"真值 τ = {reps['tau_true']:.1f} ns")
+ ax.axvline(reps["mean"], color="#1A5276", ls=":", lw=2,
+ label=f"均值 {reps['mean']:.3f} ns")
+ ax.set_xlabel("拟合寿命 τ̂ (ns)")
+ ax.set_ylabel("次数")
+ ax.set_title(f"M0 重复 {repeats} 次:相对标准差 {reps['rel_std'] * 100:.2f}%,"
+ f"偏差 {reps['bias'] * 100:+.2f}%")
+ ax.legend()
+ ax.grid(alpha=0.3)
+
+ # ---------- 落盘记录包 ----------
+ run_dir = record.save_run(
+ runs_dir, "exp01_m0_baseline",
+ records=[rec_ideal, rec_noise, reps],
+ figures=[("fig1_ideal_fit", fig1), ("fig2_noisy_fit", fig2),
+ ("fig3_repeat_hist", fig3)],
+ notes=(f"M0 基准:①理想无噪恢复 τ={tau} ns(偏差 {rec_ideal['rel_error']:.2e});"
+ f"②SNR {snr_db} dB 重复 {repeats} 次分布:均值 {reps['mean']:.3f} ns、"
+ f"相对标准差 {reps['rel_std'] * 100:.2f}%。"),
+ seed=seed,
+ )
+
+ print(f"[M0] 理想无噪:τ̂ = {rec_ideal['fit']['tau']:.6f} ns "
+ f"(设定 {tau},相对偏差 {rec_ideal['rel_error']:.2e})")
+ print(f"[M0] 加噪单次:τ̂ = {rec_noise['fit']['tau']:.3f} ns")
+ print(f"[M0] 重复 {repeats} 次:均值 {reps['mean']:.3f} ns,"
+ f"σ(τ̂)/τ = {reps['rel_std'] * 100:.2f}%,bias = {reps['bias'] * 100:+.2f}%")
+ print(f"[M0] 记录包:{run_dir}")
+ return run_dir
+
+
+if __name__ == "__main__":
+ ap = argparse.ArgumentParser(description="M0 基准实验")
+ ap.add_argument("--tau", type=float, default=52.8)
+ ap.add_argument("--window-ns", type=float, default=400.0)
+ ap.add_argument("--snr-db", type=float, default=50.0)
+ ap.add_argument("--bits", type=int, default=12)
+ ap.add_argument("--repeats", type=int, default=20)
+ ap.add_argument("--seed", type=int, default=42)
+ ap.add_argument("--runs-dir", default="runs")
+ a = ap.parse_args()
+ run(tau=a.tau, window_ns=a.window_ns, snr_db=a.snr_db, bits=a.bits,
+ repeats=a.repeats, seed=a.seed, runs_dir=a.runs_dir)
diff --git a/fiber_delay_sim/experiments/exp02_fiber_design.py b/fiber_delay_sim/experiments/exp02_fiber_design.py
new file mode 100644
index 0000000..d653c11
--- /dev/null
+++ b/fiber_delay_sim/experiments/exp02_fiber_design.py
@@ -0,0 +1,121 @@
+"""M1 光纤设计实验:名义四组 → 延时/相位表 + 反向设计 + 相位图。
+
+运行:python -m fiber_delay_sim.experiments.exp02_fiber_design
+"""
+
+import argparse
+
+import numpy as np
+
+from ..core import fiber
+from ..export import record
+from ._plot import setup_style
+
+
+def _print_table(title, rows, header):
+ print(f"\n=== {title} ===")
+ print(" | ".join(f"{h:>12}" for h in header))
+ for r in rows:
+ print(" | ".join(f"{c:>12}" if isinstance(c, str) else f"{c:>12.4f}" for c in r))
+
+
+def run(runs_dir="runs"):
+ plt = setup_style()
+
+ # ---------- 正向:名义四组(设计延时精确值) ----------
+ fwd = fiber.forward_design(delays_ns=fiber.NOMINAL_DELAYS_NS)
+ rows = []
+ for ch in fwd["channels"]:
+ rows.append((f"CH{ch['index'] + 1}", ch["delay_ns"], ch["phase_ns"],
+ fiber.NOMINAL_LENGTHS_M[ch["index"]], ch["length_m"]))
+ _print_table("名义四组:设计延时 / 相位 / 长度", rows,
+ ["通道", "设计延时 ns", "相位 ns", "名义长度 m", "反算长度 m"])
+ u = fwd["uniformity"]
+ print(f"排序后等效网格:{fwd['sorted_phases_ns']} ns"
+ f"(理想步长 {u['ideal_step_ns']} ns,最大间隔偏差 {u['max_gap_dev_ns']:.3g} ns)")
+
+ # ---------- 反向设计:目标 0/2.5/5/7.5 ----------
+ targets = [0.0, 2.5, 5.0, 7.5]
+ inv = fiber.inverse_design(targets)
+ assert inv["is_uniform_grid"] and inv["recommended"]
+ rec_rows = [(e["phase_ns"], e["k"], e["delay_ns"], e["length_m"]) for e in inv["recommended"]]
+ _print_table("反向设计推荐解(目标相位 0/2.5/5/7.5 ns)", rec_rows,
+ ["目标相位 ns", "通道序 k", "延时 ns", "长度 m"])
+ print(f"构造式:{inv['construction']}")
+
+ # ---------- 图 1:一个采样周期内的相位位置 ----------
+ fig1, ax = plt.subplots(figsize=(7, 3.2))
+ colors = ["#2D5F8A", "#C25B2A", "#2A6B5A", "#6B2A35"]
+ for i, ch in enumerate(fwd["channels"]):
+ ax.plot([ch["phase_ns"]], [1], "o", ms=12, color=colors[i % 4])
+ ax.annotate(f"CH{ch['index'] + 1}\nφ={ch['phase_ns']:.1f} ns",
+ (ch["phase_ns"], 1), textcoords="offset points",
+ xytext=(0, 14 + 12 * (i % 2)), ha="center", fontsize=9)
+ ax.axhline(1, color="#9aa5b1", lw=1)
+ for x in np.arange(0, 11, 2.5):
+ ax.axvline(x, color="#d8dee5", lw=0.8, ls="--")
+ ax.set_xlim(-1, 11)
+ ax.set_ylim(0.6, 1.9)
+ ax.set_yticks([])
+ ax.set_xticks(np.arange(0, 11, 2.5))
+ ax.set_xlabel("采样周期内相位 (ns)")
+ ax.set_title("四路光纤延时在一个 10 ns 采样周期内的相位位置(0 / 2.5 / 5.0 / 7.5 ns)")
+ ax.grid(alpha=0.2)
+
+ # ---------- 图 2:相位圆图 ----------
+ fig2 = plt.figure(figsize=(5.2, 5.2))
+ ax2 = fig2.add_subplot(111, projection="polar")
+ for i, ch in enumerate(fwd["channels"]):
+ theta = 2 * np.pi * ch["phase_ns"] / fiber.DT_DEFAULT
+ ax2.plot([theta], [1], "o", ms=14, color=colors[i % 4])
+ ax2.annotate(f"CH{ch['index'] + 1}", (theta, 1.15), ha="center",
+ textcoords="data", fontsize=11)
+ ax2.set_yticks([])
+ ax2.set_xticks(2 * np.pi * np.arange(0, 10, 2.5) / 10)
+ ax2.set_xticklabels(["0 ns", "2.5 ns", "5.0 ns", "7.5 ns"])
+ ax2.set_title("相位圆图:10 ns 周期内的等效采样相位", pad=18)
+
+ # ---------- 图 3:记录时间轴上的四路延时片段示意 ----------
+ fig3, ax3 = plt.subplots(figsize=(7.2, 3.6))
+ for i, ch in enumerate(fwd["channels"]):
+ ax3.plot([ch["delay_ns"], ch["delay_ns"] + 20], [i, i], "-", lw=3,
+ color=colors[i % 4], solid_capstyle="butt")
+ ax3.annotate(f"CH{ch['index'] + 1}: δ={ch['delay_ns']:.1f} ns (L={fiber.NOMINAL_LENGTHS_M[ch['index']]:.2f} m)",
+ (ch["delay_ns"], i), textcoords="offset points", xytext=(2, -14),
+ fontsize=9)
+ ax3.set_xlim(-5, 175)
+ ax3.set_ylim(-0.8, 3.8)
+ ax3.set_yticks([])
+ ax3.set_xlabel("记录时间轴 (ns)")
+ ax3.set_title("四路延时片段在记录时间轴上的定位(片段间隔约 47.5 ns,相位错开 2.5 ns)")
+ ax3.grid(alpha=0.25)
+
+ # ---------- 记录包 ----------
+ pack = {
+ "meta": {"experiment": "exp02_fiber_design",
+ "data_origin": "software-simulated", "params": None},
+ "channels": fwd["channels"],
+ "sorted_phases_ns": fwd["sorted_phases_ns"],
+ "uniformity": u,
+ "target_phases_ns": inv["target_phases_ns"],
+ "is_uniform_grid": inv["is_uniform_grid"],
+ "recommended": inv["recommended"],
+ "construction": inv["construction"],
+ }
+ run_dir = record.save_run(
+ runs_dir, "exp02_fiber_design", records=[pack],
+ figures=[("fig1_phase_positions", fig1), ("fig2_phase_circle", fig2),
+ ("fig3_delay_segments", fig3)],
+ notes=("M1 光纤设计:名义四组 0/9.70/19.40/29.10 m → 延时 0/47.5/95/142.5 ns → "
+ "相位 0/2.5/5.0/7.5 ns(均匀网格,最大间隔偏差 "
+ f"{u['max_gap_dev_ns']:.3g} ns);反向设计复现原项目方案。"),
+ )
+ print(f"\n[M1] 记录包:{run_dir}")
+ return run_dir
+
+
+if __name__ == "__main__":
+ ap = argparse.ArgumentParser(description="M1 光纤设计实验")
+ ap.add_argument("--runs-dir", default="runs")
+ a = ap.parse_args()
+ run(runs_dir=a.runs_dir)
diff --git a/fiber_delay_sim/export/__init__.py b/fiber_delay_sim/export/__init__.py
new file mode 100644
index 0000000..877b3e6
--- /dev/null
+++ b/fiber_delay_sim/export/__init__.py
@@ -0,0 +1,5 @@
+"""导出层:实验记录包落盘(本地专用,Pyodide 不加载本模块)。"""
+
+from . import record
+
+__all__ = ["record"]
diff --git a/fiber_delay_sim/export/__pycache__/__init__.cpython-312.pyc b/fiber_delay_sim/export/__pycache__/__init__.cpython-312.pyc
new file mode 100644
index 0000000..2408586
Binary files /dev/null and b/fiber_delay_sim/export/__pycache__/__init__.cpython-312.pyc differ
diff --git a/fiber_delay_sim/export/__pycache__/record.cpython-312.pyc b/fiber_delay_sim/export/__pycache__/record.cpython-312.pyc
new file mode 100644
index 0000000..32fc081
Binary files /dev/null and b/fiber_delay_sim/export/__pycache__/record.cpython-312.pyc differ
diff --git a/fiber_delay_sim/export/record.py b/fiber_delay_sim/export/record.py
new file mode 100644
index 0000000..431869f
--- /dev/null
+++ b/fiber_delay_sim/export/record.py
@@ -0,0 +1,98 @@
+"""实验记录包落盘(本地层;浏览器端不使用)。
+
+记录包结构(docs/实现方案.md §10):
+ runs/<时间戳>-<实验名>-seed<种子>/
+ ├── meta.json 运行时间、git hash、算法版本、全部参数、种子、数据来源标注
+ ├── data/ 采样点 CSV
+ ├── results.json 拟合与统计数值
+ ├── figures/ SVG + PNG 图表
+ └── README.md 本次运行回答什么问题
+"""
+
+import csv
+import datetime
+import json
+import os
+import subprocess
+
+from .. import ALGO_VERSION
+
+
+def git_hash():
+ try:
+ h = subprocess.run(["git", "rev-parse", "--short", "HEAD"],
+ capture_output=True, text=True, timeout=5)
+ if h.returncode == 0 and h.stdout.strip():
+ return h.stdout.strip()
+ except Exception:
+ pass
+ return "unversioned"
+
+
+def save_run(runs_dir, name, records, figures=None, notes="", seed=None, extra_meta=None):
+ """落盘一个记录包。
+
+ records: dict 或 list[dict],每个含 meta/data 字段(pipeline 输出);
+ figures: list[(filename, matplotlib.figure)]。
+ 返回记录包目录。
+ """
+ ts = datetime.datetime.now().strftime("%Y%m%d-%H%M%S")
+ if seed is not None:
+ run_dir = os.path.join(runs_dir, f"{ts}-{name}-seed{seed}")
+ else:
+ run_dir = os.path.join(runs_dir, f"{ts}-{name}")
+ os.makedirs(os.path.join(run_dir, "data"), exist_ok=True)
+ os.makedirs(os.path.join(run_dir, "figures"), exist_ok=True)
+
+ if isinstance(records, dict):
+ records = [records]
+
+ meta = {
+ "created": datetime.datetime.now().isoformat(timespec="seconds"),
+ "git_hash": git_hash(),
+ "algo_version": ALGO_VERSION,
+ "data_origin": "software-simulated",
+ "experiment": name,
+ "notes": notes,
+ }
+ if seed is not None:
+ meta["seed"] = int(seed)
+ if extra_meta:
+ meta.update(extra_meta)
+
+ results = []
+ for i, rec in enumerate(records):
+ m = rec.get("meta", {})
+ meta.setdefault("params", m.get("params"))
+ r = {k: v for k, v in rec.items()
+ if k in ("fit", "tau_hat", "tau_true", "rel_error", "n_samples",
+ "sigma", "mean", "std", "rel_std", "bias", "tau_hats",
+ "uniformity", "sorted_phases_ns", "channels", "construction",
+ "target_phases_ns", "is_uniform_grid", "recommended")}
+ results.append(r)
+ # 采样点 CSV
+ if "t_samples" in rec:
+ path = os.path.join(run_dir, "data", f"samples_{i:02d}.csv")
+ with open(path, "w", newline="") as f:
+ w = csv.writer(f)
+ w.writerow(["t_ns", "y_clean", "y_measured"])
+ for t, yc, ym in zip(rec["t_samples"], rec["y_clean"], rec["y_samples"]):
+ w.writerow([f"{t:.6f}", f"{yc:.9f}", f"{ym:.9f}"])
+
+ with open(os.path.join(run_dir, "meta.json"), "w") as f:
+ json.dump(meta, f, ensure_ascii=False, indent=2)
+ with open(os.path.join(run_dir, "results.json"), "w") as f:
+ json.dump(results, f, ensure_ascii=False, indent=2, default=float)
+
+ for fname, fig in (figures or []):
+ fig.savefig(os.path.join(run_dir, "figures", f"{fname}.svg"))
+ fig.savefig(os.path.join(run_dir, "figures", f"{fname}.png"), dpi=150)
+
+ with open(os.path.join(run_dir, "README.md"), "w") as f:
+ f.write(f"# 记录包:{name}\n\n{notes}\n\n"
+ f"- 运行时间:{meta['created']}\n"
+ f"- git:{meta['git_hash']},算法版本:{ALGO_VERSION}\n"
+ f"- 数据来源:**软件仿真(software-simulated)**,非装置实测\n"
+ f"- 复现:`pytest fiber_delay_sim/tests/` 或重跑对应 experiments 脚本\n")
+
+ return run_dir
diff --git a/fiber_delay_sim/pipeline.py b/fiber_delay_sim/pipeline.py
new file mode 100644
index 0000000..5a23e65
--- /dev/null
+++ b/fiber_delay_sim/pipeline.py
@@ -0,0 +1,101 @@
+"""实验流程编排:参数 → 生成 → 采样 → 拟合 → 结果(纯数据,Pyodide 可运行)。
+
+M0:单指数信号 + 10 ns 直接采样 + 噪声 + NLS 寿命拟合。
+"""
+
+import numpy as np
+
+from .core import acquisition, fitting, signal
+from . import ALGO_VERSION
+
+M0_DEFAULTS = {
+ "preset": "single", # single / monte_carlo / measured_ref
+ "tau": 52.8, # ns(仅 single 预设生效)
+ "amplitude": 1.0,
+ "b0": 0.0,
+ "b1": 0.0,
+ "window_ns": 400.0,
+ "dt_ns": 10.0,
+ "t0_ns": 0.0,
+ "snr_db": 50.0, # None → 无噪声
+ "bits": 12, # None → 不量化
+ "bandwidth_sigma_ns": 0.0,
+ "jitter_ns": 0.0,
+}
+
+CONT_STEP_NS = 0.01 # 连续曲线网格步长(仅用于画图与插值)
+
+
+def _resolve(params):
+ """合并默认参数并解析为信号/采集两组参数。"""
+ p = dict(M0_DEFAULTS)
+ p.update({k: v for k, v in (params or {}).items() if v is not None or k in ("snr_db", "bits", "b0", "b1")})
+ sig_params = signal.resolve_preset(p["preset"], tau=p["tau"], amplitude=p["amplitude"],
+ b0=p["b0"], b1=p["b1"])
+ return p, sig_params
+
+
+def run_m0(params=None, seed=42):
+ """单次 M0 实验:生成 → 采样 → 拟合。返回纯数据 dict。"""
+ p, sig_params = _resolve(params)
+ rng = np.random.default_rng(seed)
+
+ t_cont = np.arange(0.0, float(p["window_ns"]) + CONT_STEP_NS / 2, CONT_STEP_NS)
+ y_cont = signal.generate(t_cont, sig_params)
+
+ acq_params = {
+ "dt_ns": p["dt_ns"], "t0_ns": p["t0_ns"], "window_ns": p["window_ns"],
+ "snr_db": p.get("snr_db"), "bits": p.get("bits"),
+ "bandwidth_sigma_ns": p["bandwidth_sigma_ns"], "jitter_ns": p["jitter_ns"],
+ }
+ acq = acquisition.run_single_channel(t_cont, y_cont, acq_params, rng)
+ fit = fitting.fit_single_exp_nls(acq["t_samples"], acq["y_samples"])
+
+ tau_true = float(sig_params["tau2"])
+ rel_err = abs(fit["tau"] - tau_true) / tau_true if tau_true else None
+
+ return {
+ "meta": {
+ "experiment": "m0_single_channel_fit",
+ "algo_version": ALGO_VERSION,
+ "data_origin": "software-simulated",
+ "seed": int(seed),
+ "params": {k: (v if not isinstance(v, float) else round(v, 6)) for k, v in p.items()},
+ },
+ "t_cont": t_cont, "y_cont": y_cont,
+ "t_samples": acq["t_samples"], "y_clean": acq["y_clean"], "y_samples": acq["y_samples"],
+ "n_samples": acq["n_samples"], "sigma": acq["sigma"],
+ "snr_db": acq["snr_db"], "bits": acq["bits"],
+ "fit": {k: v for k, v in fit.items() if k != "residual"},
+ "residual": fit["residual"],
+ "tau_hat": fit["tau"], "tau_true": tau_true, "rel_error": rel_err,
+ }
+
+
+def run_m0_repeats(params=None, repeats=20, seed=0):
+ """重复 M0 实验(不同种子)→ τ̂ 分布统计。"""
+ p, sig_params = _resolve(params)
+ tau_true = float(sig_params["tau2"])
+ tau_hats, n_pts = [], []
+ for i in range(int(repeats)):
+ rec = run_m0(params, seed=seed + i)
+ tau_hats.append(rec["tau_hat"])
+ n_pts.append(rec["n_samples"])
+ arr = np.asarray(tau_hats, dtype=float)
+ mean = float(np.mean(arr))
+ return {
+ "meta": {
+ "experiment": "m0_repeats",
+ "algo_version": ALGO_VERSION,
+ "data_origin": "software-simulated",
+ "base_seed": int(seed), "repeats": int(repeats),
+ "params": {k: v for k, v in p.items()},
+ },
+ "tau_true": tau_true,
+ "tau_hats": tau_hats,
+ "n_samples": int(n_pts[0]) if n_pts else 0,
+ "mean": mean,
+ "std": float(np.std(arr, ddof=1)) if len(arr) > 1 else 0.0,
+ "rel_std": float(np.std(arr, ddof=1) / mean) if len(arr) > 1 and mean else None,
+ "bias": float((mean - tau_true) / tau_true) if tau_true else None,
+ }
diff --git a/fiber_delay_sim/tests/__pycache__/test_core.cpython-312-pytest-9.1.1.pyc b/fiber_delay_sim/tests/__pycache__/test_core.cpython-312-pytest-9.1.1.pyc
new file mode 100644
index 0000000..75df0e1
Binary files /dev/null and b/fiber_delay_sim/tests/__pycache__/test_core.cpython-312-pytest-9.1.1.pyc differ
diff --git a/fiber_delay_sim/tests/test_core.py b/fiber_delay_sim/tests/test_core.py
new file mode 100644
index 0000000..87504d4
--- /dev/null
+++ b/fiber_delay_sim/tests/test_core.py
@@ -0,0 +1,142 @@
+"""M0/M1 验收测试(docs/实现方案.md §11–§12)。"""
+
+import numpy as np
+import pytest
+
+from fiber_delay_sim import pipeline
+from fiber_delay_sim.core import fiber, fitting, signal
+
+
+# ---------- fiber.py:延时与相位 ----------
+
+def test_delay_per_meter():
+ """1 m 石英光纤 ≈ 4.90 ns(报告 2.4.1:c/n_g = 20.42 cm/ns)。"""
+ d = fiber.delay_from_length(1.0)
+ assert 4.89 < d < 4.92
+
+
+def test_nominal_lengths_match_design_delays():
+ """名义长度按 n_g 反算的延时应与设计延时一致(±0.01 ns)。"""
+ for L, d in zip(fiber.NOMINAL_LENGTHS_M, fiber.NOMINAL_DELAYS_NS):
+ assert abs(fiber.delay_from_length(L) - d) < 0.01
+
+
+def test_nominal_phases():
+ """名义四组:相位 {0, 7.5, 5.0, 2.5},排序后 {0, 2.5, 5.0, 7.5},严格均匀。"""
+ fwd = fiber.forward_design(delays_ns=fiber.NOMINAL_DELAYS_NS)
+ assert np.allclose(fwd["phases_ns"], [0.0, 7.5, 5.0, 2.5], atol=1e-12)
+ assert np.allclose(fwd["sorted_phases_ns"], [0.0, 2.5, 5.0, 7.5], atol=1e-12)
+ assert fwd["uniformity"]["max_gap_dev_ns"] < 1e-9
+ assert fwd["order_index"] == [0, 3, 2, 1] # 相位 0→CH1, 2.5→CH4, 5→CH3, 7.5→CH2
+
+
+def test_inverse_design_reproduces_original():
+ """反向设计 0/2.5/5/7.5 ns 应复现原项目 0/142.5/95/47.5 ns 与名义长度。"""
+ inv = fiber.inverse_design([0.0, 2.5, 5.0, 7.5])
+ assert inv["is_uniform_grid"]
+ rec = inv["recommended"]
+ delays = sorted(e["delay_ns"] for e in rec)
+ assert np.allclose(delays, [0.0, 47.5, 95.0, 142.5], atol=1e-9)
+ by_phase = {e["phase_ns"]: e["length_m"] for e in rec}
+ assert abs(by_phase[0.0] - 0.0) < 1e-9
+ assert abs(by_phase[7.5] - 9.70) < 0.01
+ assert abs(by_phase[5.0] - 19.40) < 0.01
+ assert abs(by_phase[2.5] - 29.10) < 0.01
+
+
+def test_inverse_forward_roundtrip():
+ """反向设计 → 长度 → 正向复算:相位应还原目标(M1 验收)。"""
+ targets = [0.0, 2.5, 5.0, 7.5]
+ inv = fiber.inverse_design(targets)
+ lengths = [e["length_m"] for e in inv["recommended"]]
+ fwd = fiber.forward_design(lengths_m=lengths)
+ assert np.allclose(fwd["sorted_phases_ns"], sorted(targets), atol=1e-9)
+
+
+def test_nonuniform_targets_flagged():
+ """非均匀目标相位:应明确提示网格不均匀(教学点)。"""
+ inv = fiber.inverse_design([0.0, 1.0, 4.0, 7.5])
+ assert not inv["is_uniform_grid"]
+ assert inv["recommended"] is None
+
+
+# ---------- signal.py:预设 ----------
+
+def test_signal_presets_values():
+ t = np.array([0.0])
+ y = signal.generate(t, signal.PRESETS["monte_carlo"])
+ assert abs(y[0] - 1.0) < 1e-12 # 0.16 + 0.84
+ y2 = signal.generate(t, signal.PRESETS["single"])
+ assert abs(y2[0] - 1.0) < 1e-12
+
+
+def test_signal_single_exp_decay():
+ t = np.array([0.0, 52.8])
+ y = signal.generate(t, signal.PRESETS["single"])
+ assert abs(y[1] - np.exp(-1.0)) < 1e-12
+
+
+# ---------- M0:最小程序验收 ----------
+
+def test_m0_ideal_recovery():
+ """M0 验收①:理想无噪条件恢复设定寿命(相对偏差 < 1e-6)。"""
+ rec = pipeline.run_m0({"preset": "single", "tau": 52.8,
+ "snr_db": None, "bits": None, "window_ns": 400.0}, seed=1)
+ assert rec["n_samples"] == 40
+ assert rec["rel_error"] < 1e-6
+ assert rec["fit"]["rmse"] < 1e-9
+
+
+def test_m0_reproducibility():
+ """M0 验收②(复现性红线):同种子两次运行逐位一致。"""
+ a = pipeline.run_m0({"preset": "single", "tau": 52.8, "snr_db": 50, "bits": 12}, seed=7)
+ b = pipeline.run_m0({"preset": "single", "tau": 52.8, "snr_db": 50, "bits": 12}, seed=7)
+ assert np.array_equal(a["y_samples"], b["y_samples"])
+ assert a["tau_hat"] == b["tau_hat"]
+
+
+def test_m0_noise_reasonable():
+ """M0 验收③:加噪后多次运行分布合理(无发散、无明显偏差)。"""
+ reps = pipeline.run_m0_repeats(
+ {"preset": "single", "tau": 52.8, "snr_db": 50, "bits": 12, "window_ns": 400.0},
+ repeats=30, seed=100)
+ assert 0 < reps["rel_std"] < 0.05 # 有随机性但不发散
+ assert abs(reps["bias"]) < 0.02 # 无明显系统偏差
+
+
+def test_m0_short_window_fewer_points():
+ """采样点数随窗口变化:40ns 窗口只有 4~5 点(对应原项目 0.76τ 教学案例)。"""
+ rec = pipeline.run_m0({"preset": "single", "tau": 52.8, "snr_db": None,
+ "bits": None, "window_ns": 40.0}, seed=3)
+ assert rec["n_samples"] == 4
+
+
+# ---------- 拟合算法 ----------
+
+def test_log_linear_ideal_known_baseline():
+ """对数线性(已知基线 B=0)在理想单指数下应精确还原寿命——与 NLS 数学等价。"""
+ t = np.arange(0.0, 400.0, 10.0)
+ y = 1.0 * np.exp(-t / 52.8)
+ r = fitting.fit_log_linear(t, y, b=0.0)
+ assert not r["baseline_estimated"]
+ assert abs(r["tau"] - 52.8) / 52.8 < 1e-6
+ assert r["dropped_points"] == 0
+
+
+def test_log_linear_estimated_baseline_bias():
+ """教学点:对 B=0 纯信号,默认尾段估基线引入明显偏差(基线估计误差)。"""
+ t = np.arange(0.0, 400.0, 10.0)
+ y = 1.0 * np.exp(-t / 52.8)
+ r = fitting.fit_log_linear(t, y) # 默认尾段估基线
+ assert r["baseline_estimated"]
+ rel = abs(r["tau"] - 52.8) / 52.8
+ assert 0.05 < rel < 0.5 # 偏差显著但有限(约 20%)
+
+
+def test_double_exp_nls_ideal_recovery():
+ """双指数 NLS 基准:理想数据恢复双寿命(对应原项目"标准拟合"验证)。"""
+ t = np.arange(0.0, 400.0, 4.0)
+ y = signal.generate(t, signal.PRESETS["monte_carlo"])
+ r = fitting.fit_double_exp_nls(t, y)
+ assert abs(r["tau2"] - 52.80) / 52.80 < 1e-4
+ assert abs(r["tau1"] - 0.60) / 0.60 < 1e-3
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/README.md b/runs/20261012-142531-exp01_m0_baseline-seed42/README.md
new file mode 100644
index 0000000..7166d8d
--- /dev/null
+++ b/runs/20261012-142531-exp01_m0_baseline-seed42/README.md
@@ -0,0 +1,8 @@
+# 记录包:exp01_m0_baseline
+
+M0 基准:①理想无噪恢复 τ=52.8 ns(偏差 1.35e-16);②SNR 50.0 dB 重复 20 次分布:均值 52.817 ns、相对标准差 0.42%。
+
+- 运行时间:2026-10-12T14:25:31
+- git:ae1c774,算法版本:M0+M1
+- 数据来源:**软件仿真(software-simulated)**,非装置实测
+- 复现:`pytest fiber_delay_sim/tests/` 或重跑对应 experiments 脚本
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/data/samples_00.csv b/runs/20261012-142531-exp01_m0_baseline-seed42/data/samples_00.csv
new file mode 100644
index 0000000..fbbc9d7
--- /dev/null
+++ b/runs/20261012-142531-exp01_m0_baseline-seed42/data/samples_00.csv
@@ -0,0 +1,41 @@
+t_ns,y_clean,y_measured
+0.000000,1.000000000,1.000000000
+10.000000,0.827460473,0.827460473
+20.000000,0.684690835,0.684690835
+30.000000,0.566554602,0.566554602
+40.000000,0.468801539,0.468801539
+50.000000,0.387914743,0.387914743
+60.000000,0.320984117,0.320984117
+70.000000,0.265601669,0.265601669
+80.000000,0.219774883,0.219774883
+90.000000,0.181855029,0.181855029
+100.000000,0.150477848,0.150477848
+110.000000,0.124514471,0.124514471
+120.000000,0.103030803,0.103030803
+130.000000,0.085253917,0.085253917
+140.000000,0.070544247,0.070544247
+150.000000,0.058372576,0.058372576
+160.000000,0.048300999,0.048300999
+170.000000,0.039967168,0.039967168
+180.000000,0.033071251,0.033071251
+190.000000,0.027365153,0.027365153
+200.000000,0.022643583,0.022643583
+210.000000,0.018736670,0.018736670
+220.000000,0.015503854,0.015503854
+230.000000,0.012828826,0.012828826
+240.000000,0.010615346,0.010615346
+250.000000,0.008783780,0.008783780
+260.000000,0.007268230,0.007268230
+270.000000,0.006014173,0.006014173
+280.000000,0.004976491,0.004976491
+290.000000,0.004117849,0.004117849
+300.000000,0.003407358,0.003407358
+310.000000,0.002819454,0.002819454
+320.000000,0.002332987,0.002332987
+330.000000,0.001930454,0.001930454
+340.000000,0.001597374,0.001597374
+350.000000,0.001321764,0.001321764
+360.000000,0.001093708,0.001093708
+370.000000,0.000905000,0.000905000
+380.000000,0.000748852,0.000748852
+390.000000,0.000619645,0.000619645
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/data/samples_01.csv b/runs/20261012-142531-exp01_m0_baseline-seed42/data/samples_01.csv
new file mode 100644
index 0000000..314025e
--- /dev/null
+++ b/runs/20261012-142531-exp01_m0_baseline-seed42/data/samples_01.csv
@@ -0,0 +1,41 @@
+t_ns,y_clean,y_measured
+0.000000,1.000000000,1.000732601
+10.000000,0.827460473,0.823931624
+20.000000,0.684690835,0.687179487
+30.000000,0.566554602,0.569474969
+40.000000,0.468801539,0.462515263
+50.000000,0.387914743,0.383882784
+60.000000,0.320984117,0.321367521
+70.000000,0.265601669,0.264713065
+80.000000,0.219774883,0.219780220
+90.000000,0.181855029,0.179242979
+100.000000,0.150477848,0.153357753
+110.000000,0.124514471,0.126984127
+120.000000,0.103030803,0.103052503
+130.000000,0.085253917,0.088888889
+140.000000,0.070544247,0.071794872
+150.000000,0.058372576,0.055677656
+160.000000,0.048300999,0.049328449
+170.000000,0.039967168,0.037118437
+180.000000,0.033071251,0.035653236
+190.000000,0.027365153,0.027350427
+200.000000,0.022643583,0.021978022
+210.000000,0.018736670,0.016605617
+220.000000,0.015503854,0.019536020
+230.000000,0.012828826,0.012210012
+240.000000,0.010615346,0.009279609
+250.000000,0.008783780,0.007814408
+260.000000,0.007268230,0.008791209
+270.000000,0.006014173,0.007326007
+280.000000,0.004976491,0.006349206
+290.000000,0.004117849,0.005372405
+300.000000,0.003407358,0.010256410
+310.000000,0.002819454,0.001465201
+320.000000,0.002332987,0.000488400
+330.000000,0.001930454,-0.000488400
+340.000000,0.001597374,0.003418803
+350.000000,0.001321764,0.004884005
+360.000000,0.001093708,0.000976801
+370.000000,0.000905000,-0.001953602
+380.000000,0.000748852,-0.001953602
+390.000000,0.000619645,0.002442002
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig1_ideal_fit.png b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig1_ideal_fit.png
new file mode 100644
index 0000000..3a4170a
Binary files /dev/null and b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig1_ideal_fit.png differ
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig1_ideal_fit.svg b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig1_ideal_fit.svg
new file mode 100644
index 0000000..796cade
--- /dev/null
+++ b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig1_ideal_fit.svg
@@ -0,0 +1,2981 @@
+
+
+
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig2_noisy_fit.png b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig2_noisy_fit.png
new file mode 100644
index 0000000..c6a0763
Binary files /dev/null and b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig2_noisy_fit.png differ
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig2_noisy_fit.svg b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig2_noisy_fit.svg
new file mode 100644
index 0000000..0304028
--- /dev/null
+++ b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig2_noisy_fit.svg
@@ -0,0 +1,2450 @@
+
+
+
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig3_repeat_hist.png b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig3_repeat_hist.png
new file mode 100644
index 0000000..54ac694
Binary files /dev/null and b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig3_repeat_hist.png differ
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig3_repeat_hist.svg b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig3_repeat_hist.svg
new file mode 100644
index 0000000..ed3f9f1
--- /dev/null
+++ b/runs/20261012-142531-exp01_m0_baseline-seed42/figures/fig3_repeat_hist.svg
@@ -0,0 +1,1955 @@
+
+
+
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/meta.json b/runs/20261012-142531-exp01_m0_baseline-seed42/meta.json
new file mode 100644
index 0000000..9a2fc34
--- /dev/null
+++ b/runs/20261012-142531-exp01_m0_baseline-seed42/meta.json
@@ -0,0 +1,23 @@
+{
+ "created": "2026-10-12T14:25:31",
+ "git_hash": "ae1c774",
+ "algo_version": "M0+M1",
+ "data_origin": "software-simulated",
+ "experiment": "exp01_m0_baseline",
+ "notes": "M0 基准:①理想无噪恢复 τ=52.8 ns(偏差 1.35e-16);②SNR 50.0 dB 重复 20 次分布:均值 52.817 ns、相对标准差 0.42%。",
+ "seed": 42,
+ "params": {
+ "preset": "single",
+ "tau": 52.8,
+ "amplitude": 1.0,
+ "b0": 0.0,
+ "b1": 0.0,
+ "window_ns": 400.0,
+ "dt_ns": 10.0,
+ "t0_ns": 0.0,
+ "snr_db": null,
+ "bits": null,
+ "bandwidth_sigma_ns": 0.0,
+ "jitter_ns": 0.0
+ }
+}
\ No newline at end of file
diff --git a/runs/20261012-142531-exp01_m0_baseline-seed42/results.json b/runs/20261012-142531-exp01_m0_baseline-seed42/results.json
new file mode 100644
index 0000000..07885be
--- /dev/null
+++ b/runs/20261012-142531-exp01_m0_baseline-seed42/results.json
@@ -0,0 +1,76 @@
+[
+ {
+ "n_samples": 40,
+ "sigma": 0.0,
+ "fit": {
+ "model": "single_exp_baseline",
+ "A": 1.0,
+ "tau": 52.79999999999999,
+ "B": 1.0266620415102439e-18,
+ "A_err": 1.9362621758061532e-17,
+ "tau_err": 1.9615166264224552e-15,
+ "B_err": 6.062293500886438e-18,
+ "rmse": 2.5416494845256824e-17,
+ "popt": [
+ 1.0,
+ 52.79999999999999,
+ 1.0266620415102439e-18
+ ]
+ },
+ "tau_hat": 52.79999999999999,
+ "tau_true": 52.8,
+ "rel_error": 1.345724878333523e-16
+ },
+ {
+ "n_samples": 40,
+ "sigma": 0.0031622776601683794,
+ "fit": {
+ "model": "single_exp_baseline",
+ "A": 0.9990366113283486,
+ "tau": 52.680663852978405,
+ "B": 0.0005358588182398084,
+ "A_err": 0.0019436937887180427,
+ "tau_err": 0.1965391007368284,
+ "B_err": 0.0006073913105519374,
+ "rmse": 0.002549494999445439,
+ "popt": [
+ 0.9990366113283486,
+ 52.680663852978405,
+ 0.0005358588182398084
+ ]
+ },
+ "tau_hat": 52.680663852978405,
+ "tau_true": 52.8,
+ "rel_error": 0.0022601542996513618
+ },
+ {
+ "tau_true": 52.8,
+ "tau_hats": [
+ 52.680663852978405,
+ 52.82576197045851,
+ 52.56481574971219,
+ 52.93585788583081,
+ 52.57373057558753,
+ 52.79898656941285,
+ 52.72851790971544,
+ 52.262087737813474,
+ 52.66590413317728,
+ 52.913835714816585,
+ 52.97636434229677,
+ 53.160683941899684,
+ 53.044349877987266,
+ 52.76413580872595,
+ 52.829858544421626,
+ 52.694239286512634,
+ 52.77251197689155,
+ 52.91461485148457,
+ 53.171623053297985,
+ 53.06345101352244
+ ],
+ "n_samples": 40,
+ "mean": 52.81709973982718,
+ "std": 0.21946031281151027,
+ "rel_std": 0.0041550996531909985,
+ "bias": 0.00032385870884812175
+ }
+]
\ No newline at end of file
diff --git a/runs/20261012-142532-exp02_fiber_design/README.md b/runs/20261012-142532-exp02_fiber_design/README.md
new file mode 100644
index 0000000..5219a73
--- /dev/null
+++ b/runs/20261012-142532-exp02_fiber_design/README.md
@@ -0,0 +1,8 @@
+# 记录包:exp02_fiber_design
+
+M1 光纤设计:名义四组 0/9.70/19.40/29.10 m → 延时 0/47.5/95/142.5 ns → 相位 0/2.5/5.0/7.5 ns(均匀网格,最大间隔偏差 0 ns);反向设计复现原项目方案。
+
+- 运行时间:2026-10-12T14:25:32
+- git:ae1c774,算法版本:M0+M1
+- 数据来源:**软件仿真(software-simulated)**,非装置实测
+- 复现:`pytest fiber_delay_sim/tests/` 或重跑对应 experiments 脚本
diff --git a/runs/20261012-142532-exp02_fiber_design/figures/fig1_phase_positions.png b/runs/20261012-142532-exp02_fiber_design/figures/fig1_phase_positions.png
new file mode 100644
index 0000000..f899dcc
Binary files /dev/null and b/runs/20261012-142532-exp02_fiber_design/figures/fig1_phase_positions.png differ
diff --git a/runs/20261012-142532-exp02_fiber_design/figures/fig1_phase_positions.svg b/runs/20261012-142532-exp02_fiber_design/figures/fig1_phase_positions.svg
new file mode 100644
index 0000000..c377ad7
--- /dev/null
+++ b/runs/20261012-142532-exp02_fiber_design/figures/fig1_phase_positions.svg
@@ -0,0 +1,1585 @@
+
+
+
diff --git a/runs/20261012-142532-exp02_fiber_design/figures/fig2_phase_circle.png b/runs/20261012-142532-exp02_fiber_design/figures/fig2_phase_circle.png
new file mode 100644
index 0000000..609345c
Binary files /dev/null and b/runs/20261012-142532-exp02_fiber_design/figures/fig2_phase_circle.png differ
diff --git a/runs/20261012-142532-exp02_fiber_design/figures/fig2_phase_circle.svg b/runs/20261012-142532-exp02_fiber_design/figures/fig2_phase_circle.svg
new file mode 100644
index 0000000..938d043
--- /dev/null
+++ b/runs/20261012-142532-exp02_fiber_design/figures/fig2_phase_circle.svg
@@ -0,0 +1,1107 @@
+
+
+
diff --git a/runs/20261012-142532-exp02_fiber_design/figures/fig3_delay_segments.png b/runs/20261012-142532-exp02_fiber_design/figures/fig3_delay_segments.png
new file mode 100644
index 0000000..53d7827
Binary files /dev/null and b/runs/20261012-142532-exp02_fiber_design/figures/fig3_delay_segments.png differ
diff --git a/runs/20261012-142532-exp02_fiber_design/figures/fig3_delay_segments.svg b/runs/20261012-142532-exp02_fiber_design/figures/fig3_delay_segments.svg
new file mode 100644
index 0000000..e75b01f
--- /dev/null
+++ b/runs/20261012-142532-exp02_fiber_design/figures/fig3_delay_segments.svg
@@ -0,0 +1,1911 @@
+
+
+
diff --git a/runs/20261012-142532-exp02_fiber_design/meta.json b/runs/20261012-142532-exp02_fiber_design/meta.json
new file mode 100644
index 0000000..0086778
--- /dev/null
+++ b/runs/20261012-142532-exp02_fiber_design/meta.json
@@ -0,0 +1,9 @@
+{
+ "created": "2026-10-12T14:25:32",
+ "git_hash": "ae1c774",
+ "algo_version": "M0+M1",
+ "data_origin": "software-simulated",
+ "experiment": "exp02_fiber_design",
+ "notes": "M1 光纤设计:名义四组 0/9.70/19.40/29.10 m → 延时 0/47.5/95/142.5 ns → 相位 0/2.5/5.0/7.5 ns(均匀网格,最大间隔偏差 0 ns);反向设计复现原项目方案。",
+ "params": null
+}
\ No newline at end of file
diff --git a/runs/20261012-142532-exp02_fiber_design/results.json b/runs/20261012-142532-exp02_fiber_design/results.json
new file mode 100644
index 0000000..42eb475
--- /dev/null
+++ b/runs/20261012-142532-exp02_fiber_design/results.json
@@ -0,0 +1,81 @@
+[
+ {
+ "channels": [
+ {
+ "index": 0,
+ "length_m": 0.0,
+ "delay_ns": 0.0,
+ "phase_ns": 0.0
+ },
+ {
+ "index": 1,
+ "length_m": 9.700369042915531,
+ "delay_ns": 47.5,
+ "phase_ns": 7.5
+ },
+ {
+ "index": 2,
+ "length_m": 19.400738085831062,
+ "delay_ns": 95.0,
+ "phase_ns": 5.0
+ },
+ {
+ "index": 3,
+ "length_m": 29.101107128746598,
+ "delay_ns": 142.5,
+ "phase_ns": 2.5
+ }
+ ],
+ "sorted_phases_ns": [
+ 0.0,
+ 2.5,
+ 5.0,
+ 7.5
+ ],
+ "uniformity": {
+ "ideal_step_ns": 2.5,
+ "gaps_ns": [
+ 2.5,
+ 2.5,
+ 2.5,
+ 2.5
+ ],
+ "max_gap_dev_ns": 0.0,
+ "rms_gap_dev_ns": 0.0
+ },
+ "target_phases_ns": [
+ 0.0,
+ 2.5,
+ 5.0,
+ 7.5
+ ],
+ "is_uniform_grid": true,
+ "recommended": [
+ {
+ "phase_ns": 0.0,
+ "k": 0,
+ "delay_ns": 0.0,
+ "length_m": 0.0
+ },
+ {
+ "phase_ns": 2.5,
+ "k": 3,
+ "delay_ns": 142.5,
+ "length_m": 29.101107128746598
+ },
+ {
+ "phase_ns": 5.0,
+ "k": 2,
+ "delay_ns": 95.0,
+ "length_m": 19.400738085831062
+ },
+ {
+ "phase_ns": 7.5,
+ "k": 1,
+ "delay_ns": 47.5,
+ "length_m": 9.700369042915531
+ }
+ ],
+ "construction": "δk = k·(S − Δt/N),S=50 ns,Δt/N=2.5 ns"
+ }
+]
\ No newline at end of file
diff --git a/todo.md b/todo.md
index be7b37b..99ba33d 100644
--- a/todo.md
+++ b/todo.md
@@ -1,5 +1,5 @@
-#作业
+# 推进文档
## 文件列表
- 研究报告.pdf
@@ -14,7 +14,10 @@
后续任务:将硬件核心原理提炼为教学实验,开发可调参数的仿真软件(支持调光纤长度、噪声、采样率等),并撰写教学论文。不追求恢复整机硬件,重点在"让更多人能理解这个光学游标卡尺的原理"。
-1. 做一个网站来展示。域名https://chenxy.biboer.cn。部署到web(ssh web)。域名已创建,如下:
+1. 演示网站域名创建。https://chenxy.biboer.cn。自动化rsync同步部署。
+部署到web(ssh web)。
+域名已创建,如下:
+✅
```
gavin tools % ./dns.sh chenxy.biboer.cn
@@ -58,3 +61,7 @@ nginx: configuration file /etc/nginx/nginx.conf test is successful
[INFO] 完成。
```
+2. 创建项目分析、方案&目录结构 ✅
+
+3. 在macos中迭代,跨平台可用。
+