# Documentation

### This is machine translation

Translated by
Mouse over text to see original. Click the button below to return to the English verison of the page.

# dksynOptions

Set options for dksyn

## Syntax

`opt = dksynOptionsopt = 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 either `'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 either `'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 either `'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 either `'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

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