From 56b92d17e3381fa9c65979903c31c8b79822eb16 Mon Sep 17 00:00:00 2001 From: Antoine Gautier Date: Mon, 9 Jun 2025 11:27:39 +0200 Subject: [PATCH 1/2] Fix typos --- .../HeatPumps/ModularReversible/UsersGuide.mo | 25 ++++++++++--------- 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/IBPSA/Fluid/HeatPumps/ModularReversible/UsersGuide.mo b/IBPSA/Fluid/HeatPumps/ModularReversible/UsersGuide.mo index 187a9b2e8f..0b380da7e6 100644 --- a/IBPSA/Fluid/HeatPumps/ModularReversible/UsersGuide.mo +++ b/IBPSA/Fluid/HeatPumps/ModularReversible/UsersGuide.mo @@ -17,10 +17,10 @@ package UsersGuide based on available variables of the sink and source streams. Thus, this model does not enable closed-loop simulations of the refrigerant cycle. However, such models are - highly demanding in terms computation time, and commercial implementations exist. + highly demanding in terms of computation time, and commercial implementations exist. When simulating the refrigerant machine in a more complex energy system, this modular approach enables detailed performance and - dynamic behaviour and fast computating times. + dynamic behaviour and fast computation times.

This user guide will help understand how to use the models associated @@ -40,7 +40,8 @@ package UsersGuide They may be on/off and inverter driven;

  • - They are able reverse the operation between heating to cooling; + They are able to reverse the operation between heating and cooling, + and some systems even provide simultaneous heating and cooling capabilities;
  • They operate in a limited characteristic range (operational envelope); @@ -53,7 +54,7 @@ package UsersGuide

    • - To what extend all these effects need to be modeled depends + To what extent all these effects need to be modeled depends on the simulation aim. Sometimes a simple Carnot approach is sufficient, sometimes a more detailed performance data and a realistic control behaviour is required. @@ -78,7 +79,7 @@ package UsersGuide detailed documentation of each model for further information.

    - All modular heat pump or chiller models base on the model + All modular heat pump or chiller models are based on the model IBPSA.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.BaseClasses.PartialHeatPumpCycle. This partial model declares all common interfaces, parameters, etc. @@ -217,7 +218,7 @@ when adding new datasheets. Thinking about the heated and cooled fluid helps.

    -The following tables summarizes the possible options. +The following table summarizes the possible options.

    @@ -332,7 +333,7 @@ The following tables summarizes the possible options. IBPSA.Fluid.Chillers.ModularReversible.RefrigerantCycle.BaseClasses.PartialChillerCycle.

    - Currently, two modules for refrigerant cycle are implemented. + Currently, two modules for the refrigerant cycle are implemented. First, the IBPSA.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.ConstantCarnotEffectiveness model uses the same equations as the Carnot models, i.e. @@ -349,7 +350,7 @@ The following tables summarizes the possible options. the Modelica Standard Library. The first approach is similar to IBPSA.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.TableData2D - approach buts adds the 3rd dimension of compressor speed. + approach but adds the 3rd dimension of compressor speed. The second approach is based on white-box stationary Python models for closed-loop refrigerant cycles. The model has been empirically validated and can take up to n-dimensions. @@ -363,7 +364,7 @@ The following tables summarizes the possible options. The refrigerant cycle models will output varying heat flow rates and electrical power consumptions. This is based on the fact that refrigerant cycle performance - depend heavily on the boundary conditions. + depends heavily on the boundary conditions.

    Still, the user needs to size the device or the system @@ -403,7 +404,7 @@ The following tables summarizes the possible options. If the performance data is dependent on the compressor speed, y_nominal influences the nominal efficiencies. In such cases, specifying additional nominal parameters will - be nessary. + be necessary.

    Using the nominal conditions and the specified heat flow rate, @@ -479,7 +480,7 @@ The following tables summarizes the possible options. IBPSA.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.Inertias.BaseClasses.PartialInertia - can be extended to implement a costum model. + can be extended to implement a custom model.

    @@ -530,7 +531,7 @@ The following tables summarizes the possible options. Depending on the application, one may need to model the heat losses to the ambient, as those may impact the overall efficiency of the heat pump or chiller. - Thus, the heat exchangers in the models adds + Thus, the heat exchangers in the models add thermal capacities to the adiabatic heat exchanger. The parameterization may be challenging, as datasheets do not contain parameters for the required values. From a55bca251fef3bbbd668ca708628847f82380341 Mon Sep 17 00:00:00 2001 From: Antoine Gautier Date: Mon, 9 Jun 2025 14:54:07 +0200 Subject: [PATCH 2/2] Add description of new models from MBL --- .../HeatPumps/ModularReversible/UsersGuide.mo | 55 ++++++++++++++++++- 1 file changed, 52 insertions(+), 3 deletions(-) diff --git a/IBPSA/Fluid/HeatPumps/ModularReversible/UsersGuide.mo b/IBPSA/Fluid/HeatPumps/ModularReversible/UsersGuide.mo index 0b380da7e6..f08e274340 100644 --- a/IBPSA/Fluid/HeatPumps/ModularReversible/UsersGuide.mo +++ b/IBPSA/Fluid/HeatPumps/ModularReversible/UsersGuide.mo @@ -115,6 +115,14 @@ to the section Refrigerant cycle models. to check if this approach is suitable.