pvdeg.spectral.poa_irradiance#

pvdeg.spectral.poa_irradiance(weather_df: DataFrame, meta: dict, module_mount='fixed', sol_position=None, dni_extra=None, airmass=None, albedo=0.25, surface_type=None, sky_model='isotropic', model_perez='allsitescomposite1990', **kwargs_mount) → DataFrame[source]#

Calculate plane-of-array (POA) irradiance.

Calculate plane-of-array (POA) irradiance using pvlib.irradiance.get_total_irradiance for different module mounts

as fixed tilt systems or tracked systems.

Parameters:

  • weather_df (pd.DataFrame) – The file path to the NSRDB file.

  • meta (dict) – The geographical location ID in the NSRDB file.

  • module_mount (string) – Module mounting configuration. Can either be fixed for fixed tilt systems or single_axis for single-axis tracker systems.

  • sol_position (pd.DataFrame, optional) – pvlib.solarposition.get_solarposition Dataframe. If none is given, it will be calculated.

  • dni_extra (pd.Series, optional) – Extra-terrestrial direct normal irradiance. If None, it will be calculated.

  • airmass (pd.Series, optional) – Airmass values. If None, it will be calculated.

  • albedo (float, optional) – Ground reflectance. Default is 0.25.

  • surface_type (str, optional) – Type of surface for albedo calculation. If None, a default value will be used.

  • sky_model (str, optional) – Sky diffuse model to use. Default is isotropic. Options: ‘isotropic’, ‘klucher’, ‘haydavies’, ‘reindl’, ‘king’, ‘perez’.

  • model_perez (str, optional) – Perez model to use for diffuse irradiance. Default is allsitescomposite1990. Only used when sky_model is ‘perez’.

  • **kwargs_mount (dict) –

    Additional keyword arguments for the POA model based on mounting configuration. See poa_irradiance_fixed or poa_irradiance_tracker for details.

    • For module_mount=’fixed’:
      • surface_tiltfloat

        Tilt angle of the modules (degrees).

      • surface_azimuthfloat

        Azimuth angle of the modules (degrees).

    • For module_mount=’single_axis’:
      • axis_tiltfloat

        Tilt angle of the tracker axis (degrees).

      • axis_azimuthfloat

        Azimuth angle of the tracker axis (degrees).

      • max_anglefloat

        Maximum rotation angle of the tracker (degrees).

      • backtrackbool

        Whether to enable backtracking for single-axis trackers.

      • gcrfloat

        Ground coverage ratio of the tracker system.

Returns:

poa (pandas.DataFrame) – Contains keys/columns ‘poa_global’, ‘poa_direct’, ‘poa_diffuse’, ‘poa_sky_diffuse’, ‘poa_ground_diffuse’. [W/m2]

Notes

This function uses pvlib to calculate the plane-of-array irradiance based on the provided weather data and mounting configuration. See the pvlib documentation for further information on the parameters.

On this page

This Page