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

@@ -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 页),可视化素材与部分补充数据。
快速指路:想了解**原理与背景**读项目说明;想了解**实验设计与软件实现**读实现方案;两份文档按"先说明、后方"顺序配套阅读。

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

View File

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

View File

@@ -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
1 t_ns y_clean y_measured
2 0.000000 1.000000000 1.000000000
3 10.000000 0.827460473 0.827460473
4 20.000000 0.684690835 0.684690835
5 30.000000 0.566554602 0.566554602
6 40.000000 0.468801539 0.468801539
7 50.000000 0.387914743 0.387914743
8 60.000000 0.320984117 0.320984117
9 70.000000 0.265601669 0.265601669
10 80.000000 0.219774883 0.219774883
11 90.000000 0.181855029 0.181855029
12 100.000000 0.150477848 0.150477848
13 110.000000 0.124514471 0.124514471
14 120.000000 0.103030803 0.103030803
15 130.000000 0.085253917 0.085253917
16 140.000000 0.070544247 0.070544247
17 150.000000 0.058372576 0.058372576
18 160.000000 0.048300999 0.048300999
19 170.000000 0.039967168 0.039967168
20 180.000000 0.033071251 0.033071251
21 190.000000 0.027365153 0.027365153
22 200.000000 0.022643583 0.022643583
23 210.000000 0.018736670 0.018736670
24 220.000000 0.015503854 0.015503854
25 230.000000 0.012828826 0.012828826
26 240.000000 0.010615346 0.010615346
27 250.000000 0.008783780 0.008783780
28 260.000000 0.007268230 0.007268230
29 270.000000 0.006014173 0.006014173
30 280.000000 0.004976491 0.004976491
31 290.000000 0.004117849 0.004117849
32 300.000000 0.003407358 0.003407358
33 310.000000 0.002819454 0.002819454
34 320.000000 0.002332987 0.002332987
35 330.000000 0.001930454 0.001930454
36 340.000000 0.001597374 0.001597374
37 350.000000 0.001321764 0.001321764
38 360.000000 0.001093708 0.001093708
39 370.000000 0.000905000 0.000905000
40 380.000000 0.000748852 0.000748852
41 390.000000 0.000619645 0.000619645

View File

@@ -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
1 t_ns y_clean y_measured
2 0.000000 1.000000000 1.000732601
3 10.000000 0.827460473 0.823931624
4 20.000000 0.684690835 0.687179487
5 30.000000 0.566554602 0.569474969
6 40.000000 0.468801539 0.462515263
7 50.000000 0.387914743 0.383882784
8 60.000000 0.320984117 0.321367521
9 70.000000 0.265601669 0.264713065
10 80.000000 0.219774883 0.219780220
11 90.000000 0.181855029 0.179242979
12 100.000000 0.150477848 0.153357753
13 110.000000 0.124514471 0.126984127
14 120.000000 0.103030803 0.103052503
15 130.000000 0.085253917 0.088888889
16 140.000000 0.070544247 0.071794872
17 150.000000 0.058372576 0.055677656
18 160.000000 0.048300999 0.049328449
19 170.000000 0.039967168 0.037118437
20 180.000000 0.033071251 0.035653236
21 190.000000 0.027365153 0.027350427
22 200.000000 0.022643583 0.021978022
23 210.000000 0.018736670 0.016605617
24 220.000000 0.015503854 0.019536020
25 230.000000 0.012828826 0.012210012
26 240.000000 0.010615346 0.009279609
27 250.000000 0.008783780 0.007814408
28 260.000000 0.007268230 0.008791209
29 270.000000 0.006014173 0.007326007
30 280.000000 0.004976491 0.006349206
31 290.000000 0.004117849 0.005372405
32 300.000000 0.003407358 0.010256410
33 310.000000 0.002819454 0.001465201
34 320.000000 0.002332987 0.000488400
35 330.000000 0.001930454 -0.000488400
36 340.000000 0.001597374 0.003418803
37 350.000000 0.001321764 0.004884005
38 360.000000 0.001093708 0.000976801
39 370.000000 0.000905000 -0.001953602
40 380.000000 0.000748852 -0.001953602
41 390.000000 0.000619645 0.002442002

Binary file not shown.

After

Width:  |  Height:  |  Size: 61 KiB

File diff suppressed because it is too large Load Diff

After

Width:  |  Height:  |  Size: 72 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

File diff suppressed because it is too large Load Diff

After

Width:  |  Height:  |  Size: 63 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 41 KiB

File diff suppressed because it is too large Load Diff

After

Width:  |  Height:  |  Size: 50 KiB

View File

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

View File

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

View File

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

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

File diff suppressed because it is too large Load Diff

After

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

File diff suppressed because it is too large Load Diff

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

File diff suppressed because it is too large Load Diff

After

Width:  |  Height:  |  Size: 51 KiB

View File

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

View File

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

11
todo.md
View File

@@ -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中迭代,跨平台可用。