dksynOptions

(Not recommended) Options for dksyn

expand all in page

dksynOptions is not recommended. Use musynOptions instead. For more information, see dksynOptions is not recommended.

Description

Use dksynOptions to define algorithm, display, and parallel options for the dksyn command.

Creation

Syntax

options = dksynOptions
options = hinfstructOptions(Name,Value)

Description

options = dksynOptions returns the default option set for the dksyn command.

example

options = hinfstructOptions(Name,Value) specifies options by setting properties using one or more name-value pair arguments.

example

Properties

expand all

Frequencies for mu-analysis, specified as a vector. When empty, dksyn automatically chooses the frequency range and number of points.

Controller for initializing first iteration, specified as a state-space (ss) model.

Automated mu-synthesis mode, specified as 'on' or 'off'. When automated mu-synthesis mode is off, dksyn performs an interactive D-K iteration procedure. and prompts you to fit the D-scale data and provide input on the control design process.

Status of display in automated mu-synthesis mode, specified as 'off' or 'on'. When the display is on and automated mu-synthesis mode is active, dksyn displays the iteration progress during the synthesis computation.

Iteration number for initiating iteration procedure, specified as a positive integer. Use this option when you provide the prevdkinfo argument to dksyn to use information from a previous dksyn calculation. In this case, specify the starting iteration number from which to resume the iteration procedure.

Number of iterations to perform in automatic mu-synthesis mode, specified as a positive integer.

Flag indicating whether to perform mixed real/complex mu-synthesis when real parameters are present, specified as 'off' or 'on'. Mixed mu-synthesis accounts for uncertain real parameters directly in the synthesis process. Setting 'MixedMU' to 'on' when you have uncertain real parameters can result in improved robust performance of the synthesized controller.

State order for fitting D-scaling and G-scaling data for real/complex mu-synthesis, specified as a vector of the form [d,g]. For instance, the default value [5 2] uses fifth-order D-scalings and second-order G-scalings.

Automatic termination mode, specified as 'on' or 'off'. When AutoIterSmartTerminate is 'on', the iteration procedure terminates based on the progress of the design iteration. Set the tolerance for automatic termination using AutoIterSmartTerminateTol.

In automatic termination mode, the iteration procedure terminates when a stopping criterion is satisfied. The stopping criterion involves the objective value (peak value, across frequency, of the upper bound for µ) in the current iteration, denoted v0. The stopping criterion also involves the objective value in the previous two iterations, denoted v–1 and v–2. The stopping criterion is satisfied for lack of progress if:

|v0−v−1|<AutoIterSmartTerminateTol*v0,

and

|v−1−v−2|<AutoIterSmartTerminateTol*v0.

The stopping criteria is also satisfied for an undesirable significant increase in the objective value if:

v0>v−1+20*AutoIterSmartTerminateTol*v0.

Tolerance for AutoIterSmartTerminate mode.

Examples

collapse all

Create an options set for a dksyn run using a logarithmic distribution of frequency points for analysis and performing 24 iterations. 

options = dksynOptions('FrequencyVector',logspace(-2,3,80),...
                       'NumberOfAutoIterations',24);

Alternatively, use dot notation to set the values of options. 

options = dksynOptions;
options.FrequencyVector = logspace(-2,3,80);
options.NumberOfAutoIterations = 24;

Version History

Introduced in R2013a

expand all

See Also

|