dksynOptions
(Not recommended) Options for dksyn
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
Description
specifies options by setting properties using one or more name-value pair arguments.options
= hinfstructOptions(Name,Value
)
Properties
FrequencyVector
— Frequencies for mu-analysis
[]
(default) | vector
Frequencies for mu-analysis, specified as a vector. When empty,
dksyn
automatically chooses the frequency range and number of
points.
InitialController
— Controller for initializing first iteration
[]
(default) | ss
Controller for initializing first iteration, specified as a state-space
(ss
) model.
AutoIter
— Automated mu-synthesis mode
'on'
(default) | 'off'
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.
DisplayWhileAutoIter
— Status of display in automated mode
'off'
(default) | 'on'
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.
StartingIterationNumber
— Iteration number for initiating iteration procedure
1 (default) | positive integer
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.
NumberOfAutoIterations
— Number of iterations to perform in automatic mode
10 (default) | positive integer
Number of iterations to perform in automatic mu-synthesis mode, specified as a positive integer.
MixedMU
— Flag indicating whether to perform mixed real/complex mu-synthesis
'off'
(default) | 'on'
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.
AutoScalingOrder
— State order for fitting scaling data for mixed mu-synthesis
[5 2]
(default) | vector of form [d,g]
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.
AutoIterSmartTerminate
— Automatic termination mode
'on'
(default) | 'off'
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:
and
The stopping criteria is also satisfied for an undesirable significant increase in the objective value if:
AutoIterSmartTerminateTol
— Tolerance for automatic termination mode
0.005
(default) | positive scalar
Tolerance for AutoIterSmartTerminate
mode.
Examples
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;
Version History
Introduced in R2013aR2020a: dksynOptions
is not recommended
The musyn
command,
introduced in R2019b, performs µ-synthesis with better numeric stability than
dksyn
and yields better results for real uncertain parameters and for
repeated parameters. musyn
can also design fixed-structure controllers.
Therefore, it is recommended that you use musyn
instead of
dksyn
. Similarly, use musynOptions
and musynperf
instead of dksynOptions
and dksynperf
.
See Also
Comando MATLAB
Hai fatto clic su un collegamento che corrisponde a questo comando MATLAB:
Esegui il comando inserendolo nella finestra di comando MATLAB. I browser web non supportano i comandi MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)