Linearize
You can linearize a model and return the linearized model as
StateSpace object.
-
From the
Behavior Tools section of the
action bar,
click
Linearize
.
A dialog box for the corresponding
function call in Modelica_LinearSystems2 is displayed.
-
If the wanted model is not selected, click
Edit
.
A
Select model dialog box is displayed; browse for
the model by expanding the trees, select the wanted model and click
OK.
Note:
When a new model is selected, it is translated after the
selection.
- Optional:
You can enter values of model parameters for the linearization:
-
Click
modelParam in the left pane of the dialog
box in the first figure above.
The
modelParam tab is displayed:
-
Click
select in the lower right corner of the
dialog box.
A
select dialog box is displayed.
-
Browse for, and select, components.
-
Click
OK to validate selection and close the
select dialog box, or
Cancel to close the dialog box without any
changes.
-
To change the values of selected model parameters, click the
corresponding
Value boxes and change the values.
- Optional:
You can change the simulation setup if you start the linearization
after the initial time:
-
Click
simulationSetup in the left pane of the
dialog box.
The
simulationSetup tab is displayed:
-
Deselect
linearizeAtInitial.
You can now select the following:
- t_start
(simulation start time).
- t_linearize
(start time of linearization).
- method
(integration method to be used between t_start and t_linearize).
- tolerance
(relative error tolerance to be used between t_start and t_linearize).
- fixedStepSize
(step size for fixed step integrators, to be used between t_start and
t_linearize).
-
Select
OK or
Execute to execute the function. You could also
select:
- Info to
display a
Help window and display information about the
function.
- Copy
Call to copy the function call with the values. This can be used
for further scripting.
- Close to
exit the dialog box without calling the function.
The following is performed:
- The function call is
executed.
- The
Modelica Scripting window displays the
function call and the result. For more information, see
The Modelica Scripting Window.
- Information about the
execution is displayed in the
Messages Reporting window, including where the
file is located in which the simulation results are stored. See
Messages Reporting Window
for more information about this window.
Compute (Zeros and) Poles
You can linearize a model and plot the (zeros and) poles of
the linearized model.
-
From the
Behavior Tools section of the
action bar,
click
Compute poles
, or
Compute zeros and poles
, respectively.
A dialog box for the corresponding
function call in Modelica_LinearSystems2 is displayed.
-
If the model to be used is not selected, see step 2 in the first
task above.
-
If the required model is not selected, click
Edit
.
- Optional:
You can enter values of model parameters for the linearization; see
step 3 in the first task above.
- Optional:
You can change the simulation setup if you start the linearization
after the initial time; see step 4 in the first task above.
-
Select
OK or
Execute to execute the function. You could also
select:
- Info to
display a
Help window and display information about the
function.
- Copy
Call to copy the function call with the values. This can be used
for further scripting.
- Close to
exit the dialog box without calling the function.
The following is performed:
- The function call is
executed.
- The
Modelica Scripting window displays the
function call and the result. For more information, see
The Modelica Scripting Window.
- The poles (and zeros if
the corresponding function is selected) are presented in a plotter.
- Information about the
execution is displayed in the
Messages Reporting window, including where the
file is located in which the simulation results are stored. See
Messages Reporting Window
for more information about this window.
Generate a Bode Plot
You can linearize a model and plot the Bode plot from all
inputs to all outputs of the linearized model.
-
From the
Behavior Tools section of the
action bar,
click
Bode plot
.
A dialog box for the corresponding
function call in Modelica_LinearSystems2 is displayed.
-
If the model to be used is not selected, see step 2 in the first
task above.
- Optional:
You can enter values of model parameters for the linearization; see
step 3 in the first task above.
- Optional:
You can change the simulation setup if you start the linearization
after the initial time; see step 4 in the first task above.
-
Select
OK or
Execute to execute the function. You could also
select:
- Info to
display a
Help window and display information about the
function.
- Copy
Call to copy the function call with the values. This can be used
for further scripting.
- Close to
exit the dialog box without calling the function.
The following is performed:
- The function call is
executed.
- The
Modelica Scripting window displays the
function call and the result. For more information, see
The Modelica Scripting Window.
- The Bode diagrams are
presented in a plotter.
- Information about the
execution is displayed in the
Messages Reporting window, including where the
file is located in which the simulation results are stored. See
Messages Reporting Window
for more information about this window.
Perform a Full Analysis
You can linearize a model and perform all available linear
analysis operations.
Plot Root Locus Analysis
You can compute and plot the root locus of one parameter of a
model (= eigenvalues of the model that is linearized for every parameter
value).
-
From the
Behavior Tools section of the
action bar,
click
Plot root locus analysis
.
A dialog box for the corresponding
function call in Modelica_LinearSystems2 is displayed.
-
If the model to be used is not selected, see step 2 in the first
task above.
-
Enter model parameter to be varied and values for other parameters:
-
Click
modelParam in the left pane of the dialog
box.
The
modelParam tab is displayed.
-
Click
select.
A
select dialog box is displayed.
-
Browse for, and select, the parameter to be varied.
-
Click
OK to validate selection and close dialog
box, or
Cancel to close the dialog box without any
changes.
-
You can change the value of the selected model parameter; by
clicking the corresponding
grid,
Value,
Min,
Max, and
nPoints boxes and changing the values.
Note:
You can reset the values by opening again the
select dialog box and ticking
Reset from file: Value in that dialog box,
and then clicking
OK.
- Optional:
You can change the simulation setup if you start the linearization
after the initial time; see step 4 in the first task above.
- Optional:
You can change the properties of the root locus diagram.
-
Click
diagram in the left pane of the window.
The
diagram tab is displayed.
-
Change the properties you want; for example adding a heading,
changing color of lines.
- Optional:
You can change the properties of the device where the figure is
shown.
-
Click
device in the left pane of the window.
The
diagram tab is displayed.
-
Change the properties you want; for example setting the
resolution of the image.
-
Select
OK or
Execute to execute the function. You could also
select:
- Info to
display a
Help window and display information about the
function.
- Copy
Call to copy the function call with the values. This can be used
for further scripting.
- Close to
exit the dialog box without calling the function.
The following is performed:
- The function call is
executed.
- The
Modelica Scripting window displays the
function call and the result. For more information, see
The Modelica Scripting Window.
- The root locus diagram
is presented in a plotter.
- Information about the
execution is displayed in the
Messages Reporting window, including where the
file is located in which the simulation results are stored. See
Messages Reporting Window
for more information about this window.
|