"""光纤延时与采样相位设计(仅依赖 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