模型引用

将模型作为模块重用于其他模型

模型引用是对使用 Model 模块的另一个模型的引用。这些引用会创建模型层次结构。每个引用模型都有一个定义的接口，该接口指定其输入和输出的属性。定义的接口使得引用模型的行为独立于它在模型层次结构中的上下文。模型引用非常适合代码重用、单元测试、并行编译和大型组件。它们还可以减少文件争用和合并问题。

要确定引用模型是否满足您的建模需求，请参阅基于组件的建模规范。

要了解模型引用层次结构的代码生成，请参阅引用模型 (Simulink Coder)。

要创建受保护模型，请参阅模型保护 (Simulink Coder)。

要对模型引用层次结构执行 SIL/PIL 测试，请参阅SIL 和 PIL 仿真 (Embedded Coder)。

模块

Model	引用另一个模型来创建模型层次结构
Variant Model	Template subsystem containing Subsystem blocks as variant choices

函数

全部展开

引用模型

`depview`	分析和可视化模型引用依存关系，可包括或不包括库依存关系
`find_mdlrefs`	在模型层次结构中查找引用模型和 Model 模块
`pathsToReferencedModel`	Model hierarchy path composed of referenced models and Model blocks (自 R2023b 起)
`Simulink.BlockDiagram.refreshBlocks`	Update variants, linked blocks, and model references to reflect changes (自 R2023a 起)
`Simulink.BlockPath`	Fully specified Simulink block path
`Simulink.fileGenControl`	为图更新和模型编译生成的文件指定根文件夹
`Simulink.ModelReference.refresh`	Force update to Model block to reflect changes to referenced model (自 R2020a 起)
`Simulink.SubSystem.convertToModelReference`	将子系统转换为模型引用
`slbuild`	为模型编译独立可执行文件或模型引用目标
`slxcinfo`	Query contents of Simulink cache files (自 R2020b 起)
`slxcunpack`	Unpack simulation and code generation targets from Simulink cache file (自 R2020b 起)

受保护模型

`Simulink.ProtectedModel.createHarness`	Create harness model that provides isolated environment for testing protected model (自 R2020b 起)
`Simulink.ProtectedModel.getPublisher`	Return information about publisher that signed the protected model (自 R2020a 起)
`Simulink.ProtectedModel.verifySignature`	Verify digital signature on protected model (自 R2020a 起)
`Simulink.ProtectedModel.suppressSignatureVerification`	Suppress digital signature verification of protected models (自 R2020b 起)

模型设置

全部展开

模型引用

重新编译	有条件地、始终或从不重新编译模型引用目标的选项
从不重新编译诊断	Diagnostic action to take when model reference target must be rebuilt
启用并行模型引用编译	Option to build a model reference hierarchy in parallel whenever possible
MATLAB 工作进程的编译初始化	Options for how to initialize MATLAB workers for parallel builds
为引用模型启用严格调度检查	Option to check consistency of scheduling and sample time in referenced models
每个顶层模型允许的实例总数	在另一个模型中可以引用此模型的次数
传播可变大小信号的大小	Option to specify how variable-size signals propagate through referenced models
尽量减少出现代数环	尝试消除与引用模型相关的人为代数环的选项
将所有信号标签传播到模型之外	Option to pass propagated signal names out of referenced model
引用模型时使用局部求解器	Option to use local solver to solve referenced model as separate system of equations (自 R2022a 起)
模型依存关系	User-created files and data that potentially impact simulation results
对并行池执行一致性检查	Option to perform checks on parallel pool before starting parallel build (自 R2021a 起)
包含引用模型的自定义代码	Option to use custom code in model reference simulation target
为代码生成按值传递固定大小的标量根输入	Option to pass scalar input to model by reference or value

模型引用诊断

Model 模块版本不匹配	Diagnostic action to take when Model block does not represent current version of referenced model
端口和参数不匹配	Diagnostic action to take when port or parameter does not match between Model block and referenced model
不支持的数据记录	Diagnostic action to take when data logging is unsupported
模型参量没有显式最终值	Diagnostic action to take for model argument with default value at top-level model reference (自 R2020b 起)
最大标识符长度不足	Diagnostic action to take when maximum identifier length is too short to ensure unique global identifiers

工具

模型引用转换顾问	Convert subsystems to referenced models
引用的文件窗格	View, save, and close referenced subsystems and models (自 R2020b 起)

主题

确定何时引用模型

基于组件的建模规范
考虑大型模型和多用户开发团队的组件化。
模型引用基础知识
决定是否在一个模型中引用另一个模型。
模型引用的要求和限制
模型引用在可重用性、仿真模式、封装和调试等功能方面有一定的要求和限制。

创建模型引用

引用现有模型
在一个模型中包含另一个模型。
引用来自第三方的受保护模型
使用您从第三方收到的受保护模型。
将子系统转换为引用模型
准备一个要进行转换的子系统，将子系统转换为模型，并对转换前后的仿真结果进行比较。
定义模型引用接口
引用模型中的端口与模型引用中的端口相对应。跨越模型边界的信号必须满足特定要求。
Inspect Model Hierarchies
Examine the contents, structure, model versions, and logged signals in a model hierarchy.

配置模型引用

设置模型层次结构的配置参数
顶层模型和引用模型中的配置参数值可能不同。在模型引用中，一些配置参数值有特殊的要求或行为。
Conditionally Execute Referenced Models
Execute referenced models conditionally, similar to conditionally executed subsystems.
引用模型的采样时间
引用模型可从引用它的模型继承采样时间。
参数化可重用引用模型的实例
在将可重用组件建模为引用模型时，要将组件的每个实例配置为使用不同模块参数值，请创建模型参量。
Parameterize a Referenced Model Programmatically
This example shows how to programmatically configure multiple instances of a referenced model to use different values for the same block parameter.
Group Multiple Model Arguments into a Single Structure
This example shows how to programmatically configure multiple instances of a referenced model to use different values for the same block parameter by using structures.
Configure Instance-Specific Data for Lookup Tables Programmatically
When you use Simulink.LookupTable objects to store and configure lookup table data for ASAP2 or AUTOSAR code generation (for example, STD_AXIS or CURVE), you can configure the objects as model arguments.

仿真模型层次结构

为模型层次结构选择仿真模式
为模型层次结构中的模型选择仿真模式。
管理引用模型的仿真目标
仿真目标（或称为 SIM 目标）是一个 MEX 文件，它实现在加速模式下执行的引用模型。
共享 Simulink 缓存文件以加快仿真速度
使用 Simulink 缓存文件来共享编译工件以免除首次编译成本。
Override Model Reference Simulation Modes
When a top model simulates in normal mode, you can override the simulation mode used for model references without dirtying their parent models.
Reduce Update Time for Referenced Models by Using Parallel Builds
Reduce diagram update time for large model reference hierarchies by using parallel builds.
Simulate Conditionally Executed Referenced Models
Run a standalone simulation of a conditionally executed referenced model.
Simulate Multiple Referenced Model Instances in Normal Mode
Simulate a model that contains multiple instances of a referenced model.

精选示例

Component-Based Modeling with Model Reference

Walks you through simulation and code generation of a model that references another model multiple times.

打开实时脚本

Visualize Model Reference Hierarchies

View, explore, and analyze model dependencies using the Dependency Analyzer.

打开示例

Convert Subsystem to Referenced Model

Convert a subsystem to a referenced model by using the Model Reference Conversion Advisor or the Simulink.SubSystem.convertToModelReference function.