First draft for the CO2 Booster model tutorial

docs/advanced_tutorials.rst

@@ -41,7 +41,7 @@ you!
         .. image:: /_static/images/thumbnails/advanced_tutorials/heat_pump_starting_values_darkmode.svg
             :class: only-dark
 
-    .. grid-item-card::  Debug your models efficiently
+    .. grid-item-card::  Debug your model building
         :link: tutorial_debugging_label
         :link-type: ref
 
@@ -51,7 +51,7 @@ you!
         .. image:: /_static/images/thumbnails/advanced_tutorials/debugging_darkmode.svg
             :class: only-dark
 
-    .. grid-item-card::  Debugging the solution process
+    .. grid-item-card::  Debug the solution process
         :link: tutorial_advanced_debugging_label
         :link-type: ref
 
@@ -61,6 +61,16 @@ you!
         .. image:: /_static/images/tutorials/orc/flowsheet_darkmode.svg
             :class: only-dark
 
+    .. grid-item-card::  CO2 booster refrigeration machine
+        :link: tutorial_co2_refrigeration_label
+        :link-type: ref
+
+        .. image:: /_static/images/thumbnails/advanced_tutorials/co2_cycle.svg
+            :class: only-light
+
+        .. image:: /_static/images/thumbnails/advanced_tutorials/co2_cycle_darkmode.svg
+            :class: only-dark
+
     .. grid-item-card::  Make use of PowerConnection
         :link: tutorial_powerconnection_label
         :link-type: ref
@@ -109,6 +119,7 @@ you!
     advanced_tutorials/starting_values.rst
     advanced_tutorials/debugging.ipynb
     advanced_tutorials/advanced_debugging.ipynb
+    advanced_tutorials/co2_cycle.ipynb
     advanced_tutorials/powerconnections.rst
     advanced_tutorials/heat_pump_exergy.rst
     advanced_tutorials/humid_air.ipynb

docs/conf.py

@@ -527,3 +527,7 @@ def setup(app):
 # Notebook execution
 nb_execution_allow_errors = True
 nb_execution_in_temp = True
+nb_execution_timeout = 300
+# notebooks check this to shorten expensive cells; the kernel spawned by
+# myst-nb inherits the environment of the sphinx process
+os.environ["TESPY_DOCS_BUILD"] = "true"

docs/whats_new/v0-11-1.rst

@@ -23,6 +23,16 @@ Other Changes
   original and the reduced problem size becomes traceable
   (`PR #1034 <https://github.com/oemof/tespy/pull/1034>`__).
 
+Documentation
+#############
+- New advanced tutorial on a CO2 transcritical booster refrigeration system
+  of the kind used in supermarkets. The model is implemented on top of the
+  :py:class:`~tespy.models.template.ModelTemplate` class and demonstrates
+  log(p)-h and QT diagram plotting, a sensitivity analysis of the gas cooler
+  pressure and the optimization of the COP with pymoo. See the
+  :ref:`tutorial <tutorial_co2_refrigeration_label>` for details.
+
 Contributors
 ############
 - Francesco Witte (`@fwitte <https://github.com/fwitte>`__)
+- Francesco D'Ettorre (`@dk-teknologisk-FDE <https://github.com/dk-teknologisk-FDE>`__)