Simulink.VariantManager.convertToVariant

Class: Simulink.VariantManager
Package: Simulink

Convert Subsystem or Model blocks to Variant Subsystem block

Syntax

variant_subsystem = Simulink.VariantManager.convertToVariant(blockPathOrHandle)

Description

variant_subsystem = Simulink.VariantManager.convertToVariant(blockPathOrHandle) converts a Subsystem block or Model block to a Variant Subsystem block. A Variant Subsystem can contain a combination of Subsystem blocks, Model blocks, or Subsystem Reference blocks as choices.

Input Arguments

blockPathOrHandle — Subsystem or Model block to convert

block path | block handle

The Subsystem or Model block to convert to a Variant Subsystem block, specified as a block path or handle. Specify a block path as a character vector and a block handle as a scalar.

Example: 'mdlVar1/VariantModelBlock1'

Output Arguments

variant_subsystem — Handle of Variant Subsystem block

scalar

The block handle of the Variant Subsystem block created by the conversion, returned as a scalar.

Examples

Convert Subsystem block or Model block to Variant Subsystem

Convert the Subsystem block Controller in the f14 model to a Variant Subsystem block.

open_system('f14');
Simulink.VariantManager.convertToVariant('f14/Controller');

Convert the Model block CounterA in the sldemo_mdlref_basic model to a Variant Subsystem block.

openExample('simulink_features/ComponentBasedModelingWithModelReferenceExample');
Simulink.VariantManager.convertToVariant('sldemo_mdlref_basic/CounterA');

Limitations

The convertToVariant method does not support Subsystem blocks in a Simscape™ model that has Editing Mode set to Restricted.

Alternatives

Simulink Editor

In the Simulink^® Editor, right-click the Subsystem or Model block and select Subsystems & Model Reference > Convert to > Variant Subsystem.

Version History

Introduced in R2017b