2-D Lookup Table
MathLookupTable2D 模块通过在二维矩形网格上进行双线性或双三次样条插值,将两个独立的输入信号( 和 )映射为输出值 。它用于对复杂双变量非线性函数进行精确建模,其中物理响应同时取决于两个运行工况变量——例如永磁同步电机效率图(转速 与转矩 )、内燃机燃油喷射脉谱图(转速 与进气歧管压力 )、压气机增压比特性曲线以及气动阻力极曲线。
在属性编辑器中,三组序列(顶部 列标题、左侧 行标题及内部 矩阵单元格)在类 Excel 二维矩阵电子表格(二维矩阵 (Y \ X → Z))中直观编辑,同时配备实时多切片 LUT 曲线预览(z = f(x, y))。可通过 +X 与 +Y 动态增删行列,并通过 CSV 导入 / 导出(lut2d_data.csv) 直接加载或保存完整二维标定表(支持逗号 ,、分号 ; 与制表符 \t)。
数学模型
设给定 个严格递增的坐标 以及 个严格递增的坐标 ,网格输出数据 按行主序(Row-Major)展平排布。
对于落在网格单元 内的输入坐标 ,归一化局部坐标 和 计算如下:
双线性插值计算得到的曲面输出值 为:
当 extrapolation 设置为 clip 时,超出网格边界的输入坐标在曲面计算前被钳位在 和 内:
当设置为 linear 时,模块沿最近边界网格单元的双线性切平面向外线性投影外推。
输入与输出
| Direction | ID | Label | 类型 | Status |
|---|---|---|---|---|
| → In | in1 |
x | number | Required |
| → In | in2 |
y | number | Required |
| ← Out | out |
Out | number | Output |
参数
| 参数 | Label | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
xBreakpoints |
2D Lookup Table (X / Y / Z) | table-2d | 0 1 |
|
yBreakpoints |
Y Breakpoints | text | 0 1 |
|
tableData |
Table Data (row-major) | text | 0 1 1 2 |
|
interpolation |
Interpolation | select | linear |
|
extrapolation |
Extrapolation | select | linear |
使用示例
示例 1:永磁同步电机 (PMSM) 综合效率脉谱图建模
在纯电动汽车动力总成仿真中,驱动电机效率随电机转速与输出转矩呈现强烈非线性变化。在二维矩阵编辑器中输入 列标题 500 1500 3000 6000(RPM)、 行标题 10 50 100 150(Nm)以及 16 个效率单元格(或直接导入台架标定 CSV),即可在急加速和再生制动工况下连续高保真计算瞬时驱动效率。
示例 2:发动机每缸每循环燃油喷射质量标定脉谱
建模每循环每缸喷油质量,作为进气歧管绝对压力(MAP,横轴 单位 kPa:20 40 60 80 100)和发动机转速(纵轴 单位 RPM:1000 2000 3000 4000 5000)的函数。将 extrapolation 设置为 clip,可防止涡轮迟滞瞬态期间压力超调外推至未标定的危险空燃比区域。
说明与最佳实践
- 二维类 Excel 矩阵电子表格与实时预览:双击模块即可打开
Y \ X矩阵表格,顶部行定义 断点、左侧列定义 断点、内部单元格定义 ,右侧实时绘制每条 切片曲线。 - CSV 保存与加载(导入 / 导出):点击导出 CSV 可将二维矩阵保存为
lut2d_data.csv(左上角为空格,第一行为 断点,后续每行以 断点开头后接 值);点击导入 CSV 可从 Excel/CSV 批量导入二维脉谱。 - 行优先(Row-Major)数据排布:底层
tableData按行主序排布:先依次存储第一行 对应的所有 列数据,再存储下一行 的数据。 - 坐标严格单调性:
xBreakpoints与yBreakpoints均必须严格单调递增。 - 独立对数级双轴二分检索:仿真引擎在两轴上分别独立执行 时间复杂度的二分检索,确保稠密网格下的实时计算性能。
常见工程问题解答 (FAQ)
Q: How is bilinear interpolation computed across a 2D grid in real-time simulation?
For input coordinates falling in cell , normalized fractions and are calculated. The output is . Monotonic breakpoint ordering enables binary search, guaranteeing constant-time evaluation in 60fps WebAssembly simulation.
相关模块
- LookupTable: 配备交互式双列电子表格并支持线性与三次样条插值的一维查表模块。
- Product: 两个动态输入信号的乘法积运算。
- MathFunction: 通用标准解析数学函数库(, , )。