参数、变量及引脚

SimStudio 提供了一套以参数、变量及引脚为核心的参数化建模系统。用户可通过配置参数、变量及引脚对元件和模型进行灵活维护和管理，实现各类复杂建模功能。

参数

参数是定义及描述元件和模型特征的度量数据，如电阻的阻值，电源的幅值、初始相位等。参数分为实数、整数、文本、布尔、选择、多选、表格、虚拟输入引脚、虚拟输出引脚 9 种类型。一个 SimStudio 模型中的参数又分为 内部参数 和 全局参数 两类。

内部参数

打开一个 SimStudio 模型，选中实现标签页 - 图纸上的任意元件，即可在右侧参数卡中查看并配置该模型中被选中元件的参数。实现标签页下的参数均为当前模型的内部参数。

全局参数

打开一个 SimStudio 普通模型或元件，在运行标签页 - 参数方案配置卡处显示的参数即当前模型的全局参数。内部参数可引用全局参数进行赋值或计算，从而实现对模型内部参数的快速批量调整。全局参数列表可在当前模型的接口标签页进行定义，定义方法参见定义元件/模块参数列表帮助页。

全局参数列表可在当前模型的运行标签页进行配置，配置方法参见参数方案配置帮助页。

全局参数只能在当前 SimStudio 模型项目内部使用。

变量

变量，即全局变量，打开一个 SimStudio 普通模型或元件，可在当前模型的实现标签页 - 图纸 - 全局变量卡中进行定义，作用于 SimStudio 模型内部，可用于临时计算或赋值。变量可以引用全局参数或同一模型下的其他变量进行赋值或计算，内部参数也可引用全局变量进行赋值或计算。

变量只能在当前 SimStudio 模型项目内部使用。

引脚

引脚是 SimStudio 元件之间的连接接口，分为电气引脚、控制引脚、热力引脚三类。不同类型的引脚不能相连。控制引脚为有向引脚，根据数据流方向又分为输入引脚和输出引脚两类。元件引脚的定义方法参见定义元件/模块引脚列表帮助页。

“虚拟引脚”类型参数与“引脚”的区别

需要特殊说明的是，虚拟输入引脚和虚拟输出引脚类型的参数本质上也是控制引脚。控制输入、输出引脚和电气引脚通常绑定显示在元件图形和引脚列表中，而虚拟引脚只会显示在元件的参数列表中。虚拟引脚的合理使用可以使元件图标和拓扑图更加简洁。虚拟引脚与引脚的使用方法完全一致。

输入模式

参数、变量及引脚的赋值支持 $(x)$ “值” 和 $f_x$ “表达式” 两种输入模式。通过点击赋值输入框右侧的 $(x)$ 或 $f_x$ 可随时切换输入模式。

“值”模式

点击待编辑参数、变量或引脚的赋值输入框右侧，显示 $(x)$ 时，当前为 “值”模式 输入框。“值”模式下，输入框内只能输入与当前参数类型相同的常量。系统默认选择“值”模式输入。参数、变量及引脚的“值”模式输入方式如下：

内部参数
全局参数
变量
引脚

例如变压器元件的额定容量参数，可在“值”模式下输入实数类型的常量。

“表达式”模式

点击待编辑参数、变量或引脚的赋值输入框右侧，显示 $f_x$ 时，当前为 “表达式”模式 输入框。“表达式”模式下，输入框内可填入常量、全局参数、变量或包含这些元素的计算表达式，支持 Math.js 表达式语法。“表达式”模式下输入栏的边框会变成黄色。

全局参数和变量的引用格式为 $ + 参数或变量的键(key)，例如$R、$Vm、$var等。

在“表达式”模式下，输入框会实时自动检查当前输入的表达式状态：

若表达式输入有误，会在当前选中输入框的最右侧显示错误提示符，鼠标悬浮至错误提示符时会显示报错信息；
若表达式输入正确，会在当前选中输入框的最右侧显示表达式的计算值。

从“表达式”模式切换回“值”模式时，当前输入的表达式会丢失，并将当前表达式的计算值直接回填至“值”模式下的输入框。

在“表达式”输入模式下，选中输入框，按下 Ctrl 键可呼出 扩展编辑框。在扩展编辑框中，可方便编辑复杂、多行表达式。

参数、变量及引脚的“表达式”模式输入方式如下：

内部参数
全局参数
变量
引脚

输入常量

引用全局参数

引用变量

输入含全局参数及变量的计算表达式

参数、变量及引脚配置

参数配置

用户可通过 SimStudio 实现标签页中的参数卡面板对当前模型的内部元件参数进行配置。详细使用方法参见参数卡帮助页。

若需批量配置当前模型下的元件参数，可使用元件表功能。

变量配置

用户可通过 SimStudio 实现标签页中的全局变量卡面板对当前模型的全局变量进行配置。

在 SimStudio 实现标签页，点击图纸空白区域（即取消选中图纸上的元素），在右侧属性栏点击全局变量标签，切换至全局变量卡。全局变量采用键-值对列表进行管理。

新建：点击全局变量键-值对列表末尾的 (x)新建全局变量，会默认在列表最下方新建一个全局变量。
编辑：在全局变量键-值对列表中，可任意修改每个变量的键 key 和值 value。变量配置要求如下：
- 变量键 key 是识别变量和全局参数的唯一标识符，以字母或下划线 _ 符号开头，不应与当前模型项目中已存在的变量和全局参数键key相同。
- 变量赋值支持值/表达式模式输入，可以引用当前模型项目的全局参数和其他变量进行赋值或计算。引用格式为 $ + 参数或变量的键(key)，例如$R、$Vm、$var等。
排序：拖动列表中的每条变量最右侧的操作柄，可调整列表中的变量顺序。
剪切、复制、创建副本与粘贴：右键点击每条变量最右侧的操作柄，可在弹出菜单中执行剪切、复制、创建副本操作。执行剪切或复制后，在列表空白处右键，可执行粘贴操作。
删除：右键点击每条变量最右侧的操作柄，可在弹出菜单中执行删除，可删除当前变量。

同平台项目间跨网页剪切/复制/粘贴

SimStudio 全局参数、全局变量支持同平台项目间跨网页剪切/复制/粘贴。跨网页剪切/复制/粘贴可以将所选元素在多个 SimStudio 项目之间移动，实现重复性参数、变量配置的快速复用。

全局变量一般有两类应用场景。

多个元件共用一个参数时，可将该参数定义为全局变量，通过全局变量为元件参数赋值，方便调试模型时快捷、高效地修改参数。
当全局参数与内部参数不匹配时，需要对全局参数进行复杂公式换算时，可设置全局变量暂存计算结果。例如标幺值与实际值转换、变压器分接头挡位计算等。

引脚配置

在 SimStudio 中，元件具备一种可互相连接的接口（端子），称为引脚。通过引脚连接，可定义不同类型的模型拓扑。

引脚之间存在连接线连接、引脚标签连接和混合连接三种方式。

连接线连接：在图纸上，鼠标悬浮在元件上时，当前元件可连接的引脚会突出显示。点击某一个引脚，按住鼠标左键，移动到另一个需要连接的引脚上松开左键，即可完成两个引脚的连接；
引脚标签连接：在元件的参数卡-引脚列表中，可通过赋值输入框配置引脚标签。为需要连接的两个引脚配置相同的引脚标签，即可完成两个引脚的连接。
混合连接：上述两种连接方式可同时使用，常用于多个元件引脚之间的连接。

引脚赋值也支持“表达式”输入模式。使用表达式赋值元件引脚，可通过全局参数、变量控制拓扑的变化。例如：

虚拟引脚与引脚一致，但由于不显示在元件图标中，只能采用引脚标签连接的方式进行配置。

虚拟输入引脚

虚拟输入引脚本质可以理解为元件的一个动态参数。该参数可通过引脚标签赋值，赋予元件内部的某个量一个持续变化的数值。虚拟输入引脚在电机元件和动态限幅元件参数中比较常见。例如：

电机元件启动过程中用到的电压源-电机切换信号S2M和转子方程解锁信号L2N，通过虚拟输入引脚的方式可以在仿真过程中改变电机模型的状态或控制方式;
限幅器的动态限幅上下限参数，可通过虚拟输入引脚的方式可以在仿真过程中动态改变幅值。

虚拟输出引脚

虚拟输出引脚主要用于输出元件内部的量测信息，主要用于量测类元件（如电压表、电流表）和元件的 Monitoring 参数组。通过为虚拟输出引脚赋值引脚标签，可将元件的电压、电流等内部量测值输出，方便引出观测或参与控制。

信息

SimStudio v4.3 之前的版本，虚拟输入引脚的信号标签必须是以@符开头的字符串，例如@S2M、@L2N、@upperBound、@lowerBound等。虚拟输出引脚的信号标签必须是以#标签开头的字符串，如#I_R、#Ps等。v4.3及之后的版本移除了上述限制，虚拟引脚与一般引脚的用法一致。

用户使用前，请先点击 SimStudio 左侧标签栏最下方的设置按钮，点击关于选项查看当前的版本号，并参考对应版本的命名标准。

引脚连接一般规范

相连两个引脚的维数必须一致。
控制输入引脚必须与至少一个控制输出引脚相连。多个控制输入引脚之间可以互联；
控制输出引脚可以悬空，多个控制输出引脚之间不可互联；
电气引脚可连接到控制输入引脚，此时传入控制系统的数值是电气引脚处的节点电压，单位为 V。但这类连接方法很容易导致单位错误，因此 CloudPSS 不推荐使用这种连接方法，规范的电气量量测方法，详见电磁暂态仿真的量测与输出系统。

参数​

内部参数​

全局参数​

变量​

引脚​

输入模式​

“值”模式​

“表达式”模式​

参数、变量及引脚配置​

参数配置​

变量配置​

引脚配置​

虚拟输入引脚​

虚拟输出引脚​

常见问题​

参数