📋

Lookup Table

Math
运行在线示例 免费 · 无需注册 · 直接在浏览器中运行

LookupTable 模块实现具有可配置线性或三次样条插值与外推方法的一维查表环节(LUT)。它利用一组严格单调递增的输入断点(XX)和对应的输出数值(YY),将任意标量输入 uu 映射为插值输出值 yy。

在属性编辑器中,XX 与 YY 两列数据通过类 Excel 交互式电子表格(数据表 (X / Y))并排编辑,同时配备实时 LUT 曲线预览(y = f(x)),即时展示每个数据节点及所选插值方式(linear 或 spline)的曲线形态。此外,支持通过 CSV 导入 / 导出(lut_data.csv) 直接加载与保存标定表(兼容逗号 ,、分号 ; 和制表符 \t 分隔的 Excel/CSV 文件)。

数学模型

设给定 NN 个严格单调递增的输入断点 x0<x1<⋯<xN−1x_0 < x_1 < \dots < x_{N-1} 及对应的表格数据 y0,y1,…,yN−1y_0, y_1, \dots, y_{N-1}:

对于落在断点区间 xk≤u≤xk+1x_k \le u \le x_{k+1}(0≤k<N−10 \le k < N-1)内的输入值 uu:

y(u)=yk+yk+1−ykxk+1−xk(u−xk)y(u) = y_k + \frac{y_{k+1} - y_k}{x_{k+1} - x_k} (u - x_k)

当 interpolation 配置为 spline 时,模块通过所有数据点构造三次样条曲线,确保跨越数据节点时具有连续的一阶与二阶导数(C2C^2 连续性):

y(u)=ak(u−xk)3+bk(u−xk)2+ck(u−xk)+dky(u) = a_k (u - x_k)^3 + b_k (u - x_k)^2 + c_k (u - x_k) + d_k

当输入 uu 超出断点所定义的定义域(u<x0u < x_0 或 u>xN−1u > x_{N-1})时,输出由 extrapolation 外推模式决定:

y(u)={y0,u<x0(extrapolation=clip)yN−1,u>xN−1(extrapolation=clip)y0+y1−y0x1−x0(u−x0),u<x0(extrapolation=linear)yN−1+yN−1−yN−2xN−1−xN−2(u−xN−1),u>xN−1(extrapolation=linear)y(u) = \begin{cases} y_0, & u < x_0 \quad (\text{extrapolation} = \text{clip}) \\ y_{N-1}, & u > x_{N-1} \quad (\text{extrapolation} = \text{clip}) \\ y_0 + \frac{y_1 - y_0}{x_1 - x_0}(u - x_0), & u < x_0 \quad (\text{extrapolation} = \text{linear}) \\ y_{N-1} + \frac{y_{N-1} - y_{N-2}}{x_{N-1} - x_{N-2}}(u - x_{N-1}), & u > x_{N-1} \quad (\text{extrapolation} = \text{linear}) \end{cases}

输入与输出

Direction ID Label 类型 Status
→ In in In number Required
← Out out Out number Output

参数

参数 Label 类型 默认值 描述
breakpoints Lookup Table (X / Y) table 0 1 2 3
tableData Table Data text 0 1 4 9
interpolation Interpolation select linear
extrapolation Extrapolation select clip

使用示例

示例 1:NTC 热敏电阻温度阻抗非线性校准

在测温采集电路中,负温度系数(NTC)热敏电阻呈现高度非线性的指数阻抗变化。在 LookupTable 电子表格中输入 ADC 电压 X=[0.5,1.2,2.1,3.3,4.2]X = [0.5, 1.2, 2.1, 3.3, 4.2] 与标定温度 Y=[−10,15,45,80,110]Y = [-10, 15, 45, 80, 110](或直接导入标定 CSV 文件),即可在工作范围内输出高精度线性化摄氏温度(∘C^\circ\text{C})。

示例 2:带失速截断保护的机翼升力系数曲线

仿真随迎角 α\alpha(度)变化的气动升力系数 CLC_L。断点 -15 -10 0 10 15 20 映射到升力数据 -0.8 -0.6 0.1 1.1 1.4 0.9。将 extrapolation 设置为 clip,可确保在极端强阵风工况下迎角超出失速临界角时,升力输出不会线性外推为非物理的超音速虚假力。

说明与最佳实践

  • 类 Excel 电子表格与实时曲线预览:双击模块即可打开带行号的双列数据表(X 与 Y),支持 + 添加行 (数据点)、删除行(×)以及实时更新的 uPlot 曲线预览。
  • CSV 保存与加载(导入 / 导出):点击导出 CSV 可将当前表格保存为 lut_data.csv;点击导入 CSV 可从 Excel/CSV 文件(支持逗号、分号或制表符分隔)批量导入测试数据。
  • 断点严格单调性要求:breakpoints(XX)中的数值会自动按升序排列(xk+1>xkx_{k+1} > x_k)。
  • 高效对数级二分搜索:WebAssembly 仿真内核采用时间复杂度为 O(log⁡N)O(\log N) 的二分查找定位活动区间,即便对于大型数据集也能保持极速执行。
  • 高阶导数平滑性:选取 spline 插值可消除节点处的斜率尖点,在与 RK45 或 TR-BDF2 等变步长求解器协同计算时保证高数值收敛性。

常见工程问题解答 (FAQ)

Q: How does lookup table interpolation handle out-of-bounds input values?

BlockWerk clamps inputs to the table boundary limits [xmin⁡,xmax⁡][x_{\min}, x_{\max}] (flat extrapolation) by default. Flat clamping protects physical models (e.g. non-negative friction, engine torque maps, or fluid density) against runaway divergence, whereas unrestricted linear extrapolation can produce non-physical negative values that crash downstream ODE solvers.

相关模块

  • LookupTable2D: 配备二维矩阵电子表格并支持双线性/双三次样条曲面插值的二维查表模块 z=f(x,y)z = f(x, y)。
  • MathFunction: 通用标准解析数学函数库(exp⁡\exp, ln⁡\ln, pow\text{pow}, round\text{round})。
  • Saturation: 将动态信号严格限制在静态常数上下限之间。