From d0cfa19e42fd38b0fa275df522be83fff3ed4e89 Mon Sep 17 00:00:00 2001 From: Michael Wetter Date: Wed, 20 Sep 2023 17:37:08 -0700 Subject: [PATCH 01/19] Issue3512 improve docu steam (#3521) (#3523) * Issue3512 improve docu steam (#3521) * Added steam DH publication references * Added references to instantiable models and top-level example model * Revert accidential block movement * Removed trailing white space --------- Co-authored-by: Katy Hinkelman <44682485+khinkelman@users.noreply.github.com> --- .../DHC/Examples/Steam/SingleBoiler.mo | 25 ++++++++- .../BaseClasses/ControlVolumeCondensation.mo | 27 ++++++--- .../DHC/Loads/Steam/BaseClasses/SteamTrap.mo | 35 +++++++++--- .../Steam/BaseClasses/ValveSelfActing.mo | 47 +++++++++++----- .../Loads/Steam/BuildingTimeSeriesAtETS.mo | 43 +++++++++++---- .../Steam/ConnectionCondensatePipe.mo | 37 ++++++++----- .../Steam/DistributionCondensatePipe.mo | 39 ++++++++----- .../Steam/BaseClasses/BoilerPolynomial.mo | 55 +++++++++++-------- .../BaseClasses/ControlVolumeEvaporation.mo | 31 +++++++---- .../DHC/Plants/Steam/SingleBoiler.mo | 35 +++++++++--- 10 files changed, 262 insertions(+), 112 deletions(-) diff --git a/Buildings/Experimental/DHC/Examples/Steam/SingleBoiler.mo b/Buildings/Experimental/DHC/Examples/Steam/SingleBoiler.mo index 696aa229eac..1d1016eda05 100644 --- a/Buildings/Experimental/DHC/Examples/Steam/SingleBoiler.mo +++ b/Buildings/Experimental/DHC/Examples/Steam/SingleBoiler.mo @@ -1,5 +1,5 @@ within Buildings.Experimental.DHC.Examples.Steam; -model SingleBoiler "Example model for a complete steam district heating system with a +model SingleBoiler "Example model for a complete steam district heating system with a central plant that contains a single boiler" extends Modelica.Icons.Example; @@ -101,16 +101,35 @@ equation Documentation(revisions=" ", info="

-This example model demonstrates a complete system simulation for +This example model demonstrates a complete system simulation for steam district heating systems. The central plant features a single boiler. -For the distribution network, pressure losses on the condensate return +For the distribution network, pressure losses on the condensate return pipes are included, while the steam pipes are assumed to be lossless.

+

References

+

+Kathryn Hinkelman, Saranya Anbarasu, Michael Wetter, Antoine Gautier, Wangda Zuo. 2022. +“A Fast and Accurate Modeling Approach for Water and Steam +Thermodynamics with Practical Applications in District Heating System Simulation,” +Energy, 254(A), pp. 124227. +10.1016/j.energy.2022.124227 +

+

+Kathryn Hinkelman, Saranya Anbarasu, Michael Wetter, Antoine Gautier, Baptiste Ravache, Wangda Zuo 2022. +“Towards Open-Source Modelica Models For Steam-Based District Heating Systems.” +Proc. of the 1st International Workshop On Open Source Modelling And Simulation Of +Energy Systems (OSMSES 2022), Aachen, German, April 4-5, 2022. +10.1109/OSMSES54027.2022.9769121 +

")); end SingleBoiler; diff --git a/Buildings/Experimental/DHC/Loads/Steam/BaseClasses/ControlVolumeCondensation.mo b/Buildings/Experimental/DHC/Loads/Steam/BaseClasses/ControlVolumeCondensation.mo index 12b83381eaf..311d047ac8c 100644 --- a/Buildings/Experimental/DHC/Loads/Steam/BaseClasses/ControlVolumeCondensation.mo +++ b/Buildings/Experimental/DHC/Loads/Steam/BaseClasses/ControlVolumeCondensation.mo @@ -27,26 +27,37 @@ annotation (defaultComponentName="vol", Documentation(revisions=" ", info="

-This model represents a condensation process of water with +This model represents a condensation process of water with liquid and vapor phases in equilibrium and at a saturated state. Further information regarding the model formulation and assumptions -are in the base class +are in the base class Buildings.Experimental.DHC.BaseClasses.Steam.PartialSaturatedControlVolume. -

Reference

+

References

+

+Kathryn Hinkelman, Saranya Anbarasu, Michael Wetter, Antoine Gautier, Wangda Zuo. 2022. +“A Fast and Accurate Modeling Approach for Water and Steam +Thermodynamics with Practical Applications in District Heating System Simulation,” +Energy, 254(A), pp. 124227. +10.1016/j.energy.2022.124227 +

-Hinkelman, Kathryn, Saranya Anbarasu, Michael Wetter, -Antoine Gautier, and Wangda Zuo. 2022. “A Fast and Accurate Modeling -Approach for Water and Steam Thermodynamics with Practical -Applications in District Heating System Simulation.” Preprint. February 24. -doi:10.13140/RG.2.2.20710.29762. +Kathryn Hinkelman, Saranya Anbarasu, Michael Wetter, Antoine Gautier, Baptiste Ravache, Wangda Zuo 2022. +“Towards Open-Source Modelica Models For Steam-Based District Heating Systems.” +Proc. of the 1st International Workshop On Open Source Modelling And Simulation Of +Energy Systems (OSMSES 2022), Aachen, German, April 4-5, 2022. +10.1109/OSMSES54027.2022.9769121

")); end ControlVolumeCondensation; diff --git a/Buildings/Experimental/DHC/Loads/Steam/BaseClasses/SteamTrap.mo b/Buildings/Experimental/DHC/Loads/Steam/BaseClasses/SteamTrap.mo index db9e3f4f9d3..9e867621b63 100644 --- a/Buildings/Experimental/DHC/Loads/Steam/BaseClasses/SteamTrap.mo +++ b/Buildings/Experimental/DHC/Loads/Steam/BaseClasses/SteamTrap.mo @@ -1,6 +1,6 @@ within Buildings.Experimental.DHC.Loads.Steam.BaseClasses; -model SteamTrap "Steam trap with isenthalpic expansion from high to atmospheric - pressure, followed by a isobaric condensation process as flashed steam +model SteamTrap "Steam trap with isenthalpic expansion from high to atmospheric + pressure, followed by a isobaric condensation process as flashed steam is brought back to a liquid state" extends Buildings.Fluid.Interfaces.PartialTwoPortInterface( redeclare replaceable package Medium=Buildings.Media.Water); @@ -62,18 +62,37 @@ equation Diagram(coordinateSystem(preserveAspectRatio=false)), Documentation(info="

-The steam trap ensures that only liquid condensate leaves +The steam trap ensures that only liquid condensate leaves the component, while any flashed steam is returned to a liquid -state before discharge. The model assumes a steady state isenthalpic -thermodynamic process that transforms water from an upstream -high pressure state to atmospheric pressure, followed by an -isobaric condensation process as flashed steam vapor is returned to -a liquid state. This implementation is consistent with +state before discharge. The model assumes a steady state isenthalpic +thermodynamic process that transforms water from an upstream +high pressure state to atmospheric pressure, followed by an +isobaric condensation process as flashed steam vapor is returned to +a liquid state. This implementation is consistent with physical valves that vent to the atmosphere.

+

References

+

+Kathryn Hinkelman, Saranya Anbarasu, Michael Wetter, Antoine Gautier, Wangda Zuo. 2022. +“A Fast and Accurate Modeling Approach for Water and Steam +Thermodynamics with Practical Applications in District Heating System Simulation,” +Energy, 254(A), pp. 124227. +10.1016/j.energy.2022.124227 +

+

+Kathryn Hinkelman, Saranya Anbarasu, Michael Wetter, Antoine Gautier, Baptiste Ravache, Wangda Zuo 2022. +“Towards Open-Source Modelica Models For Steam-Based District Heating Systems.” +Proc. of the 1st International Workshop On Open Source Modelling And Simulation Of +Energy Systems (OSMSES 2022), Aachen, German, April 4-5, 2022. +10.1109/OSMSES54027.2022.9769121 +

", revisions="