classVersion_3_0_0

Version 3.0.0 (June 21, 2024)

Extends from Modelica.Icons.ReleaseNotes (Icon for release notes in documentation).

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.

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