参数及引脚体系
SimStudio 提供了一套以参数、变量及引脚为核心的参数化建模系统。用户可通过配置参数、变量及引脚对元件和模型进行灵活维护和管理,实现各类复杂建模功能。
参数
参数是定义及描述元件和模型特征的度量数据,如电阻的阻值,电源的幅值、初始相位等。参数分为实数、整数、文本、布尔、选择、多选、表格、虚拟输入引脚、虚拟输出引脚 9 种类型。一个 SimStudio 模型中的参数又分为 内部参数 和 全局参数 两类。
内部参数
打开一个 SimStudio 模型,选中实现标签页 - 图纸上的任意元件,即可在右侧参数卡中查看并配置该模型中被选中元件的参数。实现标签页下的参数均为当前模型的内部参数。
![内部参数](/assets/images/10-internal-parameter-3d8a7306376871e77521322ab1ad8a23.png)
全局参数
打开一个 SimStudio 普 通模型或元件,在运行标签页 - 参数方案配置卡处显示的参数即当前模型的全局参数。内部参数可引用全局参数进行赋值或计算,从而实现对模型内部参数的快速批量调整。全局参数列表可在当前模型的接口标签页进行定义,定义方法参见 定义元件/模块参数列表 帮助页。
![全局参数定义](/assets/images/20-global-parameter-definition-374cd9ce4252bd06ea33a6201c8270d6.png)
全局参数列表可在当前模型的运行标签页进行配置,配置方法参见 参数方案配置 帮助页。
![全局参数统一配置](/assets/images/30-unified-configuration-of-global-parameters-5288c05f9143bea5f981ae9b367d7802.png)
全局参数只能在当前 SimStudio 模型项目内部使用。
变量
变量,即全局变量,打开一个 SimStudio 普通模型或元件,可在当前模型的实现标签页 - 图纸 - 全局变量卡中进行定义,作用于 SimStudio 模型内部,可用于临时计算或赋值。变量可以引用全局参数或同一模型下的其他变量进行赋值或计算,内部参数也可引用全局变量进行赋值或计算。
![变量](/assets/images/40-variables-666dd898ebdc70a97f07a768c84f024d.png)
变量只能在当前 SimStudio 模型项目内部使用。
引脚
引脚是 SimStudio 元件之间的连接接口,分为电气引脚、控制引脚、热力引脚三类。不同类型的引脚不能相连。控制引脚为有向引脚,根据数据流方向又分为输入引脚和输出引脚两类。元件引脚的定义方法参见 定义元件/模块引脚列表 帮助页。
![引脚](/assets/images/50-pins-f4916d1a55e1771bbdff3344e05ee5e2.png)
需要特殊说明的是,虚拟输入引脚和虚拟输出引脚类型的参数本质上也是控制引脚。控制输入、输出引脚和电气引脚通常绑定显示在元件图形和引脚列表中,而虚拟引脚只会显示在元件的参数列表中。虚拟引脚的合理使用可以使元件图标和拓扑图更加简洁。虚拟引脚与引脚的使用方法完全一致。
输入模式
参数、变量及引脚的赋值支持 “值” 和 “表达式” 两种输入模式。通过点击赋值输入框右侧的 或 可随时切换输入模式。
“值”模式
点击待编辑参数、变量或引脚的赋值输入框右侧,显示 时,当前为 “值”模式 输入框。“值”模式下,输入框内只能输入与当前参数类型相同的常量。系统默认选择“值”模式输入。参数、变量及引脚的“值”模式输入方式如下:
- 内部参数
- 全局参数
- 变量
- 引脚
例如变压器元件的额定容量参数,可在“值”模式下输入实数类型的常量。
![内部参数的“值”模式输入](/assets/images/60-value-mode-input-for-internal-parameters-682505564597feaafdcafaecff05619f.png)
- 定义全局参数的默认值时可在“值”模式下输入常量。
![全局参数定义时的“值”模式输入](/assets/images/70-value-mode-input-for-global-parameters-define-673a406980ef805e7eae60ea0340c5a0.png)
- 配置全局参数方案时可在“值”模式下输入常量。
![全局参数配置时的“值”模式输入](/assets/images/80-value-mode-input-for-global-parameters-config-3873e92eaf1de4a8e5c3df8b0ce2f1ef.png)
配置变量值时可在“值”模式下输入实数类型的常量。
![变量的“值”模式输入](/assets/images/90-value-mode-input-for-variables-875012c0bb63107d874479153f80b8f1.png)
配置引脚参数时可在“值”模式下输入文本类型的引脚号。
![变量的“值”模式输入](/assets/images/100-value-mode-input-for-pins-1e5ac643a8d52b4f72c1b2eaeb73faef.png)
“表达式”模式
点击待编辑参数、变量或引脚的赋值输入框右侧,显示 时,当前为 “表达式”模式 输入框。“表达式”模式下,输入框内可填入常量、全局参数、变量或包含这些元素的计算表达式,支持 Math.js 表达式语法。“表达式”模式下输入栏的边框会变成黄色。
全局参数和变量的引用格式为 $
+ 参数或变量的键(key
),例如$R
、$Vm
、$var
等。
在“表达式”模式下,输入框会实时自动检查当前输入的表达式状态:
- 若表达式输入有误,会在当前选中输入框的最右侧显示错误提示符,鼠标悬浮至错误提示符时会显示报错信息;
- 若表达式输入正确,会在当前选中输入框的最右侧显示表达式的计算值。
从“表达式”模式切换回“值”模式时,当前输入的表达式会丢失,并将当前表达式的计算值直接回 填至“值”模式下的输入框。
在“表达式”输入模式下,选中输入框,按下 Ctrl 键可呼出 扩展编辑框。在扩展编辑框中,可方便编辑复杂、多行表达式。
![扩展编辑界面](/assets/images/10-48f543abbf2f373843609894a8eca4b2.png)
参数、变量及引脚的“表达式”模式输入方式如下:
- 内部参数
- 全局参数
- 变量
- 引脚
- 输入常量
![内部参数在“表达式”模式下填入常量](/assets/images/110-internal-parameters-filling-with-constants-in-expression-mode-257da89a19dfb914cd539f200848ae5a.png)
- 引用全局参数
![内部参数在“表达式”模式下引用全局参数](/assets/images/120-internal-parameters-filling-with-global-parameter-in-expression-mode-dfcb2d2c7780fc04ade45fe2f7fd6e15.png)