geodata.Cutout.pv
=================

.. py:method:: geodata.Cutout.pv(panel: Union[str, dict], orientation: Union[str, dict, callable], clearsky_model: Optional[str] = None, **params)

   Convert downward-shortwave, upward-shortwave radiation flux and
   ambient temperature into a pv generation time-series.

   :param panel: Panel name known to the reatlas client or a panel config
                 dictionary with the parameters for the electrical model in [3].
   :type panel: Union[str, dict]
   :param orientation: Panel orientation can be chosen from either
                       'latitude_optimal', a constant orientation {'slope': 0.0,
                       'azimuth': 0.0} or a callback function with the same signature
                       as the callbacks generated by the
                       `geodata.pv.orientation.make_*` functions.
   :type orientation: Union[str, dict, callback]
   :param clearsky_model: Either the 'simple' or the 'enhanced' Reindl clearsky
                          model. The default choice of None will choose dependending on
                          data availability, since the 'enhanced' model also
                          incorporates ambient air temperature and relative humidity.
   :type clearsky_model: Optional[str]

   :returns: Time-series or capacity factors based on additional general
             conversion arguments.
   :rtype: xr.DataArray

   .. note::

      You can also specify all of the general conversion arguments
      documented in the `convert_cutout` function.

   .. rubric:: References

   [1] Soteris A. Kalogirou. Solar Energy Engineering: Processes and Systems,
   pages 49-117,469-516. Academic Press, 2009. ISBN 0123745012.
   [2] D.T. Reindl, W.A. Beckman, and J.A. Duffie. Diffuse fraction correla-
   tions. Solar Energy, 45(1):1 - 7, 1990.
   [3] Hans Georg Beyer, Gerd Heilscher and Stefan Bofinger. A Robust Model
   for the MPP Performance of Different Types of PV-Modules Applied for
   the Performance Check of Grid Connected Systems, Freiburg, June 2004.
   Eurosun (ISES Europe Solar Congress).