pvdeg.spectral.poa_irradiance_tracker#

pvdeg.spectral.poa_irradiance_tracker(weather_df: DataFrame, meta: dict, sol_position=None, axis_tilt=0, axis_azimuth=None, max_angle=90, backtrack=True, gcr=0.2857142857142857, cross_axis_tilt=0, dni_extra=None, airmass=None, albedo=0.25, surface_type=None, model='isotropic', model_perez='allsitescomposite1990') → DataFrame[source]#

Calculate plane-of-array (POA) irradiance using pvlib based on supplied weather data.

Parameters:

  • weather_df (pd.DataFrame) – The weather data.

  • meta (dict) – The geographical location information.

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

  • axis_tilt (float, optional) – The tilt angle of the array along the long axis of a single axis tracker [degrees]. If None, horizontal is used.

  • axis_azimuth (float, optional) – The azimuth angle of the long, non-rotating axis of the array panels [degrees]. North-south orientation by default.

  • max_angle (float, optional) – This is the maximum angle of the rotating axis achievable relative to the horizon.

  • backtrack (bool, optional) – If true, the tilt will backtrack to avoid row to row shading.

  • gcr (float, optional) – Ground coverage ratio (GCR). The ratio of the width of the PV array to the distance between rows. This affects the backtracking function.

  • cross_axis_tilt (float) – angle, relative to horizontal, of the line formed by the intersection between the slope containing the tracker axes and a plane perpendicular to the tracker axes [degrees] Fixes backtracking for a slope not parallel with the axis azimuth.

  • 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’.

  • axis_tilt – Tilt angle of the tracker axis (degrees). Default is 0.0.

  • axis_azimuth – Azimuth angle of the tracker axis (degrees). Default is 0.0.

  • max_angle – Maximum rotation angle of the tracker (degrees). Default is 45.0.

  • backtrack – Whether to enable backtracking for single-axis trackers. Default is True.

  • gcr – Ground coverage ratio of the tracker system. Default is 0.3.

Returns:

tracker_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 for single-axis tracker systems. See the pvlib documentation for further information on the parameters.

On this page

This Page