MWORKS.Sysplorer 2024b重磅推出同元基础库

一、引言

MWORKS.Sysplorer 是多领域建模与仿真平台，集成了Modelica标准库。该库由Modelica协会开发，是一款开源的通用基础模型库，支持机电、流体、控制等多个专业领域的建模与仿真。随着Modelica标准库的不断发展与更新，目前最新版本已升级至 Modelica 4.0.0。Modelica 4.0.0包括框图、时钟、状态机、电气、磁、机械、流体、介质、热、数学、工具、常数、图标和单位等模型。该版本提供了丰富的预定义模型组件和标准接口，广泛覆盖机械、电气、热力学、流体力学及控制系统等多个工程领域。

Modelica 4.0.0在模型功能上相较于Modelica 3.2.3进行了显著升级，部分模型路径做了较大改动，导致新旧版本之间的不兼容。为解决上述问题，同元软控推出了同元基础库以解决标准库在版本间的兼容性问题。为了满足用户对更多通用基础模型和函数的需求，如Block框图模型、Media介质函数等，我们将持续整合更多、更丰富的模型资源到同元基础库中，使得用户能够更方便地访问和使用。

二、同元基础库Modelica4.0.0.TY.1

Modelica4.0.0.TY.1是同元基础库的第一版发行，它保留了Modelica4.0.0标准库所有模型，并在此基础上新增了部分Modelica3.2.3内容以及工程实践中积累的通用化模型；不仅能够使用户正常使用原有标准库模型，还为用户提供了更丰富的基础模型。

2.1 发布说明（新功能/更新内容）

Modelica4.0.0.TY.1在Modelica4.0.0的基础上新增6个Blocks框图模型和2个Utilities工具模型。

• 新增FFT框图模型和逻辑框图模型， FFT模型可以实现频率和相位信号输出，逻辑模型可以实现整型信号输入，扩充了基础模型的应用范围。

FFT框图模型和逻辑框图模型展示

• 新增TransferFunctionDia框图模型，优化了标准库中传递函数TransferFunction模型显示，可以在图形视图下直接查看传递函数。

传递函数框图模型展示

• 新增DataStoreMemory工具模型，结合软件界面进行了交互改进，这种模型软件一体化的改进，让变量跨层级调用更便捷。

DataStoreMemory模型展示

2.2 加载说明

Modelica4.0.0.TY.1目前内置在MWORKS.Sysplorer 2024b，在安装MWORKS.Sysplorer 2024b之后，打开该软件后自动加载Modelica4.0.0.TY.1。用户在打开依赖Modelica4.0.0、Modelica3.2.3或更早版本的标准库后，软件会自动弹出“模型库转换”的对话框，提示将此模型库直接升级为依赖同元基础库Modelica4.0.0.TY.1的模型库，升级后模型即可正常使用。

以用户模型SteamPowerSys为例

其中Modelica4.0.0.TY.1适配情况如下：

软件版本	是否支持Modelica4.0.0.TY.1加载使用	是否支持Modelica4.0.0.TY.1“模型库转换”
MWORKS.Sysplorer 2024b	支持	支持
MWORKS.Sysplorer 2024a	支持	不支持
MWORKS.Sysplorer 2023b	支持	不支持
更早版本…	支持	不支持

三、常见问题与解答（Q&A）

3.1 用户模型未升级运行出现报错

1.问题描述

在同元基础库Modelica4.0.0.TY.1已加载，用户模型库依赖标准库Modelica3.2.3，但没有升级该模型库的依赖关系的情况下，VolumetricPump模型中插值表combiTable查找不到，以及变型项freqHz查找不到。

2.问题原因

同元基础库Modelica4.0.0.TY.1是在标准库Modelica4.0.0基础上建立的，所以 Modelica4.0.0.TY.1与Modelica3.2.3存在较大版本差异，如下图所示，数据表格（Tables）做了以下修改：

3.解决办法

1）用户根据报错信息定位模型问题直接对模型修改；

2）通过软件提供的“模型库转换”功能进行该模型库的升级，操作步骤如下：

a. 在MWORKS.Sysplorer 2024b中加载该模型库；

b. 在软件自动弹出的“模型库转换”对话框中，点击“升级模型”即可实现自动化升级；

c. 自动升级完成之后，原模型库（依赖Modelica3.2.3）的备份文件将保留在原路径之下。

用户模型未升级运行出现报错问题处理示例

3.2 加载模型库未跳转出升级弹窗

1.问题描述

用户模型库加载后，未跳转出“模型库转换”弹窗，无法实现模型库自动化升级。

2.问题原因

同元基础库、标准库在版本间均存在差异，每个版本的映射表都是一一对应的，因此模型库升级功能需要识别模型库顶层annotation里绑定的标准库依赖版本，如果用户模型未进行绑定，升级功能无法识别，将不会跳转出“模型库转换”弹窗。

3.解决办法

在用户模型库顶层annotation里添加绑定的标准库依赖版本，以SteamPowerSys模型库，原模型依赖标准库Modelica 3.2.3，想实现自动跳转出“模型库切换”弹窗，需在模型库顶层加入代码：uses(Modelica(version = "3.2.3")) ；

3.3 其他常见问题

同元基础库其他常见问题，欢迎大家打开MWORKS.Sysplorer使用手册-常见问题，可查看该模型库常见问题与解决办法，具体打开方式如下：

四、 后续开发及发布计划

Modelica4.0.0.TY.1 build 1 超前预览

部分新增案例：

部分新增模型：

五、 下载与反馈

欢迎大家前往同元软控官网下载MWORKS 2024b软件进行试用，可以提交工单以反馈产品建议。

1.MWORKS官方软件下载地址：

www.tongyuan.cc/download

2.MWORKS官方许可申请地址：

www.tongyuan.cc/license

如遇技术问题，可扫码进入官方交流群（QQ群：955080321）咨询