Modellreferenzen

R2026b

Wiederverwendung von Modellen als Blöcke in anderen Modellen

Eine Modellreferenz ist eine Referenz auf ein anderes Modell mithilfe eines Model-Blocks. Diese Referenzen schaffen eine Modellhierarchie. Jedes referenzierte Modell hat eine definierte Schnittstelle, die die Eigenschaften seiner Eingaben und Ausgaben festlegt. Die definierte Schnittstelle macht das Verhalten des referenzierten Modells unabhängig von seinem Kontext in der Modellhierarchie. Modellreferenzen sind ideal für die Wiederverwendung von Code, Unit-Tests, parallele Builds und große Komponenten. Sie können auch Dateikonflikte reduzieren und Probleme zusammenführen.

Um festzustellen, ob referenzierte Modelle Ihre Modellierungs-Anforderungen erfüllen, siehe Component-Based Modeling in Simulink.

Informationen über die Codegenerierung für Modellreferenzhierarchien finden Sie unter Referenced Models (Simulink Coder).

Näheres zum Erstellen einer sofort lauffähigen Version eines Simulink^®-Modells, bei der Prüfungen auf erneutes Erstellen übersprungen werden, finden Sie unter Model Publishing (Simulink Coder).

Näheres zum Verbergen des geistigen Eigentums in einem Modell finden Sie unter Model Protection (Simulink Coder).

Wie Sie SIL/PIL-Tests für eine Modellreferenzhierarchie durchführen, erfahren Sie unter SIL and PIL Simulations (Embedded Coder).

Blöcke

	Model	Reference another model to create model hierarchy
	Variant Subsystem	Template subsystem containing Subsystem blocks as variant choices

Funktionen

alle erweitern

Referenzierte Modelle

`depview`	Analyze and visualize model reference dependencies with or without library dependencies
`find_mdlrefs`	Find referenced models and Model blocks in model hierarchy
`pathsToReferencedModel`	Model hierarchy path composed of referenced models and Model blocks (Seit R2023b)
`Simulink.BlockDiagram.refreshBlocks`	Update variants, linked blocks, and model references to reflect changes (Seit R2023a)
`Simulink.BlockPath`	Fully specified Simulink block path
`Simulink.fileGenControl`	Specify root folders for files generated by diagram updates and model builds
`Simulink.ModelReference.refresh`	Refresh Model block to reflect changes to referenced model
`Simulink.SubSystem.convertToModelReference`	Convert subsystems to models
`slbuild`	Generate and compile standalone or model reference code from model

Simulink-Cache-Dateien

`slxcinfo`	Query contents of Simulink cache files
`slxcmerge`	Merge Simulink cache files in new file (Seit R2026a)
`slxcunpack`	Unpack simulation and code generation targets from Simulink cache file

Veröffentlichte Modelle

`createExternalParametersAlternateSource`	Create alternate value source for published model external parameters (Seit R2026b)
`slxpinfo`	High-level information about published or protected model (Seit R2024b)
`unpackPublishedModelDataSources`	Unpack original data sources from published model (Seit R2026b)
`unpackPublishedModelSupplementalFiles`	Unpack supplemental files from published model (Seit R2026b)

Geschützte Modelle

`slxpinfo`	High-level information about published or protected model (Seit R2024b)
`Simulink.ProtectedModel.createHarness`	Create harness model that provides isolated environment for testing protected model
`Simulink.ProtectedModel.getPublisher`	Return information about publisher that signed the protected model
`Simulink.ProtectedModel.verifySignature`	Verify digital signature on protected model
`Simulink.ProtectedModel.suppressSignatureVerification`	Suppress digital signature verification of protected models

Modelleinstellungen

alle erweitern

Modellreferenzierung

Enable parallel model reference builds	Option to build a model reference hierarchy in parallel whenever possible
MATLAB worker initialization for builds	Options for how to initialize MATLAB workers for parallel builds
Enable strict scheduling checks for referenced models	Option to check consistency of scheduling and sample time in referenced models
Total number of instances allowed per top model	Number of references to this model that can occur in another model
Propagate sizes of variable-size signals	Option to specify how variable-size signals propagate through referenced models
Minimize artificial algebraic loop occurrences	Option to try to eliminate artificial algebraic loops related to referenced model
Propagate all signal labels out of the model	Option to pass propagated signal names out of referenced model
Use local solver when referencing model	Option to use local solver to solve referenced model as separate system of equations (Seit R2022a)
Include custom code for referenced models	Option to use custom code in model reference simulation target
Model dependencies	Data and design files that potentially impact simulation results
Perform consistency check on parallel pool	Option to perform checks on parallel pool before starting parallel build
Pass fixed-size scalar root inputs by value for code generation	Option to pass scalar input to model by reference or value

Modellreferenzierungs-Diagnostik

Unsupported data logging	Diagnostic action to take when data logging is unsupported
No explicit final value for model arguments	Diagnostic action to take for model argument with default value at top-level model reference
Insufficient maximum identifier length	Diagnostic action to take when maximum identifier length is too short to ensure unique global identifiers

Tools

Model Reference Conversion Advisor	Convert subsystems to referenced models
Referenced Files Pane	View, save, and close referenced subsystems and models

Themen

Festlegung, wann Modelle referenziert werden

Component-Based Modeling in Simulink
Consider componentization for large models and multiuser development teams.
Model Reference Behavior and Capabilities
Decide whether to reference one model in another model and how to implement this model reference.
Model Reference Requirements and Limitations
Model references have requirements and limitations relating to features such as reusability, simulation modes, masking, and debugging.

Erstellung von Modellreferenzen

Reference Models
Include a model in another model.
Reference Published Models
Reference ready-to-run published models for faster simulation and code generation. (Seit R2026b)
Reference Protected Models from Third Parties
Use a protected model that you received from a third party.
Convert Subsystems to Referenced Models
Prepare a subsystem for conversion, convert the subsystem to a model, and compare simulation results before and after conversion.
Define Model Reference Interfaces
Ports in the referenced model correspond with ports at the model reference. Signals that cross the model boundary must meet certain requirements.
Inspect Model Hierarchies
Examine the contents, structure, model versions, and logged signals in a model hierarchy.

Konfiguration von Modellreferenzen

Set Configuration Parameters for Model Hierarchies
Configuration parameter values can be different in top models and referenced models. Some configuration parameter values have special requirements or behavior with model referencing.
Conditionally Execute Referenced Models
Execute referenced models conditionally, similar to conditionally executed subsystems.
Referenced Model Sample Times
A referenced model can inherit sample times from the model that references it.
Configure Instance-Specific Values for Block Parameters in a Referenced Model
When you model a reusable component as a referenced model, to configure each instance of the component to use different values for block parameters, create model arguments.
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.

Simulation von Modellhierarchien

Choose Simulation Modes for Model Hierarchies
Select the simulation mode for models in a model hierarchy.
Manage Simulation Targets for Referenced Models
A simulation target, or SIM target, is a MEX file that implements a referenced model that executes in accelerator mode.
Share Simulink Cache Files for Faster Simulation
Use Simulink cache files to share build artifacts that let you avoid the cost of a first-time build.
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.

Enthaltene Beispiele

Component-Based Modeling with Model Reference

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

Live Script öffnen

Protected Model Capabilities

View, simulate, and generate code for a protected model with password-protected actions.

Live Script öffnen

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. For comprehensive instructions, see Convert Subsystems to Referenced Models.