pvlib.bifacial.utils.vf_row_ground_2d_integ#

pvlib.bifacial.utils.vf_row_ground_2d_integ(surface_tilt, gcr, height=None, pitch=None, x0=0, x1=1, max_rows=20, g0=0, g1=1)[source]#

Calculate the view factor to the ground segment (g0, g1) from the row surface segment (x0, x1).

Assumes a PV system of infinitely long rows with uniform pitch on horizontal ground. The view to the ground is restricted by the row’s tilt and the bottom of the facing row.

Parameters:

surface_tilt (numeric) – Surface tilt angle in degrees from horizontal, e.g., surface facing up = 0, surface facing horizon = 90. [degree]
gcr (numeric) – Ratio of the row slant length to the row spacing (pitch). [unitless]
height (float, optional) – Height of the center point of the row above the ground; must be in the same units as pitch. Required if g0 or x0` is not zero or if ``g1 or x1 is not one.
pitch (float, optional) – Distance between two rows; must be in the same units as height. Required if g0 or x0` is not zero or if ``g1 or x1 is not one.
x0 (numeric, default 0.) – Position on the row’s slant length, as a fraction of the slant length. x0=0 corresponds to the bottom of the row. x0 should be less than x1. [unitless]
x1 (numeric, default 1.) – Position on the row’s slant length, as a fraction of the slant length. x1 should be greater than x0. [unitless]
max_rows (int, default 20) – Maximum number of rows to consider in front and behind the current row.
g0 (numeric, default 0) – Position on the ground surface, as a fraction of the spacing between adjacent rows. g0=0 corresponds to ground underneath the middle of the left row. g0 should be less than g1. [unitless]
g1 (numeric, default 1) – Position on the ground surface, as a fraction of the spacing between adjacent rows. g1=0 corresponds to ground underneath the middle of the right row. g1 should be greater than g0. [unitless]

Returns:

vf (numeric) – Integrated view factor to the visible ground on the interval (x0, x1). [unitless]

References