pvlib.tracking.singleaxis#

pvlib.tracking.singleaxis(apparent_zenith, solar_azimuth, axis_slope=0, axis_azimuth=0, max_angle=90, backtrack=True, gcr=0.2857142857142857, cross_axis_slope=0)[source]#

Determine the rotation angle of a single-axis tracker when given particular solar zenith and azimuth angles.

See [1] and [2] for details about the equations. Backtracking may be specified, in which case a ground coverage ratio is required.

Rotation angle is determined in a right-handed coordinate system. The tracker axis_azimuth defines the positive y-axis, the positive x-axis is 90 degrees clockwise from the y-axis and parallel to the Earth’s surface, and the positive z-axis is normal to both x and y-axes and oriented skyward. Rotation angle tracker_theta is a right-handed rotation around the y-axis in the x, y, z coordinate system and indicates tracker position relative to horizontal. For example, if tracker axis_azimuth is 180 (oriented south) and axis_slope is zero, then a tracker_theta of zero is horizontal, a tracker_theta of 30 degrees is a rotation of 30 degrees towards the west, and a tracker_theta of -90 degrees is a rotation to the vertical plane facing east.

Parameters:

apparent_zenith (float, 1d array, or Series) – Solar apparent zenith angles in decimal degrees.
solar_azimuth (float, 1d array, or Series) – Solar apparent azimuth angles in decimal degrees.
axis_slope (float, default 0) –
The tilt of the axis of rotation (i.e, the y-axis defined by axis_azimuth) with respect to horizontal. axis_slope must be >= 0 and <= 90. [degrees]

Changed in version 0.13.1: Renamed from axis_tilt to axis_slope.
axis_azimuth (float, default 0) – A value denoting the compass direction along which the axis of rotation lies. Measured in decimal degrees east of north.
max_angle (float or tuple, default 90) –
A value denoting the maximum rotation angle, in decimal degrees, of the one-axis tracker from its horizontal position (horizontal if axis_slope = 0). If a float is provided, it represents the maximum rotation angle, and the minimum rotation angle is assumed to be the opposite of the maximum angle. If a tuple of (min_angle, max_angle) is provided, it represents both the minimum and maximum rotation angles.

A rotation to max_angle is a counter-clockwise rotation about the y-axis of the tracker coordinate system. For example, for a tracker with axis_azimuth oriented to the south, a rotation to max_angle is towards the west, and a rotation toward -max_angle is in the opposite direction, toward the east. Hence, a max_angle of 180 degrees (equivalent to max_angle = (-180, 180)) allows the tracker to achieve its full rotation capability.
backtrack (bool, default True) – Controls whether the tracker has the capability to “backtrack” to avoid row-to-row shading. False denotes no backtrack capability. True denotes backtrack capability.
gcr (float, default 2.0/7.0) – A value denoting the ground coverage ratio of a tracker system that utilizes backtracking; i.e. the ratio between the PV array surface area to the total ground area. A tracker system with modules 2 meters wide, centered on the tracking axis, with 6 meters between the tracking axes has a gcr of 2/6=0.333. If gcr is not provided, a gcr of 2/7 is default. gcr must be <=1.
cross_axis_slope (float, default 0.0) –
Angle of the plane containing the rows’ axes relative to horizontal. Right-handed rotation with respect to the rows axes. See cross_axis_slope. In degrees \(^{\circ}\).

Changed in version 0.13.1: Renamed from cross_axis_tilt to cross_axis_slope.

Returns:

dict or DataFrame with the following columns –

tracker_theta: The rotation angle of the tracker is a right-handed rotation defined by axis_azimuth. tracker_theta = 0 is horizontal. [degrees]
aoi: The angle-of-incidence of direct irradiance onto the rotated panel surface. [degrees]
surface_tilt: The angle between the panel surface and the earth surface, accounting for panel rotation. [degrees]
surface_azimuth: The azimuth of the rotated panel, determined by projecting the vector normal to the panel’s surface to the earth’s surface. [degrees]

Examples using `pvlib.tracking.singleaxis`#

Agrivoltaic system modeling

Bifacial Modeling - procedural

Modeling Transposition Gain

Shaded fraction of a horizontal single-axis tracker

Modelling shading losses in modules with bypass diodes

Single-axis tracking

Backtracking on sloped terrain

Discontinuous Tracking

pvlib.tracking.singleaxis#

Examples using pvlib.tracking.singleaxis#

Examples using `pvlib.tracking.singleaxis`#