setPreferredConfiguration

R2026b

Set name of preferred variant configuration for variant configurations object

Since R2022b

Syntax

setPreferredConfiguration(varConfigs,ConfigurationName=nameOfConfig)

Description

setPreferredConfiguration(varConfigs,ConfigurationName=nameOfConfig) sets nameOfConfig as the preferred variant configuration for the Simulink.VariantConfigurations object varConfigs.

Examples

Set Name of Preferred Variant Configuration

Open the model slexVariantManagement.

modelName = "slexVariantManagement";
open_system(modelName);

Get the variant configurations object associated with the model.

varConfigs = Simulink.VariantManager.getVariantConfigurations(modelName);

Set the name of the preferred variant configuration in the variant configurations object.

setPreferredConfiguration(varConfigs,ConfigurationName="LinInterExpNoNoise");

Apply the preferred variant configuration and compile the model.

Simulink.VariantManager.applyConfiguration(modelName, ...
 ConfigurationName=getPreferredConfiguration(varConfigs));
set_param(modelName,SimulationCommand="Update");

Input Arguments

varConfigs — Variant configurations object

Simulink.VariantConfigurations object

Variant configurations object for which you want to set the preferred configuration, specified as a Simulink.VariantConfigurations object.

nameOfConfig — Name of preferred variant configuration

character vector | string scalar

Name of the preferred variant configuration, specified as a character vector or string scalar.

Example: "LinInterExpNoNoise"

Data Types: char | string

Version History

Introduced in R2022b

R2026b: Moved to Simulink Variant Manager

Starting in R2026b, setPreferredConfiguration is available in the Simulink^® Variant Manager™ product. In releases R2022b through R2026a, the function is available in the Variant Manager for Simulink support package.

R2026a: Specify function arguments using Name=Value syntax

Specify input arguments for the setPreferredConfiguration function using the Name=Value syntax. The function continues to support positional arguments, but it is recommended to use the Name=Value syntax instead.