==================
Storage
==================

.. note::

   Since storage power values are given in the consumer system, positive power models charging and negative power models discharging.

.. seealso::
    :ref:`Unit Systems and Conventions <conventions>`

Create Function
=====================

.. autofunction:: pandapower.create.create_storage

Input Parameters
=====================

*net.storage*

.. tabularcolumns:: |p{0.10\linewidth}|p{0.10\linewidth}|p{0.25\linewidth}|p{0.40\linewidth}|
.. csv-table::
   :file: storage_par.csv
   :delim: ;
   :widths: 10, 10, 25, 40

.. |br| raw:: html

   <br />

\*necessary for executing a power flow calculation |br| \*\*optimal power flow parameter


Electric Model
=================

Storages are modelled as PQ-buses in the power flow calculation:

.. image:: storage.png
	:width: 8em
	:alt: alternate Text
	:align: center

The PQ-Values are calculated from the parameter table values as:

.. math::
   :nowrap:

   \begin{align*}
    P_{storage} &= p\_mw \cdot scaling \\
    Q_{storage} &= q\_mvar \cdot scaling \\
    \end{align*}

.. note::

    The apparent power value sn_mva, state of charge soc and storage capacity max_e_mwh are provided as additional information for usage in controller or other applications based on pandapower. It is not considered in the power flow!

Result Parameters
==========================
*net.res_storage*

.. tabularcolumns:: |p{0.10\linewidth}|p{0.10\linewidth}|p{0.50\linewidth}|
.. csv-table::
   :file: storage_res.csv
   :delim: ;
   :widths: 10, 10, 50

The power values in the net.res_storage table are equivalent to :math:`P_{storage}` and :math:`Q_{storage}`.