Simulink.VariantManager.reduceModel

Names of variant configurations to be retained in the reduced model, specified as a string, a character vector, a cell array of strings, or a cell array of character vectors. These named variant configurations must be present in the variant configuration data object (of type Simulink.VariantConfigurationData) associated with the model.

Data Types: char | string | cell

Variant control variables and their values that must be used for reduction, specified as a cell array containing the variable names and values.

You can create multiple named variable groups for a model. To specify names for the variable groups, specify a struct array with the fields Name and VariantControls. Name denotes the name of the variable group, and VariantControls must be a cell array with variant control variable names and their corresponding values. For example:

 Simulink.VariantManager.reduceModel('slexVariantReducer',...
 'VariableGroups', struct('Name', 'Group1', 'VariantControls', {{'V',1,'W',[1 2]}}));

Example: 'VariableGroups', {{'V',1,'W',1},{'V',2,'W',2}}

Data Types: cell

Variables for which their full range must be considered for reduction, specified as a cell array of variant control variable names and their corresponding values. This option allows you to reduce a model for all valid values of the specified variant control variables. You must also provide a reference value for this variant control variable for which the model compiles successfully.

For example, consider a variant control variable W that is specified as a full-range variant control variable. W uses a reference value of 1. The reduction process considers V = 1 and all valid values of W. To perform full-range analysis, Variant Reducer compiles the model once using the values {'V',1,'W',1}.

Simulink.VariantManager.reduceModel('slexVariantReducer',...
                    'VariableGroups',{'V',1},...
                    'FullRangeVariables',{'W',1});

Data Types: cell

Compilation mode, specified as 'sim' or 'codegen'. These options indicate whether the model should be compiled for simulation or code generation mode, respectively, as part of reduction. If the model contains variant blocks with the Variant control mode parameter set to sim codegen switching, you can specify the value as 'codegen' to retain the code generation branches of the blocks in the reduced model. For the default value 'sim', Variant Reducer compiles and retains the simulation branches in the top-level model.

List of files outside the MATLAB^® root folder to exclude from reduction, specified as a character vector, string array, or a cell array of character vectors or string arrays.

You can exclude:

You can specify the full path of the folder or the specific files that must be excluded, which can include wildcard characters.

Example: 'components\*.slx', {'mylib.slx','myssref.slx'}, '*.sldd', 'topData.sldd'

For additional information, see Excluded Files in Model Components That Are Not Reduced.

Data Types: char | string | cell

Remove outer layer of Variant Subsystem when only one choice of the variant subsystem remains active in the reduced model, specified as a numeric or logical 1 (true) or 0 (false).

The option is enabled by default. Variant Reducer removes the outer layer of the Variant Subsystem block and moves the block that represents the active choice to the top level. The action reconnects the signal lines that were present on the removed block to the active choice.

Data Types: logical

Folder to place the reduced models and related artifacts, specified as a character vector or string. By default, the reduced models are generated in a folder named reducedModel within the original model folder.

Option to preserve signal attributes in the reduced model, specified as a numeric or logical 1 (true) or 0 (false). When the value is true, Variant Reducer preserves the compiled signal attributes from the original model by adding signal specification blocks at appropriate block ports in the reduced model. Compiled signal attributes include signal data types, signal dimensions, and compiled sample times.

Option to display detailed reduction steps, specified as a numeric or logical 1 (true) or 0 (false). When the value is true, Variant Reducer displays details of the steps performed during model reduction.

Suffix to append to the name of the reduced model and the related artifacts, specified as a character vector.

Option to generate a summary HTML file, specified as a numeric or logical 1 (true) or 0 (false). When the value is true, Variant Reducer generates an HTML file with details about the reduced model and any modifications that may be required for masks and callbacks.