addSubModelConfigurations

R2026b

(To be removed) Add to a variant configuration the names of the configurations to be used for referenced models

addSubModelConfigurations will be removed in a future release. Use addReferencedConfiguration instead. (since R2022b) For information on updating your code, see Version History.

Syntax

addSubModelConfigurations(varconfigdata,configName,subModelConfigs)

Description

addSubModelConfigurations(varconfigdata,configName,subModelConfigs) associates a variant configuration in varconfigdata with the configurations that must be used for referenced models. varconfigdata is a Simulink.VariantConfigurations object and represents the variant configurations object of the parent model. subModelConfigs specifies names of the variant configurations to be used for referenced models.

Examples

Add SubModel Configuration

Add the path to the model file.

addpath(fullfile...
(matlabroot,'examples','simulink_variants','main'));

Load the model.

load_system('slexVariantManagement');

Obtain variant configurations object for the model.

vcdataObj = Simulink.VariantConfigurations.getFor...
 ('slexVariantManagement');

Add a new submodel configuration to LinInterExpNoNoise.

addSubModelConfigurations(vcdataObj,'LinInterExpNoNoise',...
  [struct('ModelName', 'slexVariantManagementExternalPlantMdlRef',...
          'ConfigurationName', 'LowFid')])

Input Arguments

varconfigdata — Variant configurations object

Simulink.VariantConfigurations

Variant configurations object in which the top-level configuration configName is defined, specified as a Simulink.VariantConfigurations object.

configName — Name of variant configuration of top level model

character vector | string

Name of variant configuration of top level model, specified as a character vector or string.

Example: "LinInterExpNoNoise"

Data Types: char | string

subModelConfigs — List of referenced models and their variant configurations

vector of structures

Vector of structures containing fields: ModelName, ConfigurationName. The names of referenced models must be unique and valid MATLAB^® variable names and configuration names must be valid MATLAB variables.

Example: [struct('ModelName','slexVariantManagementExternalPlantMdlRef','ConfigurationName','LowFid')]

Data Types: struct

Version History

Introduced in R2013b

R2026b: Moved to Simulink Variant Manager

Starting in R2026b, addSubModelConfigurations 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. In earlier releases, the function is available in Simulink.

R2022b: addSubModelConfigurations will be removed

The addSubModelConfigurations function will be removed in a future release. Scripts which use this function continue to work with a warning.

Use the Simulink.VariantConfiguratonData.addComponentConfiguration function or add the variant control variables used by referenced components in the model hierarchy to the variant configurations of the top-level model instead.

For existing models with an associated variant configuration object, variant control variables in the referenced model configuration will be automatically migrated to the configuration of the top-level model. You must save the variant configuration object using Variant Manager to fix related warnings.

For more information on setting up variant control variables for referenced components, see Compose Variant Configurations and Constraints for Top Model Using Referenced Configurations.