Variant Systems

创建自定义模型支持不同版本金宝appspecifications, without duplication

In Simulink^®, you can create models that are based on a modular design platform that comprises a fixed common structure with a finite set of variable components. The variability helps you develop a single, fixed master design with variable components.

The approach helps you meet diverse customer requirements that are governed by application, cost, or operational considerations.

Variants are the variable components of modular design platforms. They help you specify multiple implementations of a model in a single, unified block diagram. For more information, seeWhat Are Variants and When to Use Them.

有两种类型的变体,分层和inline. Hierarchical variants are throughVariant Subsystemblocks, whereas Inline Variants are throughVariant SourceandVariant Sinkblocks. Use of aVariant Subsystem块提供了这些优势:

Allows you to mixModelandSubsystemblocks as variant systems
Supports flexible I/O, so that all variants do not need to have the same number of input and output ports

Blocks

Variant Subsystem, Variant Model	Template subsystem containing Subsystem, Model, or Subsystem Reference blocks as variant choices
Variant Source	Route among multiple inputs using variants
Variant Sink	Route amongst multiple outputs using variants
Manual Variant Source	Switch between multiple variant choices at input
Manual Variant Sink	Switch between multiple variant choices at output

Classes

`Simulink.Variant`	Specify conditions that control variant selection
`Simulink.VariantConfigurationData`	Class representing a variant configurations data object
`Simulink.VariantControl`	创造e a variant control variable object
`Simulink.VariantVariable`	创造e a variant parameter object
`Simulink.VariantManager`	Access Variant Manager functionality programmatically
`Simulink.VariantConfigurationAnalysis`	Analyze variant configurations programmatically

Topics

Introduction to Variants

What Are Variants and When to Use Them
Single system that caters to multiple variant requirements.
Variant Terminology
Learn terminology and parameters related to Simulink variants.
创造e a Simple Variant Model
Learn how to create a model using Variant blocks.
Introduction to Variant Controls
Learn how to control variant blocks and variant parameters.
Working with Variant Choices
Activate, inactivate, or create default variant choices.
创造e Variant Controls Programmatically
Use MATLAB^®code to define variant controls.
Activate Variant During Different Stages of Simulation and Code Generation Workflow
Use variant activation time to set active choices during different stages of simulation and code generation workflows.
Approaches to Control Active Variant Choice of a Variant Block Using Mask or Model Workspace
This example shows different approaches to control the active choice of inline variant and Variant Subsystem blocks from a mask or a model workspace.
Variant Condition Propagation Overview
Understand variant condition propagation in Simulink.

Variant Subsystem

Variant Subsystems
Learn basic functionality of variant subsystems.
Define, Configure, and Activate Variant Choices in a Variant Subsystem Block
Represent variant choices in Variant Subsystems.
Propagate Variant Conditions Outside Variant Subsystems
Propagate variant conditions outside aVariant Subsystemblock to adapt its interface according to the state of underlying blocks.
Use Variant Subsystem Blocks with Conditionally Executed Subsystems
Understand how to use Variant Subsystem blocks with conditionally executed systems as variant choices.
Convert Configurable Subsystem to Variant Subsystem
Learn how to convert configurable subsystems to variant subsystems and their behavior on loading.
Control Active Choice of Locked Custom Library Variant Subsystem Using Mask Parameter
Control active choice ofVariant Subsystemthat belongs to a locked custom library.
Automatic Mask Icon Promotion in Variant Subsystems
This example demonstrates how Simulink® automatically displays the mask icon of the active variant block on the parent Variant Subsystem block.
Variant Function-Call Signals on Variant Subsystem Outport
This example shows how the Variant Subsystem block allows function-call signals from its choice blocks to be merged on its outports.
Model Reference Variants
This example shows how to use model reference variants.

Inline Variants

Define and Configure Variant Sources and Sinks
代表变体选择使用内联变体。
Visualize Variant Implementations in a Single Layer
View the variant choices in a model containing Inline Variants.
Variant Source and Variant Sink Blocks
Define variant choice in Variant Source and Sink blocks.
Variant Condition Propagation with Variant Sources and Sinks
Propagate variant conditions from the Variant Source and Variant Sink blocks.
Propagate Variant Conditions from Variant Source Blocks to Subsystem Blocks
Understand variant condition propagation to virtual and non-virtual subsystems.
Propagate Variant Conditions from Variant Source Blocks to Conditionally Executed Subsystems
Learn about variant condition propagation from Variant Source blocks to conditional subsystems .
Control Variant Condition Propagation
Control propagation of variant conditions upstream and downstream.
Variant Elements within Buses
Understand how to create variant bus, generate code, and variant condition propagation with bus.
Use Variant Source Block to Receive or Output Function-Call Signals for Simulation and Code Generation
This example shows how a Variant Source block receives function-call signals at its input ports and conditionally merges the signals at its output port.

Code Generation

Prepare Variant-Containing Model for Code Generation
Configure and generate code for a variant model.

Variant Manager

Variant Manager Overview
Use a central tool to manage variation points of a variants model.
创造e and Validate Variant Configurations
创造e variant configuration for a model and validate their accuracy.
Import Control Variables to Variant Configuration
Import control variables associated with a model.
Define Constraints
Define constraints across models.
Export, Save, Refresh, and Load a Variant Configuration Data Object
This example shows how to export, save, and load a variant configuration data object for a Simulink® model using Variant Manager.
Reduce Models Containing Variant Blocks
Generate models with a subset of variant configurations.
Analyze Variant Configurations in Models Containing Variant Blocks
Analyze model references and libraries for each variant configuration in a model containing variant blocks.

Variant Parameters

Use Variant Parameters to Reuse Block Parameters with Different Values
Design one model for many systems that differ in block parameter values.
创造e a Simple Variant Parameter Model
This example shows you how to create a simple model with variant parameters.
Change Active Values and Activation Time of Variant Parameters
This example shows how to change the active values and activation time of variant parameters in a Simulink® model.
Options to Represent Variant Parameters in Generated Code(Embedded Coder)
You can generate the code only for active values or for both active and inactive values of variant parameters in Simulink.

Example Models

V-Model for System Development with Simulink Variants
A set of examples that illustrate some of the Simulink variants capabilities in V-model representation of system development life cycle.

Related Information

Using Variant Subsystems (3 min, 38 sec)

Featured Examples

Variant Source and Variant Sink Blocks

Define variant choice in Variant Source and Sink blocks.

Open Model

创造e Variant Controls Using an In-Memory Enumeration Class

Each variant choice in a Simulink® model is associated with a conditional expression called avariant control. The variant control that evaluates to true determines the active variant choice in the model. This example shows how to create variant controls in your model using an in-memory enumeration class. The enumeration is created using theSimulink.VariantConfigurationDatafunction. You do not need to save the enumeration in a MATLAB® file. In code generation, enumerated types improve readability because condition values are represented as meaningful names instead of literal values.

Open Model

创造e Variant Controls Using MATLAB® Enumeration Class

Each variant choice in a Simulink® model is associated with a conditional expression called avariant control. The variant control which evaluates to true determines the active variant choice in the model. This example shows how to create variant controls in your model using a MATLAB® enumeration in the variant condition expressions. In code generation, enumerated types improve readability because condition values are represented as meaningful names instead of literal values.

Open Model

Reduce a Variant Model for Selected Variant Configuration

A variant model can have multiple variant configurations associated with it. Each configuration represents a combination of variant control values that activates a specific variant choice. You can generate a reduced version of a variant model that represents a single variant configuration using the Variant Reducer. A Simulink® Design Verifier™ license is required to reduce your model. This example shows how to reduce a model programmatically and using the Variant Manager.

Open Model

Verify and Validate Variant Models with Code Compile Activation Time

Verify and validate variant models withcode compilevariant activation time using Simulink® Design Verifier™ and Simulink Test™.

Open Model

Provide Variation at Source and Destination of a Signal Using Manual Variant Source and Manual Variant Sink Blocks

Use the inline variant blocks — Manual Variant Source and Manual Variant Sink. The Manual Variant Source Block provides variation on the source of a signal. The block is a toggle switch that can have two or more input ports and one output port. Each input port is associated with a variant choice. Only one input port can be active during simulation, which in turn determines the active variant region. Similarly, the Manual Variant Sink block provides variation on the destination of a signal. The block can have two or more output ports and one input port. Only one output port can be active during simulation, and the blocks connected to that port determine the active variant.

Open Model

Run Iterative Simulations Without Recompiling Model for Variant Systems Using Fast Restart

Run iterative simulations on a fog lamp controller system using fast restart. The fog lamp controller system can operate in Driver Switch mode or in Sensor Connected mode. In Driver Switch mode, the driver controls the intensity of the fog lamps. In Sensor Connected mode, a sensor adjusts the intensity of the fog lamps based on the intensity of ambient light in the external environment.

Open Script

Simulate Variant Subsystem with Startup Activation Using parsim

Simulate a Variant Subsystem withstartupactivation time usingparsim. You can simulate multiple configurations in parallel with theVariant activation timeset tostartupusingparsim. Each configuration will have one active variant.

Open Model

Generate Code from an Export Function Model

Simulate and generate code for an export function model.

Open Model

Simulate a Protected Model with Code Compile or Startup Activation Time

Simulate a protected model in thecode compileandstartupvariant activation times.

Open Model

Verify and Validate Variant Models with Startup Activation Time

Verify and validate variant models withstartupvariant activation time using Simulink Design Verifier and test it using Simulink Test.

Open Model

Simulate Variant Blocks in Accelerator and Rapid Accelerator Modes with Startup Activation Time

Simulate Variant Source and Variant Sink blocks in accelerator and rapid accelerator mode withstartupvariant activation time.

Open Model

Generate Code from Variant Blocks with Startup Activation Time

Generate code withstartupvariant activation time. The generated code contains all variant choices with regularifstatements.

Open Model

Generate Code from Nested Variant Subsystem with Code Compile and Startup Activation

Illustrates howcode compileandstartupvariant activation time can be used together in two nested variant subsystems.

Open Model

创造e Standalone Executables with Variants using Simulink Compiler

创造e a standalone executable with a Variant Subsystem using the Simulink Compiler workflow. You can use the same workflow for the Variant Source and Sink blocks as well.

Open Model

Compile Code Conditionally for all Values of Variant Parameters with Same and Different Dimensions

Generate a C code that contains all the active and inactive values of variant parameters. The values are enclosed in preprocessor conditionals#ifand#elifthat enables you to compile the code conditionally based on the condition that evaluates totrue.

Open Script

Run Executable for Different Variant Parameter Values Without Recompiling Code

Generate an executable that runs for different set of variant parameter values without needing to recompile the code for each set of values.

Open Model

Improve Code Readability of Variant Parameters Using Enumerated Types

You can use enumerated types to improve code readability of variant control values in variant parameters. Simulink Enumerations improve readability because enumerated types of variant controls values are represented as meaningful names instead of integers in the generated code.

Open Script

Reuse Variant Parameter Values from Handwritten Code Using Simulink.Parameter Variables

UseSimulink.Parametervariables to generate a code that imports variant parameter values from your existing code. Importing variant parameter values allows you to reuse the values that your existing code defines. You can then integrate and compile the generated and existing code into a single executable. You can choose to generate a code that imports variant parameter values at the beginning of code compile, simulation-loop, or model startup phases of simulation and code generation workflows based on the activation time you specify. For more information, see Activate Variant During Different Stages of Simulation and Code Generation Workflow.

Open Script

创造e Real-Time Applications Using Variants and Simulink Real-Time

A real-time application with a variant subsystem by using the Simulink® Real-Time™ workflow. Simulink Real-Time lets you create real-time applications from Simulink models and run them on Speedgoat® target computer hardware connected to your physical system.

Open Script