addBlock

Add block to list of tuned blocks for slTuner interface

collapse all in page

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.

example

Examples

collapse all

Add Block to slTuner Interface

Open Script

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

collapse all

`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

collapse all

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

addBlock

Syntax

Description

Examples

Add Block to slTuner Interface

Input Arguments

st — Interface for tuning control systems modeled in Simulink® slTuner interface

blk — Block character vector | string | cell array of character vectors | string array

More About

Tuned Block

Version History

See Also

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

`blk` — Block
character vector | string | cell array of character vectors | string array