pvlib.irradiance.get_ground_diffuse#
- pvlib.irradiance.get_ground_diffuse(surface_tilt, ghi, albedo=0.25, surface_type=None)[source]#
Estimate diffuse irradiance on a tilted surface from ground reflections.
Ground diffuse irradiance is calculated as
\[G_{ground} = GHI \times \rho \times \frac{1 - \cos\beta}{2}\]where \(\rho\) is
albedo
and \(\beta\) issurface_tilt
.- Parameters:
surface_tilt (numeric) – Surface tilt angles in decimal degrees. Tilt must be >=0 and <=180. The tilt angle is defined as degrees from horizontal (e.g. surface facing up = 0, surface facing horizon = 90).
ghi (numeric) – Global horizontal irradiance. [Wm⁻²]
albedo (numeric, default 0.25) – Ground reflectance, typically 0.1-0.4 for surfaces on Earth (land), may increase over snow, ice, etc. May also be known as the reflection coefficient. Must be >=0 and <=1. Will be overridden if
surface_type
is supplied.surface_type (string, optional) – If supplied, overrides
albedo
.surface_type
can be one of ‘urban’, ‘grass’, ‘fresh grass’, ‘snow’, ‘fresh snow’, ‘asphalt’, ‘concrete’, ‘aluminum’, ‘copper’, ‘fresh steel’, ‘dirty steel’, ‘sea’.
- Returns:
grounddiffuse (numeric) – Ground reflected irradiance. [Wm⁻²]
Notes
Table of albedo values by
surface_type
are from [2], [3], [4]; seeSURFACE_ALBEDOS
.References