Math Function
MathMathFunction 模块对输入的标量信号 执行可配置的解析数学运算或整型舍入计算。支持的算法运算包括自然指数、对数(自然对数与以 10 为底的对数)、幂函数、浮点余数(取模)以及各类整型取整运算(四舍五入、向下取整、向上取整)。该模块广泛用于物理被控对象建模(如化学反应动力学、热力学传热方程、流体阻力计算、声学分贝标度转换)以及通用数字信号处理,无需编写自定义代码块。
数学模型
模块根据输入信号 与辅助参数 constant()计算输出 :
各可选数学算子的具体定义如下:
- 自然指数 (
exp):
```latex
y(t) = \exp(u(t)) = e^{u(t)}
```
- 自然对数 (
log):
```latex
y(t) = \ln(u(t)), \quad u(t) > 0
```
对于非正输入(),模块返回 ,避免未受控的 NaN 污染下游计算。
- 常用对数 (
log10):
```latex
y(t) = \log_{10}(u(t)), \quad u(t) > 0
```
在 时同样安全返回 。
- 幂函数 (
pow):
```latex
y(t) = (u(t))^c
```
以输入 为底数,以参数 constant()为指数进行幂运算。负底数配合非整数指数将产生实数域 NaN。
- 浮点余数 (
rem):
```latex
y(t) = u(t) \bmod c = u(t) - c \cdot \operatorname{trunc}\left(\frac{u(t)}{c}\right)
```
计算截断取模浮点余数,内置除以零保护(当 时安全返回 )。
- 四舍五入 (
round):
```latex
y(t) = \operatorname{round}(u(t))
```
舍入到最接近的整数。
- 向下取整 (
floor):
```latex
y(t) = \lfloor u(t) \rfloor
```
舍入到小于或等于 的最大整数。
- 向上取整 (
ceil):
```latex
y(t) = \lceil u(t) \rceil
```
舍入到大于或等于 的最小整数。
输入与输出
| Direction | ID | Label | 类型 | Status |
|---|---|---|---|---|
| → In | in |
Input | number | Required |
| ← Out | out |
Output | number | Output |
参数
| 参数 | Label | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
function |
Function | select | exp |
|
constant |
Constant (n) | number | 2 |
使用示例
示例 1:化学反应工程中阿伦尼乌斯动力学速率计算
在连续搅拌反应釜(CSTR)仿真中,化学反应速率常数依阿伦尼乌斯定律随绝对温度呈指数变化:。将无量纲活化能比值项 接入设置为 function = "exp" 的 MathFunction 模块,并将输出乘以指前因子 ,即可精准仿真连续化学反应速率。
示例 2:声压级分贝标度转换 (dB SPL)
在声学测量仪表中,需将测得的有效声压 转换为相对于人耳听阈()的分贝值:。将测量声压除以参考基准 后接入设置为 function = "log10" 的 MathFunction 模块,随后级联增益为 20 的 Gain 模块,即可输出标定分贝读数。
说明与最佳实践
- 对数定义域越界防护:对于非正输入(),
log和log10运算返回 而非 NaN,便于下游 Saturation 或 MinMax 限幅模块进行安全钳位,避免污染整个仿真计算流水线。 - 除以零浮点硬件保护:在执行
rem取模运算时,若除数绝对值 ,模块强制返回 ,彻底消除浮点异常中断。 - 分数次幂实数限制:在实数域内对负底数计算非整数次幂(如 )将产生数学 NaN。如需专门的负数自适应开方功能,推荐使用 SquareRoot 模块。
- 无状态高效 WebAssembly 计算:在底座 Rust 内核中作为无内部状态累加的原生机器算术指令执行,每次计算耗时不足 5 纳秒。
相关模块
- SquareRoot: 具备负数输入自适应安全保护模式的专用开方根模块。
- Trigonometric: 三角函数与双曲函数库(, , 等)。
- Abs: 绝对值计算与符号提取环节。
- Gain: 纯线性常数比例增益放大环节。