.Modelica_LinearSystems2.UsersGuide.ReleaseNotes.Version_3_0_0

Information

This version requires the Modelica 4.0.0 Library. It is not backward compatible to previous versions 2.X.Y of the Library.

A tested conversion script is provided to transform functions and blocks of previous versions 2.X.Y to this new version. Obsolete classes that could not be automatically converted to alternative implementations have been moved to library ObsoleteLinearSystems2.

For list of all resolved issues, refer to ResolvedGitHubIssues.html.

Improvements in this version

• FullAnalysis and StateSpace.Analysis.analysis return the full path name of report file on output.
• Streams.stateSpaceString_html: bug fix: print state space matrix C of proper size.
• Polynomial.degree: fix wrong calculation of polynomial degree n for zero polynomial coefficients c[1] to c[m] and non-zero c[m+1], with m < length(c).
• Add second second time derivative of polynomial (evaluate_dder), see also example (MoveMassByPolynomial),
• Instantiate imaginary unit j of complex numbers only by import Modelica.ComplexMath.j;
• Documentation and fixed broken links.

Non-backward compatible changes

Deprecated operator record Modelica_LinearSystems2.Math.Complex

The functionality of this record is given by the top-level operator record Complex now and most of the functions can be found in the library Modelica.ComplexMath. The remaining functions contained in this record previously were moved into ComplexMathAdds.

Therefore, the record Modelica_LinearSystems2.Math.Complex was removed. The provided conversion script ensures proper transformation of the record and its functions.

The only exception is the imaginary unit function Modelica_LinearSystems2.Math.Complex.j() which is migrated to ObsoleteLinearSystems2. It is documented in ObsoleteLinearSystems2 how to manually change to proper Modelica.ComplexMath.j.

See also UsersGuide.GettingStarted.ComplexNumbers.

Moved classes

The following classes were relocated and/or renamed within the Library. A conversion script is provided to facilitate the conversion.

• Package Modelica_LinearSystems2.Controller renamed to Controllers.
  • Modelica_LinearSystems2.Controller.Examples.Components renamed to Controllers.Examples.Utilities.
  • Modelica_LinearSystems2.Controller.Templates renamed to Controllers.BaseClasses.
  • Modelica_LinearSystems2.Controller.Templates.Internal.ObserverTemplate moved to Controllers.Observer.
• Package Modelica_LinearSystems2.Internal.Streams moved to Utilities.Streams; and all functions' names start with a lower cas.
• Package Modelica_LinearSystems2.Types moved to Utilities.Types.
• Modelica_LinearSystems2.StateSpace.Internal.readSystemDimension moved to Utilities.Streams.readSystemDimension
• Modelica_LinearSystems2.Math.Polynomial.evaluate_der moved to Polynomial.Internal.evaluate_der.
• Modelica_LinearSystems2.Math.Polynomial.integralValue_der moved to Polynomial.Internal.integralValue_der.
• Modelica_LinearSystems2.Math.Polynomial.rootsOfNonZeroHighestCoefficientPolynomial moved to Polynomial.Internal.rootsOfNonZeroHighestCoefficientPolynomial.

Removed classes

The following classes were removed from the Library. A conversion script is provided to facilitate the conversion.

• Modelica_LinearSystems2.Controller.Examples.Components.DoublePendulum: Plants.DoublePendulum can be used instead. Make sure of using your parameter values since the two models differ in some parameters.
• Modelica_LinearSystems2.Controller.Examples.Components.InverseDoublePendulum: Plants.DoublePendulumInverse can be used instead. Make sure of using your parameter values since the two models differ in some parameters.
• Modelica_LinearSystems2.Controller.Templates.Internal.PartialPlantSISO: use Controllers.BaseClasses.PartialPlantSISO instead.
• Modelica_LinearSystems2.Controller.Templates.Internal.PlantTemplate_SISO: use Controllers.BaseClasses.PartialPlantSISO instead.
• Modelica_LinearSystems2.Controller.Templates.Internal.PartialPlantMIMO: use Controllers.BaseClasses.PartialPlantMIMO instead.
• Modelica_LinearSystems2.Controller.Templates.Internal.PlantTemplate: use Controllers.BaseClasses.PartialPlantMIMO instead.
• Modelica_LinearSystems2.Controller.Templates.PlantTemplate_SISO: use Controllers.BaseClasses.PartialPlantSISO instead.
• Modelica_LinearSystems2.Controller.Templates.PlantTemplate: use Controllers.BaseClasses.PartialPlantMIMO instead.
• Modelica_LinearSystems2.Controller.Interfaces.PartialBlockIcon: use Controllers.Icons.PartialBlockIcon instead.
• Modelica_LinearSystems2.Internal.Streams.ReadSystemDimension: use Utilities.Streams.readSystemDimension instead.
• Modelica_LinearSystems2.Internal.Streams.ReadSystemDimension2: use Utilities.Streams.readSystemDimension instead.
• Modelica_LinearSystems2.Math.Polynomial.degree2: use Polynomial.degree instead.

Removed deprecated classes

The following classes were removed from the Library because their counterparts exist in the Modelica Standard Library. A conversion script is provided to facilitate the conversion.

• Operator record Modelica_LinearSystems2.Math.Complex, see above.

• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgecon
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgees
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgeev_eigenValues
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgeevx
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgehrd
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgelsx
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgeqp3
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgesdd
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgesvd
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgesvx
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dggev
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dggevx
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dhgeqz
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dlange
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dorghr
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dorgqr
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dormhr
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dormqr
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dpotrf
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dtrevc
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dtrsen
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dtrsm
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dtrsyl
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgeev
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgegv
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgeqrf
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dgetrs
• Modelica_LinearSystems2.Math.Matrices.LAPACK.dhseqr
• Modelica_LinearSystems2.Math.Matrices.cholesky
• Modelica_LinearSystems2.Math.Matrices.conditionNumber
• Modelica_LinearSystems2.Math.Matrices.det
• Modelica_LinearSystems2.Math.Matrices.fliplr
• Modelica_LinearSystems2.Math.Matrices.flipud
• Modelica_LinearSystems2.Math.Matrices.hessenberg
• Modelica_LinearSystems2.Math.Matrices.leastSquares
• Modelica_LinearSystems2.Math.Matrices.leastSquares2
• Modelica_LinearSystems2.Math.Matrices.equalityLeastSquares
• Modelica_LinearSystems2.Math.Matrices.LU
• Modelica_LinearSystems2.Math.Matrices.LU_solve
• Modelica_LinearSystems2.Math.Matrices.LU_solve2
• Modelica_LinearSystems2.Math.Matrices.toUpperHessenberg
• Modelica_LinearSystems2.Math.Matrices.norm
• Modelica_LinearSystems2.Math.Matrices.nullspace
• Modelica_LinearSystems2.Math.Matrices.printMatrix
• Modelica_LinearSystems2.Math.Matrices.rcond
• Modelica_LinearSystems2.Math.Matrices.rsf2
• Modelica_LinearSystems2.Math.Matrices.solve
• Modelica_LinearSystems2.Math.Matrices.solve2
• Modelica_LinearSystems2.Math.Matrices.trace
• Modelica_LinearSystems2.Math.Matrices.Internal.readMatrixGain
• Modelica_LinearSystems2.Math.Matrices.Internal.dgeqp3_workdim
• Modelica_LinearSystems2.Math.Matrices.Internal.dgeqrf_workdim
• Modelica_LinearSystems2.Math.Matrices.Internal.dhseqr_workdim
• Modelica_LinearSystems2.Math.Matrices.Internal.QR
• Modelica_LinearSystems2.Math.Matrices.Internal.QR2

• Modelica_LinearSystems2.Math.Vectors.find
• Modelica_LinearSystems2.Math.Vectors.length
• Modelica_LinearSystems2.Math.Vectors.printVector

• Modelica_LinearSystems2.StateSpace.Internal.readSystemDimension
• Modelica_LinearSystems2.Internal.Streams.readMatrixInternal
• Modelica_LinearSystems2.Internal.Streams.readMatrixOnFileSize
• Modelica_LinearSystems2.Internal.from_Hz
• Modelica_LinearSystems2.Internal.to_Hz