Files
2026-10-12 14:26:51 +08:00

139 lines
5.4 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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