addBlock

Add block to list of tuned blocks for slTuner interface

Syntax

addBlock(st,blk)

Description

addBlock(st,blk) adds the block referenced by blk to the list of tuned blocks of the slTuner interface, st.

Examples

Add Block to slTuner Interface

Open the Simulink® model.

mdl = 'scdcascade';
open_system(mdl)

Create an slTuner interface for the Simulink model, and add a block to the list of tuned blocks of the interface.

st = slTuner(mdl,'C1');
addBlock(st,'C2');

Input Arguments

st — Interface for tuning control systems modeled in Simulink^®

slTuner interface

Interface for tuning control systems modeled in Simulink, specified as an slTuner interface.

blk — Block

character vector | string | cell array of character vectors | string array

Block to add to the list of tuned blocks for st, specified as:

• Character vector or string — Block path. You can specify the full block path or a partial path. The partial path must match the end of the full block path and unambiguously identify the block to add. For example, you can refer to a block by its name, provided the block name appears only once in the Simulink model.

  For example, blk = 'scdcascade/C1'.

• Cell array of character vectors or string array — Multiple block paths.

  For example, blk = {'scdcascade/C1','scdcascade/C2'}.

More About

Tuned Block

Tuned blocks, used by the slTuner interface, identify blocks in a Simulink model whose parameters are to be tuned to satisfy tuning goals. You can tune most Simulink blocks that represent linear elements such as gains, transfer functions, or state-space models. (For the complete list of blocks that support tuning, see How Tuned Simulink Blocks Are Parameterized). You can also tune more complex blocks such as SubSystem or S-Function blocks by specifying an equivalent tunable linear model.

Use tuning commands such as systune to tune the parameters of tuned blocks.

You must specify tuned blocks (for example, C1 and C2) when you create an slTuner interface.

st = slTuner('scdcascade',{'C1','C2'})

You can modify the list of tuned blocks using addBlock and removeBlock.

To interact with the tuned blocks use:

• getBlockParam, getBlockValue, and getTunedValue to access the tuned block parameterizations and their current values.

• setBlockParam, setBlockValue, and setTunedValue to modify the tuned block parameterizations and their values.

• writeBlockValue to update the blocks in a Simulink model with the current values of the tuned block parameterizations.

Version History

Introduced in R2014a