Simulink.VariantManager class

Package: Simulink

Access Variant Manager functionality programmatically

Description

Note

This class requires Variant Manager for Simulink^®.

The Simulink.VariantManager class provides a set of methods to access Variant Manager functionality programmatically. Use an instance of Simulink.VariantManager class to:

• Apply a variant configuration to a model.

• Validate and activate a variant configuration in a model.

• Automatically generate all possible variant configurations for a model.

• Generate a reduced model for specified variant configurations.

• Get the VariantConfigurationData object associated with a model.

• Get the name of the preferred variant configuration for a model.

• Find variant control variables used in variant control expressions in a model.

Methods

Public Methods

Simulink.VariantManager.activateModel	Validate and activate variant blocks in model hierarchy
Simulink.VariantManager.applyConfiguration	Apply specified variant configuration to model
Simulink.VariantManager.findVariantControlVars	Find variables used in variant control expressions
Simulink.VariantManager.generateConfigurations	Generate variant configurations automatically
Simulink.VariantManager.getConfigurationData	Get variant configuration data object associated with model
Simulink.VariantManager.getPreferredConfigurationName	Get name of preferred variant configuration for model
Simulink.VariantManager.reduceModel	Generate reduced model for specified variant configurations

Examples

Find Variant Control Variables for Model

This example shows how to find the variant control variables used in a model.

Open the model slexVariantManagement.

model = 'slexVariantManagement';
open_system(model); 

Find the variant control variables.

vars = Simulink.VariantManager.findVariantControlVars(model)

vars=6×1 struct array with fields:
    Name
    Value
    Exists
    Source
    SourceType

Version History

Introduced in R2016a

R2023b: convertToVariant, convertToVariantAssemblySubsystem, and variantLegend methods moved to Simulink.VariantUtils class

The convertToVariant, convertToVariantAssemblySubsystem, and variantLegend methods will be removed from the Simulink.VariantManager class in a future release. The method calls continue to work with a warning.

Use the Simulink.VariantUtils class to access these methods. The convertToVariant method in the Simulink.VariantManager class has been renamed to convertToVariantSubsystem in the Simulink.VariantUtils class.

R2022b: New add-on required

You must install the Variant Manager for Simulink software support package to use this class and its methods.

R2022b: New methods

The class has these new methods:

• Simulink.VariantManager.activateModel

• Simulink.VariantManager.applyConfiguration

• Simulink.VariantManager.generateConfigurations

• Simulink.VariantManager.getPreferredConfigurationName

• Simulink.VariantManager.getConfigurationData