sqrt

fi 对象的平方根

全页折叠

语法

c = sqrt(a)

c = sqrt(a,T)

c = sqrt(a,F)

c = sqrt(a,T,F)

说明

此函数使用对分算法计算 fi 对象的平方根。

c = sqrt(a) 返回 fi 对象 a 的平方根。使用与 a 相关联的 fimath 来计算中间量。c 的 numerictype 对象是使用内部规则自动确定的。

c = sqrt(a,T) 使用 numerictype 对象 T 返回 fi 对象 a 的平方根。使用与 a 相关联的 fimath 来计算中间量。请参阅数据类型传播规则。

c = sqrt(a,F) 返回 fi 对象 a 的平方根。使用 fimath 对象 F 计算中间量。c 的 numerictype 对象是使用内部规则自动确定的。

当 a 是内置的 double 或 single 数据类型时，此语法等效于 c = sqrt(a)，并且忽略 fimath 对象 F。

c = sqrt(a,T,F) 使用 numerictype 对象 T 返回 fi 对象 a 的平方根。中间量也使用 fimath 对象 F 来计算。请参阅数据类型传播规则。

输入参数

全部折叠

`a` — 输入 `fi` 数组
标量 | 向量 | 矩阵 | 多维数组

输入 fi 数组，指定为标量、向量、矩阵或多维数组。

sqrt 不支持复杂、负值或 [斜率偏置] 输入。

示例: a = fi(pi,1,8,3)

数据类型: fi

`T` — 输出的 `numerictype`
`numerictype` 对象

输出 c 的 numerictype，指定为 numerictype 对象。

示例: T = numerictype(1,32,30)

`F` — `fimath` 用于计算中间量
`fimath` 对象

fimath 用于计算中间量，指定为 fimath 对象。

示例: F = fimath('OverflowAction','Saturate','RoundingMethod','Convergent')

算法

全部折叠

内部规则

对于未将输出的 numerictype 对象指定为 sqrt 函数的输入的语法，它将根据以下内部规则自动计算：

$s i g n_{c} = s i g n_{a}$

$W L_{c} = ceil (\frac{W L_{a}}{2})$

$F L_{c} = W L_{c} - ceil (\frac{W L_{a} - F L_{a}}{2})$

数据类型传播规则

对于您指定 numerictype 对象 T 的语法，sqrt 函数遵循下表中列出的数据类型传播规则。一般情况下，这些规则可以概括为“传播浮点数据类型”。这样，您可以编写同时适用于定点和浮点输入的代码。

输入 fi 对象 a 的数据类型	numerictype 对象 T 的数据类型	输出 c 的数据类型
内置 `double`	任一值	内置 `double`
内置 `single`	任一值	内置 `single`
`fi` `Fixed`	`fi` `Fixed`	`numerictype` 对象 `T` 的数据类型
`fi` `ScaledDouble`	`fi` `Fixed`	具有 `T` 对象 `numerictype` 的属性的 `ScaledDouble`
`fi` `double`	`fi` `Fixed`	`fi` `double`
`fi` `single`	`fi` `Fixed`	`fi` `single`
任何 `fi` 数据类型	`fi` `double`	`fi` `double`
任何 `fi` 数据类型	`fi` `single`	`fi` `single`

扩展功能

全部展开

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

使用说明和限制：

不支持复数输入。
不支持斜率偏置定标输入。
对于生成的 C 代码，负输入产生 0 结果。
MATLAB^® 可执行 (MEX) 代码生成不支持负输入。

HDL 代码生成
使用 HDL Coder™ 为 FPGA 和 ASIC 设计生成 VHDL、Verilog 和 SystemVerilog 代码。

版本历史记录

在 R2006b 中推出

另请参阅

fi | fimath | numerictype