32-bit Scalar Float API

float_s64_t float_s32_to_float_s64()

将float_s32_t类型转换为float_s64_t类型。

参数:

• const float_s32_t x – [in] 输入值

返回值:

• 表示x的float_s64_t类型

---

float float_s32_to_float()

将float_s32_t类型转换为IEEE754标准的float类型。

参数:

• const float_s32_t x – [in] 输入值

返回值:

• 表示x的float类型

---

double float_s32_to_double()

将float_s32_t类型转换为IEEE754标准的double类型。

参数:

• const float_s32_t x – [in] 输入值

返回值:

• 表示x的double类型

---

float_s32_t float_s32_mul()

将两个float_s32_t类型相乘。

将输入的$x$和$y$相乘得到结果$a$，并返回。

操作:

$a \leftarrow x \cdot y$

参数:

• const float_s32_t x – [in] 输入操作数$x$
• const float_s32_t y – [in] 输入操作数$y$

返回值:

• $x$和$y$的乘积

---

float_s32_t float_s32_add()

将两个float_s32_t类型相加。

将输入的$x$和$y$相加得到结果$a$，并返回。

操作:

$a \leftarrow x + y$

参数:

• const float_s32_t x – [in] 输入操作数$x$
• const float_s32_t y – [in] 输入操作数$y$

返回值:

• $x$和$y$的和

---

float_s32_t float_s32_sub()

将一个float_s32_t类型减去另一个float_s32_t类型。

将输入的$y$从输入的$x$中减去得到结果$a$，并返回。

操作:

$a \leftarrow x - y$

参数:

• const float_s32_t x – [in] 输入操作数$x$
• const float_s32_t y – [in] 输入操作数$y$

返回值:

• $x$和$y$的差

---

float_s32_t float_s32_div()

将一个float_s32_t类型除以另一个float_s32_t类型。

将输入的$x$除以输入的$y$得到结果$a$，并返回。

操作:

$a \leftarrow \frac{x}{y}$

参数:

• const float_s32_t x – [in] 输入操作数$x$
• const float_s32_t y – [in] 输入操作数$y$

返回值:

• $x / y$的结果

异常:

• 如果$y$为$0$，则抛出ET_ARITHMETIC异常

---

float_s32_t float_s32_abs()

获取float_s32_t类型的绝对值。

返回$x$的绝对值$a$。

操作:

$a \leftarrow \left| x \right|$

参数:

• const float_s32_t x – [in] 输入操作数$x$

返回值:

• $x$的绝对值

---

unsigned float_s32_gt()

判断一个float_s32_t类型是否大于另一个。

比较输入的$x$和$y$。如果$x$大于$y$，则结果$a$为真；否则为假。返回$a$。

操作:

$a \leftarrow \begin{cases} 1 & x > y \\ 0 & 其他情况 \end{cases}$

参数:

• const float_s32_t x – [in] 输入操作数$x$
• const float_s32_t y – [in] 输入操作数$y$

返回值:

• 如果$x > y$，则返回$1$；否则返回$0$

---

unsigned float_s32_gte()

判断一个 float_s32_t 是否大于或等于另一个。

对输入的 $x$ 和 $y$ 进行比较。结果 $a$ 当且仅当 $x$ 大于或等于 $y$ 时为真，否则为假。返回 $a$。

操作：

$a \leftarrow \begin{cases} 1 & x \geq y \\ 0 & 其他情况 \end{cases}$

参数：

• const float_s32_t x – [in] 输入操作数 $x$

• const float_s32_t y – [in] 输入操作数 $y$

返回值：

当且仅当 $x \geq y$ 时为 1；否则为 0

---

float_s32_t float_s32_ema()

更新指数移动平均值（EMA）。

该函数通过应用单个新样本来更新指数移动平均值。$x$ 被视为先前的 EMA 状态，$y$ 是新样本。EMA 系数 $\alpha$ 被应用于包含 $x$ 的项。

coef 是一个使用 UQ2.30 格式表示的定点值（即隐含指数为 $-30$），应在范围 $0 \leq \alpha \leq 1$ 内。

操作：

$a \leftarrow \alpha \cdot x + (1 - \alpha) \cdot y$

参数：

• const float_s32_t x – [in] 输入操作数 $x$

• const float_s32_t y – [in] 输入操作数 $y$

• const uq2_30 coef – [in] 使用 UQ2.30 格式编码的 EMA 系数 $\alpha$

返回值：

新的 EMA 状态

---

float_s32_t float_s32_sqrt()

获取 float_s32_t 的平方根。

该函数计算 $x$ 的平方根。结果 $a$ 被返回。

通过 XMATH_BFP_SQRT_DEPTH_S32 配置参数可以配置计算 $a$ 的精度。它表示要计算的最高有效位数。

操作：

$a \leftarrow \sqrt{x}$

警告：

$x$ 必须为非负数才能得到正确的结果。

参数：

• const float_s32_t x – [in] 输入操作数 $x$

返回值：

$x$ 的平方根

---

float_s32_t float_s32_exp()

计算 $e^x$

该函数计算实数输入 $x$ 的 $e^x$。

如果 $x$ 知道在区间 $[-0.5,0.5]$ 内，可以使用 q30_exp_small()（该函数在内部使用）来提高速度。

操作：

$y \leftarrow e^x$

参数：

• const float_s32_t x – [in] 输入值 $x$

返回值：

$y$