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

View File

@@ -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"

Binary file not shown.

Binary file not shown.

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:])

View File

@@ -0,0 +1,5 @@
"""算法核心层:signal / fiber / acquisition / fitting(全部 Pyodide 兼容)。"""
from . import signal, fiber, acquisition, fitting
__all__ = ["signal", "fiber", "acquisition", "fitting"]

Binary file not shown.

View File

@@ -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),
}

View File

@@ -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

View File

@@ -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),
}

View File

@@ -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

View File

@@ -0,0 +1 @@
"""实验脚本(本地层:可使用 matplotlib;每个脚本产出论文/教学的一个完整记录包)。"""

View File

@@ -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

View File

@@ -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)

View File

@@ -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)

View File

@@ -0,0 +1,5 @@
"""导出层:实验记录包落盘(本地专用,Pyodide 不加载本模块)。"""
from . import record
__all__ = ["record"]

View File

@@ -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

101
fiber_delay_sim/pipeline.py Normal file
View File

@@ -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,
}

View File

@@ -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