Skip to content

docstring updated to indicate limits of axis_tilt #1489

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Jul 19, 2022
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs/sphinx/source/whatsnew/v0.9.2.rst
Original file line number Diff line number Diff line change
Expand Up @@ -51,4 +51,5 @@ Contributors
* Chencheng Luo (:ghuser:`roger-lcc`)
* Prajwal Borkar (:ghuser:`PrajwalBorkar`)
* Kevin Anderson (:ghuser:`kanderso-nrel`)
* Cliff Hansen (:ghuser:`cwhanse`)
* Cliff Hansen (:ghuser:`cwhanse`)
* Kurt Rhee (:ghuser:`kurt-rhee`)
10 changes: 8 additions & 2 deletions pvlib/tracking.py
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ class SingleAxisTracker(PVSystem):
axis_tilt : float, default 0
The tilt of the axis of rotation (i.e, the y-axis defined by
axis_azimuth) with respect to horizontal, in decimal degrees.
axis_tilt must be >= 0 and <= 90.

axis_azimuth : float, default 0
A value denoting the compass direction along which the axis of
Expand Down Expand Up @@ -295,6 +296,7 @@ def singleaxis(apparent_zenith, apparent_azimuth,
axis_tilt : float, default 0
The tilt of the axis of rotation (i.e, the y-axis defined by
axis_azimuth) with respect to horizontal, in decimal degrees.
axis_tilt must be >= 0 and <= 90.

axis_azimuth : float, default 0
A value denoting the compass direction along which the axis of
Expand Down Expand Up @@ -481,6 +483,7 @@ def calc_surface_orientation(tracker_theta, axis_tilt=0, axis_azimuth=0):
results in ``surface_azimuth`` to the East. [degree]
axis_tilt : float, default 0
The tilt of the axis of rotation with respect to horizontal. [degree]
axis_tilt must be >= 0 and <= 90.
axis_azimuth : float, default 0
A value denoting the compass direction along which the axis of
rotation lies. Measured east of north. [degree]
Expand Down Expand Up @@ -524,7 +527,9 @@ def calc_surface_orientation(tracker_theta, axis_tilt=0, axis_azimuth=0):
def calc_axis_tilt(slope_azimuth, slope_tilt, axis_azimuth):
"""
Calculate tracker axis tilt in the global reference frame when on a sloped
plane.
plane. Axis tilt is the inclination of the tracker rotation axis with
respect to horizontal, ranging from 0 degrees (horizontal axis) to 90
degrees (vertical axis).

Parameters
----------
Expand Down Expand Up @@ -639,7 +644,8 @@ def calc_cross_axis_tilt(
axis_azimuth : float
direction of tracker axes projected on the horizontal [degrees]
axis_tilt : float
tilt of trackers relative to horizontal [degrees]
tilt of trackers relative to horizontal. axis_tilt must be >= 0
and <= 90.[degrees]

Returns
-------
Expand Down