.Modelica_LinearSystems2.Utilities.Plot.rootLocusOfModel

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):

Interface

function rootLocusOfModel
  extends Modelica.Icons.Function;
  input String modelName "Name of the Modelica model" annotation(
    Dialog(__Dymola_translatedModel));
  input Modelica_LinearSystems2.Records.ParameterVariation modelParam[:] "Model parameter to be varied (exactly one) and values for other parameters";
  input Modelica_LinearSystems2.Records.SimulationOptionsForLinearization simulationSetup = Modelica_LinearSystems2.Records.SimulationOptionsForLinearization() "Simulation options";
  input Modelica_LinearSystems2.Utilities.Plot.Records.RootLocusDiagram diagram = Modelica_LinearSystems2.Utilities.Plot.Records.RootLocusDiagram() annotation(
    Dialog);
  input Modelica_LinearSystems2.Utilities.Plot.Records.Device device = Modelica_LinearSystems2.Utilities.Plot.Records.Device() "Properties of device where figure is shown" annotation(
    Dialog);
end rootLocusOfModel;