一、引言
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模型可以实现频率和相位信号输出，逻辑模型可以实现整型信号输入，扩充了基础模型的应用范围。
-
新增TransferFunctionDia框图模型，优化了标准库中传递函数TransferFunction模型显示，可以在图形视图下直接查看传递函数。
-
新增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的模型库，升级后模型即可正常使用。
其中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）咨询
