update at 2026-10-12 14:26:51
This commit is contained in:
138
fiber_delay_sim/core/fiber.py
Normal file
138
fiber_delay_sim/core/fiber.py
Normal 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
|
||||
Reference in New Issue
Block a user