Skip to content
Open
Show file tree
Hide file tree
Changes from all 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
4 changes: 4 additions & 0 deletions docs/sphinx/source/whatsnew/v0.16.2.rst
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,9 @@ Documentation
* Note deprecation of ``king`` model in :py:func:`~pvlib.irradiance.get_total_irradiance`
and :py:func:`~pvlib.irradiance.get_sky_diffuse` docstrings.
(:issue:`2897`, :pull:`2904`)
* Document the effect of ``n_pvrows`` on edge effects and runtime in
:py:func:`pvlib.bifacial.pvfactors.pvfactors_timeseries`.
(:issue:`1398`, :pull:`2954`)


Testing
Expand Down Expand Up @@ -84,3 +87,4 @@ Contributors
* :ghuser:`xiajiahang`
* Jakub Krasuski (:ghuser:`Blizzeq`)
* Dylan Pulver (:ghuser:`dylanpulver`)
* :ghuser:`WPTK`
7 changes: 6 additions & 1 deletion pvlib/bifacial/pvfactors.py
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,12 @@ def pvfactors_timeseries(
albedo: float
Ground albedo
n_pvrows: int, default 3
Number of PV rows to consider in the PV array
Number of PV rows to consider in the PV array. The model treats rows
as infinite in length but finite in number, so a small ``n_pvrows``
produces edge effects, such as fully illuminated ground under the
array at low sun elevation, which cause morning and afternoon spikes
in rear irradiance. Increasing ``n_pvrows`` reduces these effects but
significantly increases runtime.
index_observed_pvrow: int, default 1
Index of the PV row whose incident irradiance will be returned. Indices
of PV rows go from 0 to n_pvrows-1.
Expand Down