addSubModelConfigurations

(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 addComponentConfiguration 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.VariantConfigurationData object and represents the variant configuration 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 configuration data object for the model.

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

Add a new submodel configuration to LinInterExpNoNoise.

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

Input Arguments

varconfigdata — Variant configuration data object

Simulink.VariantConfigurationData

Variant configuration data object in which the top-level configuration configName is defined, specified as a Simulink.VariantConfigurationData 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

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 Component Configurations.