removeBlock

Remove block from list of tuned blocks in slTuner interface

Syntax

removeBlock(st,blk)

Description

removeBlock(st,blk) removes the specified block from the list of tuned blocks for the slTuner interface, st. You can specify blk to remove either a single or multiple blocks.

removeBlock does not modify the Simulink^® model associated with st.

Examples

Remove Block from List of Tuned Blocks of slTuner Interface

Create an slTuner interface for the scdcascade model. Add C1 and C2 as tuned blocks to the interface.

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

Remove C1 from the list of tuned blocks of st.

removeBlock(st,'C1');

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 | positive integer | vector of positive integers

Block to remove from the list of tuned blocks for st, specified as one of the following:

• Character vector or string — Full block path or any portion of the block path that uniquely identifies the block among the other tuned blocks of st. For example, blk = 'scdcascade/C1'.

• Cell array of character vectors or string array — Specifies multiple blocks. For example, blk = {'C1','C2'}.

• Positive integer — Block index. For example, blk = 1.

• Vector of positive integers — Specifies multiple block indices. For example, blk = [1 2].

To determine the name or index associated with a tuned block, type st. The software displays the contents of st in the MATLAB^® command window, including the tuned block names.

More About

Tuned Blocks

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