@@ -30,74 +30,47 @@ def singleaxis(apparent_zenith, apparent_azimuth,
30
30
31
31
Parameters
32
32
----------
33
- apparent_zenith : float , 1d array, or Series
34
- Solar apparent zenith angles in decimal degrees.
33
+ apparent_zenith : numeric , 1d array, or Series
34
+ solar apparent zenith in degrees.
35
35
36
- apparent_azimuth : float , 1d array, or Series
37
- Solar apparent azimuth angles in decimal degrees.
36
+ apparent_azimuth : numeric , 1d array, or Series
37
+ solar azimuth in degrees.
38
38
39
- axis_tilt : float, default 0
40
- The tilt of the axis of rotation (i.e, the y-axis defined by
41
- ``axis_azimuth``) with respect to horizontal.
42
- ``axis_tilt`` must be >= 0 and <= 90. [degrees]
39
+ axis_tilt : numeric, default 0
40
+ Tilt of the tracker axis in degrees. A value of zero indicates horizontal
43
41
44
- axis_azimuth : float, default 0
45
- A value denoting the compass direction along which the axis of
46
- rotation lies. Measured in decimal degrees east of north.
47
-
48
- max_angle : float or tuple, default 90
49
- A value denoting the maximum rotation angle, in decimal degrees,
50
- of the one-axis tracker from its horizontal position (horizontal
51
- if axis_tilt = 0). If a float is provided, it represents the maximum
52
- rotation angle, and the minimum rotation angle is assumed to be the
53
- opposite of the maximum angle. If a tuple of (min_angle, max_angle) is
54
- provided, it represents both the minimum and maximum rotation angles.
55
-
56
- A rotation to ``max_angle`` is a counter-clockwise rotation about the
57
- y-axis of the tracker coordinate system. For example, for a tracker
58
- with ``axis_azimuth`` oriented to the south, a rotation to
59
- ``max_angle`` is towards the west, and a rotation toward ``-max_angle``
60
- is in the opposite direction, toward the east. Hence, a ``max_angle``
61
- of 180 degrees (equivalent to max_angle = (-180, 180)) allows the
62
- tracker to achieve its full rotation capability.
42
+ axis_azimuth : numeric, default 0
43
+ Azimuth of the tracker axis in degrees.
44
+
45
+ max_angle : numeric, default 90
46
+ Maximum rotation angle of the tracker in degrees. A value of 90 degrees.
63
47
64
48
backtrack : bool, default True
65
- Controls whether the tracker has the capability to "backtrack"
66
- to avoid row-to-row shading. False denotes no backtrack
67
- capability. True denotes backtrack capability.
49
+ Controls whether backtracking is enabled and avoid shading.
68
50
69
51
gcr : float, default 2.0/7.0
70
- A value denoting the ground coverage ratio of a tracker system that
71
- utilizes backtracking; i.e. the ratio between the PV array surface area
72
- to the total ground area. A tracker system with modules 2 meters wide,
73
- centered on the tracking axis, with 6 meters between the tracking axes
74
- has a ``gcr`` of 2/6=0.333. If ``gcr`` is not provided, a ``gcr`` of
75
- 2/7 is default. ``gcr`` must be <=1.
76
-
77
- cross_axis_tilt : float, default 0.0
78
- The angle, relative to horizontal, of the line formed by the
79
- intersection between the slope containing the tracker axes and a plane
80
- perpendicular to the tracker axes. The cross-axis tilt should be
81
- specified using a right-handed convention. For example, trackers with
82
- axis azimuth of 180 degrees (heading south) will have a negative
83
- cross-axis tilt if the tracker axes plane slopes down to the east and
84
- positive cross-axis tilt if the tracker axes plane slopes down to the
85
- west. Use :func:`~pvlib.tracking.calc_cross_axis_tilt` to calculate
86
- ``cross_axis_tilt``. [degrees]
52
+ Ground coverage ratio. A value of 2.0/7.0 is typical for the tracker systems.
53
+
54
+ cross_axis_tilt : numeric, default 0
55
+ Tilting angle of the cross-axis in degrees.
56
+
87
57
88
58
Returns
89
59
-------
90
60
dict or DataFrame with the following columns:
91
- * `tracker_theta`: The rotation angle of the tracker is a right-handed
92
- rotation defined by `axis_azimuth`.
93
- tracker_theta = 0 is horizontal. [degrees]
61
+ * `tracker_theta`: The rotation angle of the tracker.
62
+ tracker_theta = 0 is horizontal, and positive rotation angles are
63
+ clockwise.
94
64
* `aoi`: The angle-of-incidence of direct irradiance onto the
95
- rotated panel surface. [degrees]
65
+ rotated panel surface.
96
66
* `surface_tilt`: The angle between the panel surface and the earth
97
- surface, accounting for panel rotation. [degrees]
67
+ surface, accounting for panel rotation.
98
68
* `surface_azimuth`: The azimuth of the rotated panel, determined by
99
69
projecting the vector normal to the panel's surface to the earth's
100
- surface. [degrees]
70
+ surface.
71
+
72
+ Notes: The calculated tracker angle minimizes the Angle of Incidence (AOI) to
73
+ maximize the Direct Normal Irradiance (DNI) use.
101
74
102
75
See also
103
76
--------
0 commit comments