diff --git a/CHANGELOG.md b/CHANGELOG.md index d4f9cc44..9e2a559f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,13 +9,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Added +### Changed + +### Fixed + +## MML-v3.4.0 + +### Added + - Added a version number in root `package.mo`, to allow appropriate versioning in models, using `uses(MetroscopeModelingLibrary(version="3.1.0"))` annotation. [PR#364](https://github.com/Metroscope-dev/metroscope-modeling-library/pull/364) - Added `MPa` and `kPa` pressure units in pressure sensors [PR#362](https://github.com/Metroscope-dev/metroscope-modeling-library/pull/362), fixing [#361](https://github.com/Metroscope-dev/metroscope-modeling-library/issues/361) ### Changed - Updated leak model so they use inheritance [PR#373](https://github.com/Metroscope-dev/metroscope-modeling-library/pull/373) -- Abstract sensors connectors are renamed `C_in` and `C_out` [PR#372](https://github.com/Metroscope-dev/metroscope-modeling-library/pull/372) +- Abstract sensors connectors are renamed `C_in` and `C_out`, breaking change for topological models [PR#372](https://github.com/Metroscope-dev/metroscope-modeling-library/pull/372) - Changed default unused value for enthalpy in opposite flow direction to 1e6 [PR#374](https://github.com/Metroscope-dev/metroscope-modeling-library/pull/374) - [PR#368](https://github.com/Metroscope-dev/metroscope-modeling-library/pull/368) the `fouling` fault in `Pipe` and `closed` fault in `SlideVale` are changed to percentage. The values given to those faults should be a percentage (%) and not a value less than 1 as before. Therefore, it is a breaking change for faulty models in prevous versions. - [PR#377](https://github.com/Metroscope-dev/metroscope-modeling-library/pull/377) the `DP` in the `CombustionChamber` model is replaced by a `Kfr` by adding a pipe. This is a breaking change for models using previous versions. diff --git a/MetroscopeModelingLibrary/package.mo b/MetroscopeModelingLibrary/package.mo index 108bc500..62ad2cf8 100644 --- a/MetroscopeModelingLibrary/package.mo +++ b/MetroscopeModelingLibrary/package.mo @@ -2,7 +2,7 @@ package MetroscopeModelingLibrary - annotation (version="3.3.1",uses(Modelica(version="4.0.0")), + annotation (version="3.4.0",uses(Modelica(version="4.0.0")), Icon(coordinateSystem(preserveAspectRatio=true, extent={{-100.0,-100.0},{100.0,100.0}}), graphics={Bitmap(extent={{-286,-12},{-286,-12}}, fileName=""), Bitmap( extent={{-72,-74},{70,74}}, imageSource="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"