Accelerating the pace of engineering and science

# dksynOptions

Set options for dksyn

## Syntax

opt = dksynOptions
opt = dksynOptions(Name,Value)

## Description

opt = dksynOptions returns the default options for dksyn.

opt = dksynOptions(Name,Value) returns an option set with additional options specified by one or more Name,Value pair arguments.

## Input Arguments

### Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

dksynOptions takes the following Name arguments:

 'FrequencyVector' Frequencies for mu-analysis, specified as a vector. When empty, dksyn automatically chooses the frequency range and number of points. Default: [] 'InitialController' Controller for initializing first iteration, specified as a state-space (ss) model. Default: [] 'AutoIter' Automated mu-synthesis mode, specified as one of the strings 'on' or 'off'. When automated mu-synthesis mode is off, dksyn performs an interactive D-K iteration procedure. You are prompted to fit the D-scale data and provide input on the control design process. Default: 'on' 'DisplayWhileAutoIter' Status of display in automated mu-synthesis mode, specified as one of the strings 'off' or 'on'. When the display is on, and automated mu-synthesis mode is active, dksyn displays the iteration progress during the synthesis computation. Default: 'off' 'StartingIterationNumber' 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. Default: 1 'NumberOfAutoIterations' Number of iterations to perform in automatic mu-synthesis mode, specified as a positive integer. Default: 10 'MixedMU' Flag indicating whether to perform mixed real/complex mu-synthesis when real parameters are present, specified as one of the strings '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. Default: 'off' 'AutoScalingOrder' State order for fitting D-scaling and G-scaling data for real/complex mu-synthesis, specified as a vector of the form [dorder,gorder]. Default: [5 2] (5th-order D-scalings and 2nd-order G-scalings) 'AutoIterSmartTerminate' Automatic termination mode, specified as one of the strings '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: $|{v}_{0}-{v}_{-1}| and $|{v}_{-1}-{v}_{-2}| The stopping criteria is also satisfied for an undesirable significant increase in the objective value if: ${v}_{0}>{v}_{-1}+20*AutoIterSmartTerminateTol*{v}_{0}.$ Default: 'on' 'AutoIterSmartTerminateTol' Tolerance for AutoIterSmartTerminate mode. Default: 0.005

## Output Arguments

 options Option set containing the specified options for the dksyn command.

## Examples

expand all

### Create Options Set for dksyn

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;
```