跳到正文
Learn-SCL
SCL 示例库/SCL 指令手册/SCL SQRT — 平方根

SCL SQRT — 平方根

求平方根;输入不能为负。

数学 S7-1200/1500 TIA V19 别名:平方根 / SQRT

在 TIA 里试一下

通过 TiaLink 把本页示例(FB_Sqrt_Demo)作为“外部源”导入你当前打开的 TIA Portal 项目:预检、生成块、编译,并清理外部源。导入后不会自动保存;FB 导入后需要在 OB 里调用。

TiaLink 设置

默认 http://localhost:8080。也可以在本页地址后加 ?tialink= 临时指定。

TiaLink 启动时若设置了 --api-token,这里要填相同的值;只保存在本机浏览器 localStorage,不会上传。

一句话

答案:#Result := SQRT(#Value) 返回浮点平方根;输入必须 ≥0,负数会得到 NaN/无效值。

SQRT 返回浮点平方根:#Result := SQRT(#Value);。输入必须 ≥0;负数会得到 NaN/无效值。

参数

参数方向类型存储区说明
Expression输入REAL / LREALI, Q, M, D, L, P要求平方根的浮点数;必须 ≥ 0。
Return返回值REAL / LREAL—平方根;输入为负时返回无效浮点数(NaN)。

参数表以 TIA Portal V19 帮助为事实核对;S7-1200/1500 有差异时在类型列并列显示。存储区是 TIA 允许的范围,实际可用范围还受块接口和优化属性影响。

最小示例

下面是一个完整块,页面展示的源码就是 TiaLink 导入的同一份源码。页面的场景已在 PLC 云仿真里跑过,输出见“云仿真验证”。

FB_Sqrt_Demo FB

最小示例 · 17 行 · 源文件 blocks/FB_Sqrt_Demo.scl

查看 FB_Sqrt_Demo 的块接口
区块名称类型说明
输入ValueReal
输出ResultReal
blocks/FB_Sqrt_Demo.scl
1FUNCTION_BLOCK "FB_Sqrt_Demo"
2{ S7_Optimized_Access := 'TRUE' }
3VERSION : 0.1
4   VAR_INPUT
5      Value : Real := 9.0;       // 要求平方根的数,必须 >= 0
6   END_VAR
7 
8   VAR_OUTPUT
9      Result : Real;             // 平方根
10   END_VAR
11 
12BEGIN
13   REGION 求平方根
14      #Result := SQRT(#Value);
15   END_REGION
16END_FUNCTION_BLOCK
17 

块接口表由源码自动生成;# 前缀表示块内局部变量,实际工程里也可以是全局标签或 DB 变量。

SCL 写法

SCL
1#Result := SQRT(#Value);

整数先转浮点:

SCL
1#Root := SQRT(INT_TO_REAL(#Count));

怎么工作

输入 结果
9.0 3.0
2.25 1.5
0.0 0.0
负数 NaN(无效浮点)
  • 输入/返回都是浮点;REAL 约 7 位有效数字,高精度用 LREAL。
  • 负数开方不是 0,也不是报警,而是 NaN;下游比较/显示前要判断。
  • SQRT 和 SQR 互为逆运算;SQR 是平方。
  • 结果不会自动限幅;需要时用 LIMIT。

常用场景

1. 计算斜边/距离

已知直角边求斜边:SQRT(a*a + b*b);先确保 a*a+b*b 不溢出。

2. 均方根/标准差

统计计算里先求平方和,再除以数量,最后 SQRT;注意除零和负数。

3. 流量/压差换算

某些流量和压差是平方关系;开方前先 ABS 或判断非负。

常见坑

  • 负数输入:得到 NaN;先判断 Value >= 0 或对偏差取 ABS。
  • 整数输入:SQRT 要浮点;先 INT_TO_REAL,否则编译报错/隐式转换。
  • 溢出:a*a+b*b 可能超出 REAL 范围;先做量纲/范围检查。
  • 精度:REAL 只有约 7 位有效数字;大数/高精度用 LREAL。
  • 把 SQRT 当平方:平方用 SQR,开方用 SQRT。
  • 忽略 NaN 传播:NaN 参与后续计算会污染结果;在入口处拦截。

和 LAD 的区别

LAD 的 SQRT 盒只有一个输入和返回值;SCL 里直接写 SQRT(...),可以嵌在表达式里。语义一样,SCL 更容易把距离/统计公式写成一行。梯形图版本见 Learn-LAD 的 Sqrt 页。

云仿真验证

PLC 云仿真:PASS(3 次扫描)。场景:完全平方数、小数和零。结果来自 PLC 云仿真 的 scl_run_scenario;页面构建时执行同一份 SCL 源码和场景。

查看云仿真回归输出
云仿真回归输出
PASS  完全平方数、小数和零 (3 step(s), 3 scan(s))
RESULT: ALL PASS (3 scan(s))

云仿真验证语法、结构和逐扫描行为,不等同于 TIA 编译;TIA 状态见下方“验证状态”。

验证状态

项目结果日期证据
构建期语法/结构校验PASS2026-11-02parse + validate
PLC 云仿真PASS(3 scans)2026-11-02scl_run_scenario / scl_validate
TIA 导入编译待实测—TiaLink + TIA Portal(待实测)

“待实测”表示还没有在 TIA Portal 里导入编译,不代表代码有问题;上机前请先在测试项目编译。云仿真在 tia.hubwiz.com/sim 执行,不替代 TIA 编译。

来源与说明

参数、行为和数据类型的核对来源:TIA Portal V19 帮助的 Instructions/Instructions/Basic_instructions/SCL/Math_functions/SQRT__Form_square_root.md。中文讲解、SCL 示例、时序图和验证场景由 Learn-SCL 编写。

输入类型、负数边界和返回浮点的规则以 TIA Portal V19 帮助为事实核对;中文讲解、SCL 示例和验证场景由 Learn-SCL 编写。

Siemens 文档与截图的版权归 Siemens;本站只引用事实参数,不复制官方描述段落和图片。官方参考:Siemens TIA Portal。

常见问题

SQRT 支持整数吗?

SQRT 的输入是浮点;整数先 `INT_TO_REAL` 再开方,结果是 REAL。

负数开方会怎样?

返回无效浮点数(NaN);先判断输入 ≥0,或对偏差先取 `ABS`。

SQRT 和 SQR 有什么区别?

`SQR` 是平方(x²),`SQRT` 是平方根(√x);两者互为逆运算。

← 返回 SCL 指令手册