f(x)

Math Function

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

MathFunction 模块对输入的标量信号 u(t)u(t) 执行可配置的解析数学运算或整型舍入计算。支持的算法运算包括自然指数、对数(自然对数与以 10 为底的对数)、幂函数、浮点余数(取模)以及各类整型取整运算(四舍五入、向下取整、向上取整)。该模块广泛用于物理被控对象建模(如化学反应动力学、热力学传热方程、流体阻力计算、声学分贝标度转换)以及通用数字信号处理,无需编写自定义代码块。

数学模型

模块根据输入信号 u(t)u(t) 与辅助参数 constant(cc)计算输出 y(t)y(t):

y(t)=f(u(t),c)y(t) = f(u(t), c)

各可选数学算子的具体定义如下:

  • 自然指数 (exp):

```latex

y(t) = \exp(u(t)) = e^{u(t)}

```

  • 自然对数 (log):

```latex

y(t) = \ln(u(t)), \quad u(t) > 0

```

对于非正输入(u≤0u \le 0),模块返回 −∞-\infty,避免未受控的 NaN 污染下游计算。

  • 常用对数 (log10):

```latex

y(t) = \log_{10}(u(t)), \quad u(t) > 0

```

在 u≤0u \le 0 时同样安全返回 −∞-\infty。

  • 幂函数 (pow):

```latex

y(t) = (u(t))^c

```

以输入 u(t)u(t) 为底数,以参数 constant(cc)为指数进行幂运算。负底数配合非整数指数将产生实数域 NaN。

  • 浮点余数 (rem):

```latex

y(t) = u(t) \bmod c = u(t) - c \cdot \operatorname{trunc}\left(\frac{u(t)}{c}\right)

```

计算截断取模浮点余数,内置除以零保护(当 ∣c∣<10−6|c| < 10^{-6} 时安全返回 0.00.0)。

  • 四舍五入 (round):

```latex

y(t) = \operatorname{round}(u(t))

```

舍入到最接近的整数。

  • 向下取整 (floor):

```latex

y(t) = \lfloor u(t) \rfloor

```

舍入到小于或等于 u(t)u(t) 的最大整数。

  • 向上取整 (ceil):

```latex

y(t) = \lceil u(t) \rceil

```

舍入到大于或等于 u(t)u(t) 的最小整数。

输入与输出

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)仿真中,化学反应速率常数依阿伦尼乌斯定律随绝对温度呈指数变化:k(T)=Aexp⁡(−Ea/(RT))k(T) = A \exp(-E_a / (R T))。将无量纲活化能比值项 −Ea/(RT)-E_a / (R T) 接入设置为 function = "exp" 的 MathFunction 模块,并将输出乘以指前因子 AA,即可精准仿真连续化学反应速率。

示例 2:声压级分贝标度转换 (dB SPL)

在声学测量仪表中,需将测得的有效声压 prmsp_{\text{rms}} 转换为相对于人耳听阈(p0=20 μPap_0 = 20\ \mu\text{Pa})的分贝值:Lp=20log⁡10(prms/p0)L_p = 20 \log_{10}(p_{\text{rms}} / p_0)。将测量声压除以参考基准 p0p_0 后接入设置为 function = "log10" 的 MathFunction 模块,随后级联增益为 20 的 Gain 模块,即可输出标定分贝读数。

说明与最佳实践

  • 对数定义域越界防护:对于非正输入(u≤0u \le 0),log 和 log10 运算返回 −∞-\infty 而非 NaN,便于下游 Saturation 或 MinMax 限幅模块进行安全钳位,避免污染整个仿真计算流水线。
  • 除以零浮点硬件保护:在执行 rem 取模运算时,若除数绝对值 ∣c∣<10−6|c| < 10^{-6},模块强制返回 0.00.0,彻底消除浮点异常中断。
  • 分数次幂实数限制:在实数域内对负底数计算非整数次幂(如 c=0.5c = 0.5)将产生数学 NaN。如需专门的负数自适应开方功能,推荐使用 SquareRoot 模块。
  • 无状态高效 WebAssembly 计算:在底座 Rust 内核中作为无内部状态累加的原生机器算术指令执行,每次计算耗时不足 5 纳秒。

相关模块

  • SquareRoot: 具备负数输入自适应安全保护模式的专用开方根模块。
  • Trigonometric: 三角函数与双曲函数库(sin⁡\sin, cos⁡\cos, tan⁡\tan 等)。
  • Abs: 绝对值计算与符号提取环节。
  • Gain: 纯线性常数比例增益放大环节。