Python的DSIM应用程序编程接口（API）
DSIM提供了可供Python代码调用的API接口函数，包括电路图修改，仿真控制和数据后处理等各个环节。支持在 Python 环境中通过代码直接修改电路参数、批量并行仿真并获取数据，对接众多主流 AI 框架，真正成为强化学习等人工智能算法的理想仿真工具。
DSIM API（Python）支持以下接口：
以下将演示如何使用DSIM API (Python)扫描三相PWM整流电路的LCL滤波器参数。本例展示了对某一工况下LCL滤波器进行参数扫描，其中逆变器侧电感、滤波电容、网侧电感各扫描6组，共216 次仿真（参数设置如下图所示）。
此案例使用的电路图拓扑如下图所示，此案例通过计算A相并网电流的THD值评价LCL参数性能，通过获取A相电流THD波形的后1000个点的平均值作为评价标准，取最小THD作为最佳参数组合。
如何使用DSIM API（Python）进行LCL参数扫描
使用DSIM API（Python）进行LCL参数扫描的结果分析
获取更多信息，请参考文档《教程-DSIM API接口定义（Python）》。（本页末尾附教程文档以供下载）
| 句柄创建与释放 | 通过电路图创建句柄；设置仿真电路图；释放句柄 |
| 电路图操作 | 获取元件参数值；设置元件参数值；获取参数文件内容；设置参数文件内容；获取子电路变量值；修改子电路变量值；获取仿真控制参数；修改仿真控制参数；保存电路图 |
| 仿真过程 | 获取仿真曲线；初始化仿真；设置输出曲线；开始仿真；暂停仿真；继续仿真；结束仿真；获取仿真状态 |
| 数据操作 | 获取曲线名；获取指定曲线数据；获取全部数据；删除指定曲线数据；删除全部数据；删除波形文件 |
|
回调函数
|
仿真数据生成回调；仿真进度信息回调；仿真过程信息回调；仿真完成回调 |
| 其他 | 查看电路原理图；查看波形；获取波形文件数据 |
使用个人计算机执行Python脚本，执行结果输出最佳THD的LCL参数，同时输出对应参数组合的波形如下图所示。
代码中集中设置了初始化配置参数，允许输出对每一参数组合执行修改参数，初始化回调函数（仿真完成后获取数据并处理），保存电路并开始仿真。每一组参数的电路仿真开始后无需等待，直接处理下一组参数，每一电路的仿真分别在线程中并行计算，充分利用计算资源。每一电路仿真完成后通过仿真结束回调处理数据并关闭句柄，保证及时释放计算机资源。
*文档《教程-DSIM API接口定义（Python）》：
-
2025-12-26 教程-DSIM API 接口定义 (Python).pdf
끂108 341.79 KB
