跳到主要内容

案例

本文档共两个案例,分别为从零开始建立一个 SimStudio 元件模块项目(以交流滤波器模块为例)、 将一个现有的 SimStudio 模型封装为模块(以光伏为例),并在光伏封装模块的基础上介绍模块的单元测试方法。

从零开始建立一个 SimStudio 元件/模块项目

这里从零开始构建一个简单的交流滤波器模块,实现功能:

  • 可接在三相电气节点上,实现 RLC 滤波的功能。
  • 可自定义 RLC 的参数大小。
  • 可通过虚拟引脚量测滤波器的三相交流电流、三相交流电压。
  • 通过控制输出引脚量测滤波器的有功、无功功率。

接口标签页配置

首先,新建一个空白电力系统元件(model/CloudPSS/Blank_Component)

进入接口标签页,按 参数列表相关文档所述的方法,新建名为 RLC设置 的参数组,分别按下表建立三个参数:

配置项电阻电感电容
RLC
名称电阻电感电容
详细描述填写滤波器电阻。填写滤波器电感。填写滤波器电容。
条件truetruetrue
类型实数实数实数
输入类型常量常量常量
默认值5005e-33
最小值000
最大值10001100
区间(左开区间](左开区间](左开区间]
单位ΩHμF

新建名为量测的参数组,分别按下表建立 2 个虚拟引脚参数:

配置项三相交流电压量测三相交流电流量测
VmeasureImeasure
名称三相交流电压量测三相交流电流量测
详细描述填写三相交流电压量测虚拟引脚,以 # 开头。填写三相交流电流量测虚拟引脚,以 # 开头。
条件truetrue
类型虚拟引脚虚拟引脚
输入类型常量常量
默认值
数据X维数33
数据Y维数11
数据类型实数实数
连接类型输出输出

引脚列表相关文档所属的方法,建立键名为elePQ的引脚,引脚配置如下

配置项三相电气端口有功量测无功量测
elePQ
名称三相电气端口有功量测无功量测
详细描述交流滤波器的三相电气端口交流滤波器的有功量测交流滤波器的无功量测
可见truetruetrue
条件truetruetrue
数据X维数311
数据Y维数111
数据类型实数实数实数
连接类型电气输出输出

定义好的参数和引脚列表如下图所示:

参数和引脚列表
参数和引脚列表

图标绘制工作区中,拖入一个矩形,设置大小和位置为:X=0, Y=0, 宽度=40, 高度=60

拖入一个路径组件,该路径用来绘制引脚的标识。参考路径配置文档,设置位置为:X=0, Y=0,设置路径的配置项如下:

M 20 0
v -20
M 40 20
h 20
m -20 20
h 20

此外,再拖入一个路径组件,该路径组件用来绘制滤波器的图标。设置位置为:X=0, Y=0,设置线条宽度为 1px,设置路径的配置项如下:

M 20 25
a 15 15 180 1 1 0 30
a 15 15 180 1 1 0 -30
m 0 2 v 3
m -5 0 h 10
m -10 2 h 10
m -5 0 v 3 h -6 v 2
a 1.5 1.5 180 1 0 0 3
v 0.1
a 1.5 1.5 180 1 0 0 3
v 0.1
a 1.5 1.5 180 1 0 0 3
v 2 h 6 v 2
m 0 -15.2 h 6 v 2
l 0.8 0.8 l -1.6 1.6 l 1.6 1.6 l -1.6 1.6 l 1.6 1.6 l -0.8 0.8
v 3.2 h -6

此时图标绘制区如下图所示:

绘图区示意1
绘图区示意1

拖入一个文本组件,用来放在图中作为滤波器标识。设置位置为:X=0, Y=5,设置文本为 Filter。

拖入第二个和第三个文本组件,用来作为有功量测 P 和无功功率 Q 引脚的标识。这两个文本组件的参数设置如下表:

设置位置为:X=20, Y=10,设置文本为 P,设置其它参数如下表。

配置项PQ
X2020
Y1030
文本PQ
字体大小88
文本对齐左对齐左对齐
横向基础偏移0.5em0.5em
纵向基础偏移-0.6em-0.6em

然后,再拖入三个引脚组件,参考绑定引脚相关文档所述方法,将三个引脚绑定到引脚列表中的三个引脚,并放置在对应的位置上。

最终,绘图区中,元件图标的示意图如下:

绘图区元件图标
绘图区元件图标

采用图标检查所述方法,打开图形预览,可以看到该图形满足绘图规范:

图标检查
图标检查

实现标签页配置

实现标签页中,分别拖入一个电感、电阻、电容元件以及一个接地点元件,配置参数如下:

参数电感参数电阻参数电容
DimensionThree PhaseDimensionThree PhaseDimensionThree Phase
Inductance$LResistance$RCapacitance$C
Branch CurrentBranch CurrentBranch Current#Ic

注意,配置 RLC 参数时,请参考“表达式”模式相关文档所述内容,将参数列表中的 R、L、C 参数输入到这三个元件中。

再按在模型实现中添加引脚并绑定文档所述内容,添加 3 个模块端口元件到图纸中,分别绑定 elePQ 三个引脚。

虚拟引脚调用相关说明,将 2 个虚拟引脚端口添加到图纸中,分别绑定 Vmeasure, Imeasure 引脚。

参考量测相关文档,在模型库的量测标签下,找到并添加电压表(model/CloudPSS/_NewVoltageMeter)元件,设定量测电压信号名为 #V,Dimension参数为 Three Phase;同样在模型库的量测标签下,找到并添加三相功率量测(model/CloudPSS/_newPowerMeter_3p)元件,设定 Three Phase Voltage 引脚赋值为 #V, Three Phase Current 引脚赋值为 #Ic

最后,按下图所示配置各个元件的连接关系:

案例 1 元件连接关系
案例 1 元件连接关系

总览标签页配置以及保存

总览标签页中配置好模块的名称为“三相交流滤波器封装演示”,并设置元件标签模块封装演示。这里的名称和元件标签均可以自行修改,其作用参考 元件标签相关文档。此外,还可以按需求编写描述以及元件文档。

进一步,点击工具栏中的 保存另存为按钮,在弹出的保存选项配置窗口中配置元件资源 ID,这里填入与其它元件不同的唯一标识符,例如样例中填入 myRLCFilter

总览标签页的设置如下:

总览标签页
总览标签页

点击保存按钮,即可保存该模块。此后,就可以在其它项目中,从模型库中调用这个封装好的模块,如下图所示。

模块调用
模块调用

示例模型下载连接

案例1:三相交流滤波器封装演示

案例2:光伏模型封装演示