Version 2.11

Vapor Cycle Library 2.11 is part of Modelon's 2023.2 release. New versions of Modelon's libraries are sold and distributed directly from Modelon, as well as approved resellers.

Version 2.11 contains the changes described below.

Build 1 (2023-06-21)

New features

  • Expanded the capability of Spline-based Table-lookup (SBTL) medium for psuedo-pure fluids. Both pure and psuedo-pure fluids now share the same medium package templates and use the same template for equations of state, Modelon.Media.EquationsOfState.Templates.TwoPhase.SplineBased. More examples of psuedo-pure fluids will be included in the libray in future releases. Please contact Modelon for early access to them before the next release.

    In order to make the template compatible with both pure and psuedo-pure fluids, saturation temperature in SBTL medium data file (Coeff1D.mat) is renamed from "Ts" to "Ts_v" and "Ts_l" to handle the potentially distinct saturation lines. Users of pure fluids from the library should expect no change in behavior due to the renaming. However, users with customized or self-created SBTL media need to perform the renaming of the data for pure fluids. The tables "Ts", "Ts_aux" and "Ts_Meta" in the data (Coeff1D.mat file) need to be renamed as "Ts_v", "Ts_v_aux" and "Ts_v_Meta". Then duplicate the three tables as "Ts_l", "Ts_l_aux" and "Ts_l_Meta". Please contact Modelon for problems updating the data file.

  • Characterization of variable speed, positive displacement compressor using look-up tables from standard ASHRAE test data (i.e., power [W], capacity [W], and mass flow rate [kg/s] as a function of condensing and evaporation temperature [K] and speed [rps]).
  • Added an example of filling of an ampient temperature tank with cryogenic liquid hydrogen, representing the tank wall temperature dynamics and profile from bottom to top. The example model is avaialble at VaporCycle.Experiments.CryogenicH2.TankFillingVerticalCylinder
  • Added models for cyogenic hydrogen tank sizing computations with relatively simple models in the package VaporCycle.Experiments.CryogenicH2.TankSizing.
  • Added an example for a residential Heat Pump system experiment with R-32 as refrigerant and air as the secondary side fluid in both condenser and evaporator.

New classes

  • FixedDisplacementTableBased_ASHRAE
  • TablesAtFixedDisplacement_ASHRAE
  • Air_to_Air_HeatPump
  • R744SBTL
  • R744SBTL_ExtendedRange


  • Compressor functions VaporCycle.Compressors.Characteristics.VolumetricEfficiency and VaporCycle.Compressors.Characteristics.IsentropicCompressorEfficiency have had derivative functions added to them.
  • Assertions were added to Medium properties for state variables to be within package limits to improve initializatoin robustness. By default, the assertion level is ERROR, but for PbS it is overridden as WARNING. When not using PbS, this can be changed with the inner Settings_TF block using the parameter limitsAction
  • For the VaporCycle.Experiments.HeatPumpSteadyState examples, the documentation has updated and includes predefined Experiments and Views.

Fixed issues

  • In the suction line heat exchanger one error was corrected in the thermal resistnace between capillary and suction line.