carbatpy.models.coupled.orc_simple_v2
=====================================

.. py:module:: carbatpy.models.coupled.orc_simple_v2

.. autoapi-nested-parse::

   Created on Sun May 21 10:52:09 2023

   @author: atakan



Attributes
----------

.. autoapisummary::

   carbatpy.models.coupled.orc_simple_v2.FLUID


Classes
-------

.. autoapisummary::

   carbatpy.models.coupled.orc_simple_v2.OrganicRankineCycle


Module Contents
---------------

.. py:class:: OrganicRankineCycle(fluids, fixed_points, components=[])

   Heat pump class for simple thermodynamic calculations for energy storage

   Two pairwase storages at two different temperatures are assumed,
   always starting at room temperature (around 300K). Thus, three fluids are
   expected: the working fluid, the storage fluid  or sink at high temperature
   (h) and the source storage fluid at low temperature.
   The minimum and maximum temperatures of all
   storags are fixed and the heat flow rate to the high-T storage are
   given. Also, isentropic efficiencies are fixed so far, but they should use
   a function later.

   Heat pump class for simple thermodynamic calculations for energy storage

   storages at two different temperatures, always starting at room
   temperature (around 300K). The minimum and maximum temperatures aof all
   storags are fixed and the heat flow rate to the high-T storage are
   given. Also, isentropic efficiencies. The COP_charging is important
   to reach a steady state. At the moment you will have to look it up from
   the heat pump calculation. It is used to divide the energy transfered to
   the envoronment and to the low temperature storage.

   Example for ``fixed_points``:

   .. code-block:: python

   fixed_points = {"eta_s": _ETA_S_,  # expander
                   "eta_s_p": _ETA_S_P_,  # pump
                   "p_low": p_low,
                   "p_high": p_high,
                   "T_hh": _STORAGE_T_IN_,
                   "h_h_out_sec": state_sec_out[2],
                   "h_h_out_w": state_out_evap[2],
                   "h_l_out_cold": state_cold_out[2],
                   "h_l_out_w": state_out_cond[2],
                   "h_env_in": state_env_in[2],
                   "h_env_out": state_env_out[2],
                   "T_hl": _STORAGE_T_OUT_,
                   "T_lh": _COLD_STORAGE_T_OUT_,
                   "T_ll": _COLD_STORAGE_T_IN_,  # 256.0,
                   "Q_dot_h": _Q_DOT_MIN_,
                   "d_temp_min": _D_T_MIN_,
                   "cop_charging": _COP_CHARGING  # needed to calculate Q_env_discharging
                   }

   :param fluids: working fluid, secondary fluid to store at high T, cold fluid
                  to store at low T.
   :type fluids: list of three Fluid
   :param fixed_points: all the fixed points are summarized here, the isentropic efficiency,
                        the lower pressure(evaporator), the high and low temperatures of
                        the high temperature storages, the same for the low temperature
                        storages(source), the heat to be transfered at high T, the minimum
                        approach temperature.
   :type fixed_points: Dictionary
   :param components: DESCRIPTION. The default is [].
   :type components: TYPE, optional

   :rtype: None.


   .. py:attribute:: components
      :value: []



   .. py:attribute:: fixed_points


   .. py:attribute:: fluids


   .. py:attribute:: all_states
      :value: []



   .. py:attribute:: m_dots
      :value: []



   .. py:attribute:: evaluation


   .. py:attribute:: warning
      :value: []



   .. py:method:: calc_orc(verbose=False)

      calculate a simple organic rankine cycle (ORC)

      working with two sensible storages (or source and sink). At the moment
      the machine model is just for a constant isentropic efficiency.
      The initial states are provided
      by the Fluid-instances. The pressures have to be selected carefully,
      they are not tested at the moment.
      For optimization, the pressure levels of the cycle could be used within
      a second script. Several parameters are fixed
      along a calculation, this is in the dictionary "self.fixed_points".


      :param verbose: should values be printed? The deault is False
      :type verbose: Boolean, optional

      :returns: **eta_orc** -- thermal efficiency of ORC.
      :rtype: flaot



   .. py:method:: hp_plot(f_name=_RESULTS_ + '\\last_T_H_dot_plot_orc', fig_ax=[])

      plots the heat pump cycle and stores it to the given file (name)


      :param f_name: where to write the results and the plot.
      :type f_name: string, optional
      :param fig_ax: instances with figure and axes to plot into. If Empty a new one will
                     be generated. default =[]
      :type fig_ax: list (length 2), optional

      :rtype: None.



.. py:data:: FLUID
   :value: 'Propane * Butane * Pentane * Hexane'