geodata.convert.convert_cutout
==============================

.. py:function:: geodata.convert.convert_cutout(cutout, convert_func, show_progress=False, **convert_kwds)

   Convert and aggregate a weather-based renewable generation time-series.

   NOTE: Not meant to be used by the user him or herself. Rather it is a
   gateway function that is called by all the individual time-series
   generation functions like pv and wind. Thus, all its parameters are also
   available from these.

   Parameters (passed through as **params)
   ---------------------------------------
   show_progress : boolean|string
           Whether to show a progress bar if boolean and its label if given as a
           string (defaults to True).

   :returns: * **resource** (*xr.DataArray*) -- Time-series of renewable generation aggregated to buses, if
               `matrix` or equivalents are provided else the total sum of
               generated energy.
             * *Internal Parameters (provided by f.ex. wind and pv)*
             * *---------------------------------------------------*
             * **convert_func** (*Function*) -- Callback like convert_wind, convert_pv