MBL Version 5.0

Modelon Library 5.0 is part of Modelon���s 2025.May release.

New Features

Simplified three-phase AC (Modelon.Electrical.AC)

  • The package Modelon.Electrical.AC now use a single representation for three-phase AC. This means that it is no longer necessary to choose between "DQO" or "ABC" (the ABC package is deprecated). Note that outputs can still be obtained per-phase ("ABC") using sensors.
  • Introduced support for balanced three-phase AC. This corresponds to a dq-representation, which is more robust and easy to use than the more general dq0-representation.
    • This is now the default representation, which can be changed (from dq0 to dq0) with the advanced parameter zero_sequence. Note that all connected models need to use the same representation.

Improved Compressors and Turbines (Modelon.ThermoFluid)

  • Significant improvements have been made to the structure and parameterization of compressor and turbine models to enhance the overall user experience. Key enhancements include:
    1. All map-based parameterization has been moved to an external Excel file, allowing easier and more transparent data entry using named ranges.
    2. New, more explicit compressor and turbine variants have been introduced to simplify model configuration and reduce setup time.
    3. The package structure has been reorganized for better clarity. User-relevant components are now more accessible, while lower-level utility classes have been moved to BaseClasses.
  • New compressor variants:
    PositiveDisplacement_FixedEfficiency
    PositiveDisplacement_FixedVolume
    PositiveDisplacement_VariableVolume
    Dynamic_FlowfromPR
    Dynamic_FlowfromPRandBeta
    Dynamic_PRfromFlow
    Dynamic_PRfromFlow_SAE
  • New turbine variants:
    Turbine_FlowfromPR
  • Note: The previous compressor and turbine implementations has been moved to the Deprecated package. Users are strongly encouraged to manually migrate to the latest compressor and turbine versions in Modelon.ThermoFluid.Compressors and Modelon.ThermoFluid.Turbines to benefit from improved usability and future maintenance support.

Heat transfer correlations (Modelon.ThermoFluid)

  • New Chevron angles support in SinglePhasePlateHX correlation.
  • Added a correlation that allow giving a constant heat transfer coefficient per fluid phase region (liquid, two-phase region & vapor) in CoefficientsPerPhase.  This correlation also replaces the ConstantCoefficient and TwoConstantCoefficients, which are removed. Uses of these are automatically converted to the new correlation.

New source and flow modifier components (Modelon.ThermoFluid)

  • Experimental source and flow modifier components are added. These aim to improve the usability for setting properties of sources, sinks, and flow modifiers. They exist alongside the classic implementations and may change in the future.

Modelon.ThermoFluid, other

  • Added records for computing geometrical measures of different types of heat exchanger channels in a way that scales with size, to support new HX parameterization method of heat exchangers. The records are available in the package ChannelType correlation.

Modelon.Utilities.Strings

  • added function to decode ASCII characters from Integer representation to Strings
  • added functions toUpper()/toLower() to convert letters to/from upper-case
  • added function to extract the basename of a component from its Modelica path

Improvements

Modelon.Media

  • Improved robustness of all liquid media models by holding transport properties constant when extrapolating outside the validity range of the properties model. Previously polynomials were extrapolated without limit, which could lead to un-physical or unreasonable values when temperature was far outside the valid region. This applies to viscosity and thermal conductivity

Modelon.Thermofluid

  • Improved description strings and information for all correlations
  • Improved parameter dialog of all correlations, removing unused parameters and integrating information of validity range directly in the dialog.
  • Improved robustness for the pressure loss correlation for plate heat exchangers by Focke, et.al. by applying smooth transition between expressions for different Reynolds number ranges, and applying linear approximation around zero flow rate.
  • Heat exchanger interface classes: Removed Dialog annotation from fluid connectors, to allow them to disappear from parameter dialogs after redeclaring.
  • In the evaporation correlation by Kandlikar, the fluid dependent parameter F_Fl was previously not set depending on fluid, as it should according to the reference publication. If the correlation is used together with R-22 or Nitrogen, specified values will now be used. For other fluids, the parameter must be manually set and an assert will prevent the simulation from starting without setting a value. Note: Set F_Fl = 1 to preserve results from earlier versions.
  • The SinglePhase heat transfer correlation (predictive in single phase regions, inaccurate in two-phase region) has been removed. As replacement it is advised to use the SimpleTwoPhase correlation. This is identical in the single phase regions, and takes a user-defined heat transfer coefficient in the two-phase region.
  • Enhanced the Pump tableFlow characteristic model to support analytic Jacobians. Users may observe minor result deviations due to improved interpolation and extrapolation methods.

Conversion of User Libraries

User libraries will automatically be converted to version 5.0. These conversions are made using the included conversion script: Modelon/Resources/Scripts/Convert_to_5.0.mos.

Back to top