addChoice

Add variant choices to variant component

Syntax

compList = addChoice(variantComponent,choices)

compList = addChoice(variantComponent,choices,labels)

Description

compList = addChoice(variantComponent,choices) creates variant choices specified in choices in the specified variant component and returns their handles.

compList = addChoice(variantComponent,choices,labels) creates variant choices specified in choices with labels labels in the specified variant component and returns their handles.

Examples

Add Variant Choices

Create a model, get the root architecture, create one variant component, and add two choices for the variant component.

model = systemcomposer.createModel("archModel");
systemcomposer.openModel("archModel");
arch = get(model,"Architecture");
variant = addVariantComponent(arch,"Component1");
compList = addChoice(variant,["Choice1","Choice2"]);

Input Arguments

variantComponent — Variant component

variant component object

Variant component, specified as a systemcomposer.arch.VariantComponent object.

choices — Variant choice names

cell array of character vectors | array of strings

Variant choice names, specified as a cell array of character vectors or an array of strings. The length of choices must be the same as labels.

Data Types: char | string

labels — Variant choice labels

cell array of character vectors | array of strings

Variant choice labels, specified as a cell array of character vectors or an array of strings. The length of labels must be the same as choices.

Data Types: char | string

Output Arguments

compList — Created components

array of components

Created components, returned as an array of systemcomposer.arch.Component objects. This array is the same size as choices and labels.

More About

Definitions

Term	Definition	Application	More Information
Variant	A variant is one of many structural or behavioral choices in a variant component.	Use variants to quickly swap different architectural designs for a component while performing analysis.	Create Variants
Variant control	A variant control is a string that controls the active variant choice.	Set the variant control programmatically to control which variant is active.	Set Variant Control Condition

Version History

Introduced in R2019a