functionrootLocusOfModel

Compute and plot the root locus of one parameter of a model (= eigen values of the model that is linearized for every parameter value)

Extends from Modelica.Icons.Function (Icon for functions).

Information

Syntax

Plot.rootLocusOfModel(modelName, modelParam, simulationSetup, diagram, device)

Description

This function computes and plots a root locus of a selected Modelica model by varying one parameter and performing an eigen value analysis for every parameter value. Other parameters of the model can be set to a specific value. An equidistant or a logarithmic gridding of the parameter to be varied can be selected and then the gridding is performed between the given minimum and maximum value.

Example

Calling the function

Utilities.Plot.rootLocusOfModel(
  modelName = "Modelica.Mechanics.Rotational.Examples.First",
  modelParam={
    Modelica_LinearSystems2.Records.ParameterVariation(
      Name="Jload",
      grid=Modelica_LinearSystems2.Types.Grid.Logarithmic
      Min=1,
      Max=6,
      nPoints=101)});

yields the following diagram (the menu on the right lower part is displayed when moving the cursor on one curve point; then all points belonging to the same parameter value are marked with a red square):

Inputs

TypeNameDefaultDescription
StringmodelNameName of the Modelica model
Modelica_LinearSystems2.Records.ParameterVariation[:]modelParamModel parameter to be varied (exactly one) and values for other parameters
Modelica_LinearSystems2.Records.SimulationOptionsForLinearizationsimulationSetupModelica_LinearSystems2.Records.SimulationOptionsForLinearization()Simulation options
Modelica_LinearSystems2.Utilities.Plot.Records.RootLocusDiagramdiagramModelica_LinearSystems2.Utilities.Plot.Records.RootLocusDiagram()
Modelica_LinearSystems2.Utilities.Plot.Records.DevicedeviceModelica_LinearSystems2.Utilities.Plot.Records.Device()Properties of device where figure is shown