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