pvdeg.temperature.temperature#

pvdeg.temperature.temperature(weather_df, meta, poa=None, temp_model='sapm', cell_or_mod=None, conf='open_rack_glass_polymer', wind_factor=0.33, irradiance_kwarg={}, model_kwarg={})[source]#

Calculate the PV cell or module temperature using PVLIB.

Current supports the following temperature models:

Parameters:
  • cell_or_mod ((str)) – choose to calculate the cell or module temperature. Use cell_or_mod == 'mod' or 'module' for module temp calculation. cell_or_mod == 'cell' for cell temp calculation.

  • weather_df ((pd.dataframe)) – Data Frame with minimum requirements of ‘temp_air’ and ‘wind_speed’

  • meta ((dict)) – Weather meta-data dictionary (location info)

  • poa ((dataframe or series, optional)) – Dataframe or series with minimum requirement of ‘poa_global’. Will be calculated rom weather_df, meta if not provided

  • temp_model ((str, optional)) –

    Specify which temperature model from pvlib to use. Current options:

    sapm_cell,``sapm_module``,``pvsyst_cell``,``faiman``,``faiman_rad``, ross,``noct_sam``, fuentes, generic_linear

  • conf ((str)) –

    The configuration of the PV module architecture and mounting configuration. Currently only used for ‘sapm’ and ‘pvsys’. With different options for each.

    ’sapm’ options: open_rack_glass_polymer (default), open_rack_glass_glass, close_mount_glass_glass, insulated_back_glass_polymer

    ’pvsys’ options: freestanding, insulated

  • wind_factor (float, optional) – Wind speed correction exponent to account for different wind speed measurement heights between weather database (e.g. NSRDB) and the tempeature model (e.g. SAPM). The NSRDB provides calculations at 2 m (i.e module height) but SAPM uses a 10m height. It is recommended that a power-law relationship between height and wind speed of 0.33 be used*. This results in a wind speed that is 1.7 times higher. It is acknowledged that this can vary significantly.

  • irradiance_kwarg ((dict, optional)) – keyword argument dictionary used for the poa irradiance caluation. options: sol_position, tilt, azimuth, sky_model. See pvdeg.spectral.poa_irradiance.

  • model_kwarg ((dict, optional)) – keyword argument dictionary used for the pvlib temperature model calculation. See https://pvlib-python.readthedocs.io/en/stable/reference/pv_modeling/temperature.html # noqa for more.

Returns:

temp_cell (pandas.DataFrame) – This is the temperature of the cell in a module at every time step.[°C]

References

R. Rabbani, M. Zeeshan, “Exploring the suitability of MERRA-2 reanalysis data for wind energy estimation, analysis of wind characteristics and energy potential assessment for selected sites in Pakistan”, Renewable Energy 154 (2020) 1240-1251.