validateModel

(To be removed) Validate and activate variant blocks in a model hierarchy

validateModel will be removed in a future release. Use Simulink.VariantManager.activateModel instead.

Syntax

[valid,errors] = validateModel(varconfigdata,modelName)

[valid,errors] = validateModel(varconfigdata,modelName,configName)

Description

The validateModel function allows you to validate and activate a variant configuration on a model hierarchy. You can activate a named variant configuration defined for the model or the workspace configuration (temporary configuration in the base workspace or data dictionary used by the model).

The process validates if the variant elements in the model such as variant blocks, variant controls, constraints, and the variant configuration are set up correctly. Activating a configuration:

• Checks if applicable constraints are satisfied

• Applies the variant control variable values defined in the configuration on the model

• Pushes the variant control variable values to the base workspace or data dictionary used by the model, for use in simulation and code generation workflows

[valid,errors] = validateModel(varconfigdata,modelName), where varconfigdata is a Simulink.VariantConfigurationData object, returns the result of validating and activating the workspace configuration on the model hierarchy. The variant control variables must be defined in the base workspace or data dictionary used by the model.

[valid,errors] = validateModel(varconfigdata,modelName,configName) returns the result of validating and activating the specified named variant configuration on the model hierarchy.

Note

Activation of a variant configuration performed by this function differs from the Simulink^® update diagram process. See Differences Between Variant Manager Activation and Update Diagram Process.

Examples

Activate and Validate Variant Model

Add the path to the model file.

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

Load the model.

load_system('slexVariantManagement');

Activate and validate the model slexVariantManagement using the configuration LinInterExpNoNoise.

[valid, errors] = Simulink.VariantConfigurationData.validateModel...
  ('slexVariantManagement','LinInterExpNoNoise')

Input Arguments

varconfigdata — Variant configuration data object

Simulink.VariantConfigurationData

Variant configuration data object associated with the model modelName, specified as a Simulink.VariantConfigurationData object.

modelName — Name of the model

character vector

Name of the model, specified as character vector.

Example: "slexVariantManagement"

Data Types: char

configName — Name of the variant configuration

character vector

Name of the variant configuration to be validated and activated, specified as character vector.

Example: "LinInterExpNoNoise"

Data Types: char

Output Arguments

valid — True or false result

1 | 0

True or false result, returned as a 1 or 0 of data type logical.

errors — List of errors

structure

List of errors, returned as an N*1 structure where N is the number of models with errors. The structure has these fields:

Field	Type	Description
Model	char	Name of the model
Errors	structure	An M*1 structure where M is the number of errors in the model. The structure has these fields: Message MessageID

Version History

Introduced in R2013b

R2022b: validateModel will be removed

The validateModel function will be removed in a future release. To validate and activate a variant configuration on a model, use the Simulink.VariantManager.activateModel function. Scripts which use this function continue to work with a warning.

R2022b: Change in the format of errors output argument

The fields Type, Source, PathInModel, and PathInHierarchy have been removed from the structure named Errors within the second output argument, errors.