计算x的平方根。x的编码必须为无符号。

该函数仅支持定点 数据类型。


icon

对话框选项

选项 说明
定点配置

指定该函数的输入和输出接线端的 编码、字长和整数字长 。您指定的配置决定了接线端的 取值范围

  • x类型

    指定x输入接线端的定点配置。

    如连线定点数据类型至该接线端且该数据类型符合该接线端的准则,LabVIEW将禁用该部分,并使用接线端的信息。如连线不符合该准则的定点数据类型至该接线端,LabVIEW将断开连线。

    • 字长-指定接线端的字长。
    • 数字长-指定接线端的整数字长。
    • 符号-指定该接线端有符号。LabVIEW会将编码设置为无符号并使该选项变灰。
    • 无符号-指定该接线端无符号。LabVIEW会将编码设置为无符号并使该选项变灰。
  • sqrt(x)类型

    指定sqrt(x)输出接线端的定点配置。

    • 包含溢出状态-指定输出接线端是否包含溢出状态。LabVIEW将该状态传播给下面数据流节点。包含该状态需要附加的FPGA资源。默认情况下未勾选该复选框。

      如勾选该复选框,溢出状态在下列任一情况下变为TRUE:

      • 输入接线端的溢出状态为TRUE。
      • 在函数运算时产生溢出。

      如勾选了匹配至源复选框,LabVIEW根据输入接线端是否包含该状态设置包含溢出状态

    • 字长-指定接线端的字长。
    • 符号-指定该接线端有符号。sqrt(x) 始终大于等于0,因此LabVIEW将编码设置为 无符号 ,并使该选项变暗。
    • 无符号-指定该接线端无符号。sqrt(x) 始终大于等于0,因此LabVIEW将编码设置为 无符号 ,并使该选项变暗。
    • 数字长-指定接线端的整数字长。LabVIEW将根据x类型部分中指定的整数字长来设置该值并使该选项变灰。
    • Adapt tosource-指定LabVIEW是否自动调整输出数据类型的定点配置溢出。该复选框默认为已勾选并且LabVIEW将禁用以下选项。
      注: 由于平方根的精度可能为无穷大,因此始终会出现舍入误差。
  • 溢出模式

    指定该函数如何处理溢出。可选择绕回(默认)或饱和

    注:环绕 选项相比, 饱和 选项需要更多的FPGA资源和更长的组合路径。在该情况下,选择饱和可能降低该函数可获取的最大时钟速率。
  • 舍入模式

    指定该函数如何 入输出数据。可选择截断舍入(默认)、半值向上奇偶舍入。您选择的选项可能影响该函数所需的资源量

执行模式

指定函数的运算方式。

  • 在单周期定时循环之外

    将该Express VI配置为在外部执行单周期定时循环

    如选中该选项并将Express VI置于单周期定时循环中,编译FPGA VI时, 代码生成错误 窗口报告错误。

  • 单周期定时循环内部

    将该Express VI配置为在单周期定时循环内部执行。

    如选择该选项且Express VI位于单周期定时循环外,代码生成错误窗口将在用户编译FPGA VI时报告错误。

  • 吞吐量-

    指定有效输入数据相邻两值之间的最小周期数。在该控件输入一个较低值可获取高吞吐率。吞吐率最大值取决于输出接线端的字长。只有在选择在单周期定时循环内选项后,该选项才可用。

    如选择单周期定时循环外部,该函数将在每次调用函数时返回一个有效结果。因此, 吞吐量 控件显示 1个调用/采样配置反馈显示控件显示该函数用于返回有效结果的时钟周期的数量。

寄存器

指定是否添加用于函数输入和/或输出的内部寄存器 。上述寄存器将被放置在任意嵌入式资源的外部,例如块乘法器或DSP48E逻辑片。只有在选择在单周期定时循环内选项后,该部分可用。

注: 添加寄存器可以减少组合路径,可防止组合路径过长导致的编译错误。但添加寄存器的同时增加了函数的延迟,即函数需要额外的时钟周期以返回有效结果。
  • 寄存器输入-在该函数的输入之后添加内部寄存器。选择该选项可将该函数的延迟增加一个周期。
  • 寄存器输出-在该函数的输出前添加内部寄存器。选择该选项可将该函数的延迟增加一个周期。
可选接线端

指定用于显示可选程序框图接线端的设置。

  • 运算溢出-指定该函数在程序框图上显示 运算溢出 输出接线端。该接线端表示在函数运算中是否发生溢出。
配置反馈

显示关于该函数运行的相关信息。该信息由指定的配置选项确定。

输入/输出

  • cunkn.png x

    指定该函数的输入。x必须是不带符号的数。

  • 输入有效

    指定下一个数据点是否已就绪。连线上方数据流节点的输出有效输入有效,将上方数据流节点的数据传输至该Express VI。

    要显示该握手 接线端,在配置对话框中选择 内部单周期定时循环

  • 输出就绪

    指定后续节点是否已就绪以便该Express VI返回一个新值。默认值为TRUE。使用反馈节点 连接到下游节点 的输入就绪,连接到当前节点的输出就绪

    注: 如在给定周期内 准备好输出 为FALSE,则 输出有效 在该周期内返回FALSE。

    如要显示输出就绪,可在配置对话框中选择在单周期定时循环内

  • iunkn.png sqrt(x)

    返回x的平方根。

  • 运算溢出

    如理论计算出的值超出了输出数据类型的有效范围则返回TRUE。如运算溢出返回TRUE,溢出模式选项将判定函数返回的值。

    仅当勾选运算溢出复选框时,LabVIEW才会显示运算溢出接线端。该复选框位于配置对话框的可选接线端部分。

  • 输出有效

    如果该Express VI的计算结果可用于后续节点,将返回TRUE。使用 输出有效与其他FPGA VI和函数 握手

    如要显示输出有效,可在配置对话框中选择在单周期定时循环内

  • 输入就绪

    如该Express VI可接受新的输入数据,将返回TRUE。通过反馈节点连线输入就绪至上方数据流节点的输出就绪

    注:输入就绪 在给定周期内返回FALSE, LabVIEW将丢弃其他节点在下一个周期内发送至该Express VI的数据。即使在后续周期中,输入有效为TRUE,LabVIEW也会舍弃数据。

    如要显示输入就绪,可在配置对话框中选择在单周期定时循环内

  • 如勾选匹配至源复选框,如下列条件均为真,sqrt(x)输出接线端将产生溢出。

    • 凑整模式半值向上奇偶舍入
    • x整数字节长度为偶数。
    • 下列关系为TRUE:

      ,其中 fwl 是指接线端的小数字长,iwl 是指接线端的整数字长。

    按照下列步骤避免上述情况溢出:

    1. 取消勾选匹配至源复选框。
    2. 增加sqrt(x)接线端的字节长度

    完成上述步骤后,LabVIEW不会自动调整sqrt(x)接线端的定点数配置。如更改了x接线端的定点数配置并要避免溢出,可再次勾选匹配至源复选框。LabVIEW将自动调整sqrt(x)的定点数配置。然后完成上述步骤1至2,以确保更新的定点数配置无溢出。

    范例

    参考LabVIEW FPGA模块中包含的下列范例文件。

    • labview\examples\CompactRIO\FPGA Fundamentals\FPGA Math and Analysis\High-Throughput Math\Vector Normalization\Vector Normalization.lvproj
    • labview\examples\R Series\FPGA Fundamentals\FPGA Math and Analysis\High-Throughput Math\Vector Normalization\Vector Normalization.lvproj