Engee 文档
Notebook

导入 FMU 协同模拟组件

展示如何使用FMU Import 块将外部 FMU 格式的模型添加到 Engee 画布。

模型描述

FMU（功能模拟单元）组件中的协同模拟模式旨在将不同建模工具中开发的多个模型组合成一个时间同步系统。

该模式可将在不同环境（MATLAB/Simulink、Dymola、OpenModelica 等）中创建的模型结合起来，而无需重写代码。

每个 FMU 都是一个 "黑盒子"，有自己的求解器。

在本例中，我们的 "外部 "模型在fmuVanDerPol.fmu 文件中，我们将把它放入 FMU 导入块，设置完成后，我们将从它所包含的模型中获取图形。

image.png

我们建议研究 FMU 文件。为此，让我们安装一些库并调用info(fmu) 命令。

In [ ]: 
Pkg.add( ["FMI"] )
using FMI
fmu = loadFMU( "fmuVanDerPol.fmu" )
info(fmu)

#################### Begin information for FMU ####################
	Model name:			myvdp
	FMI-Version:			2.0
	GUID:				{a50ebd80-9a0f-b492-4bf4-893f9611b1a5}
	Generation tool:		[Unknown generation tool]
	Generation time:		2018-09-26T19:47:29Z
	Var. naming conv.:		structured
	Event indicators:		0
	Inputs:				0
	Outputs:			2
		0 ["Out1"]
		1 ["Out2"]
	States:				0
	Parameters:			1
		2 ["mu"]
	Supports Co-Simulation:		true
		Model identifier:	myvdp
		Get/Set State:		true
		Serialize State:	true
		Dir. Derivatives:	false
		Var. com. steps:	false
		Input interpol.:	false
		Max order out. der.:	nothing
	Supports Model-Exchange:	false
##################### End information for FMU #####################

设置程序块

在这些信息中，我们需要找到输入端口名称、输出端口名称和参数名称，以便正确创建程序块接口和配置程序块。

这个模型没有输入端口，有两个输出端口（Out1 和Out2 ），还有一个参数mu 。此外，我们也没有看到该模型的求解器正在等待的时间步长设置。

我们根据经验发现，该 FMU 模型的计算步长不应小于0.1 с 。整个模拟的全局步长可以是任何步长。

image.png

让我们在运行时运行模型并绘制图表：

In [ ]: 
model_name = "fmu_co_simulation";
model_name in [m.name for m in engee.get_all_models()] ? engee.open(model_name) : engee.load( "$(@__DIR__)/$(model_name).engee");
res = engee.run( model_name );

plot( res["x"].time, [res["x"].value res["dx"].value], label=["x" "dx"],
      lw=3, size=(600,300) )
Out[0]:

何时选择协同仿真而不是模型交换？

模型交换（ME）要求整个系统使用单一求解器，如果所有模型都能使用单一求解器，则适合使用该方法。

在下列情况下，可选择协同仿真（CS）：

  • 模型使用不同的求解器、
  • 有遗留代码或专有模拟器、
  • 需要分布式执行（如 HIL 测试）。

结论

协同仿真 FMU 是整合异构模型的强大工具，无需完全重写模型，但需要权衡受控同步和潜在的采样误差。

示例中使用的块