setPreferredConfiguration

Set name of preferred variant configuration for variant configuration data object

Since R2022b

Syntax

setPreferredConfiguration(varConfigData,ConfigurationName=nameOfConfig)

Description

Add-On Required: This feature requires the Variant Manager for Simulink add-on.

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

Examples

Set Name of Preferred Variant Configuration

Open the model slexVariantManagement.

modelName = "slexVariantManagement";
open_system(modelName);

Get the variant configuration data object associated with the model.

varConfigData = Simulink.VariantManager.getConfigurationData(modelName);

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

setPreferredConfiguration(varConfigData,ConfigurationName="LinInterExpNoNoise");

Apply the preferred variant configuration and compile the model.

Simulink.VariantManager.applyConfiguration(modelName, ...
 Configuration=getPreferredConfiguration(varConfigData));
set_param(modelName,SimulationCommand="Update");

Input Arguments

varConfigData — Variant configuration data

Simulink.VariantConfigurationData object

Variant configuration data for which you want to set the preferred configuration, specified as a Simulink.VariantConfigurationData 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

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.