Simulink.VariantConfigurationAnalysis Class

Namespace: Simulink

Analyze variant configurations programmatically

Description

Note

This class requires Variant Manager for Simulink^®.

Use the Simulink.VariantConfigurationAnalysis class to analyze variant configurations for a model by specifying either named variant configurations or variable groups. The class returns a variant configuration analysis object and has methods that can be used to:

• Get the list of active blocks in a variant configuration.

• Find blocks that are active across all variant configurations.

• Find blocks that are inactive in all variant configurations.

• Get the list of blocks that differ in active choice between variant configurations.

• Get the list of dependent models for a variant configuration.

• Get the list of dependent libraries that are used in a variant configuration.

• View the variant configuration analysis report.

• Hide the variant configuration analysis report.

• View variant conditions on a block in a given variant configuration.

Creation

varConfigObj = Simulink.VariantConfigurationAnalysis(mdl,Name,Value) returns a variant configuration analysis object for the model specified by model and sets the ModelName and Configurations properties.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'NamedConfigurations', {'config1', 'config2'}

NamedConfigurations — Names of variant configurations

string | cell array of strings

Names of variant configurations, specified as a string or a cell array of strings. Use this argument to perform the analysis by specifying named variant configurations defined for the model.

You can use Variant Manager to create named variant configurations for a model, save them in a variant configuration object of type Simulink.VariantConfigurationData, and associate this object with the model. You can specify one or more configuration names defined in this variant configuration object for the analysis.

Note

If the model is associated with a variant configuration object, then the VariantConfigurationObject model parameter contains the name of the corresponding variant configuration object.

Example: NamedConfigurations={'config1', 'config2'}

VariableGroups — Variant control variable names and values

array of structures

Variant control variable names and values, specified as an array of structures. Use this argument to perform the analysis by specifying values for the variant control variables used by the model.

You can specify multiple variable groups that represent the different variant configurations to be analyzed. In each variable group, you must specify the variant control variables and their values that must be used for the analysis.

To define the variable groups, provide an array of structures with these fields:

• Name — Name of variable group

• VariantControls — Cell array with variant control variable names and their values

Example: 'VariableGroups',[struct('Name', 'V1W1',... 'VariantControls', {{'V',1,'W',1}}),struct('Name', 'V1W2',... 'VariantControls', {{'V',1,'W',2}})]

Note

Specifying both NamedConfigurations and VariableGroups is not supported.

Properties

ModelName — Name of the model

character vector

Name of model to be analyzed, specified as a character vector.

Example: 'slexVariantReducer'

Attributes:

GetAccess	public
SetAccess	private

Data Types: character vector

Configurations — Names of variant configurations or variable groups

cell array of strings

Names of variant configurations or variable groups to be analyzed, specified as a cell array of strings.

Example: {'config1', 'config2'}

Attributes:

GetAccess	public
SetAccess	private

Data Types: character vector

Methods

Public Methods

getActiveBlocks	List of active blocks in a named variant configuration
getAlwaysActiveBlocks	List of blocks that are always active across named variant configurations
getBlockDifferences	List of blocks that differ in their active choice between multiple named variant configurations
getDependentLibraries	List of libraries that are used in a named variant configuration
getDependentModels	List of dependent models that are used in a named variant configuration
getNeverActiveBlocks	List of blocks that are inactive in named variant configurations
getVariantCondition	Variant condition on a block in a named variant configuration
hideUI	Hide variant configuration analysis report for a model
showUI	Show variant configuration analysis report for a model

Examples

Create Variant Configuration Analysis Object for Model

Create a variant configuration analysis object by specifying either named variant configurations or variable groups.

Open the model slexVariantReducer.

open_system('slexVariantReducer');

The model has two named variant configurations, config1 and config2. The named configurations are saved in a variant configuration object, slexVariantReducer_config, associated with the model.

Analyze the model using the named configurations.

VarConfigObjnc = Simulink.VariantConfigurationAnalysis('slexVariantReducer', ...
                                            'NamedConfigurations',{'config1', 'config2'})

VarConfigObjnc = 
  VariantConfigurationAnalysis with properties:

         ModelName: 'slexVariantReducer'
    Configurations: {'config1'  'config2'}

Next, specify variable groups for analysis.

The slexVariantReducer model contains two variant control variables V and W.

Analyze the model using two variable groups, V1W1 and V2W2:

VarConfigObjvg = Simulink.VariantConfigurationAnalysis(...
                            'slexVariantReducer',...
                            'VariableGroups',[struct('Name','V1W1','VariantControls', {{'V',1,'W',1}}),...
                            struct('Name', 'V1W2','VariantControls',{{'V',1,'W',2}})])

VarConfigObjvg = 
  VariantConfigurationAnalysis with properties:

         ModelName: 'slexVariantReducer'
    Configurations: {'V1W1'  'V1W2'}

Limitations

Variant Analyzer does not support models that contain variant blocks that use variant control variables defined in the mask or model workspace.

Version History

Introduced in R2019a