Documentation Index
Fetch the complete documentation index at: https://docs.plantpredict.com/llms.txt
Use this file to discover all available pages before exploring further.
Summary
Ground-reflected shading accounts for the reduction in ground-reflected irradiance reaching a module due to neighboring array rows blocking portions of the ground plane. Unlike sky diffuse shading, this calculation includes effects, since ground reflection arrives at oblique angles.
This model uses a 2D representation of the PV array, analyzing geometry in the plane perpendicular to the row axis.
| Name | Symbol | Units | Description |
|---|
| Row-to-Row Pitch | p | m | Horizontal distance between tracker rotation axes |
| Collector Width | ℓm | m | Tracker bay width perpendicular to rotation axis |
| Module Tilt Angle | βm | degrees | Tilt angle of module from horizontal |
| Module Azimuth Angle | γm | degrees | Azimuth angle of module surface normal, measured clockwise from North |
| Solar Zenith Angle | θz | degrees | Angle between sun and vertical |
| Solar Azimuth Angle | γs | degrees | Sun azimuth, measured clockwise from North |
| Albedo | ρ | — | Ground reflectance (0–1) |
| Global Horizontal Irradiance | GHI | W/m² | Total irradiance on horizontal surface |
| Direct Normal Irradiance | DNI | W/m² | Beam irradiance perpendicular to sun’s rays |
| Diffuse Horizontal Irradiance | DHI | W/m² | Diffuse irradiance on horizontal surface |
| IAM Parameter | b0 | — | ASHRAE IAM coefficient |
Outputs
| Name | Symbol | Units | Description |
|---|
| Ground Diffuse Shading Factor | Ushd,Gd | — | Shading factor for ground-reflected irradiance from diffuse-illuminated ground (0-1) |
| Ground Direct Shading Factor | Ushd,Gb | — | Shading factor for ground-reflected irradiance from sunlit ground (0-1) |
| Combined Ground Shading Factor | Ushd,G | — | Combined shading factor for all ground-reflected irradiance (0-1) |
Detailed Description
Ground-reflected irradiance reaching the front of the module depends on which portions of the ground between rows are visible from the module surface and whether those portions are sunlit or shaded.
The model separates this into two components:
- Sunlit ground: Receives direct and
- Shaded ground: Receives only diffuse irradiance
The model uses numerical integration across the row spacing to calculate what fraction of each ground type is visible from the module.
Step 1: Define Integration Geometry
The algorithm integrates over the ground strip between rows, from x1 to x2. Using a coordinate system centered at the module’s rotation axis:
- x1=−p: Adjacent row’s rotation axis (integration start)
- x2=−k/tan(βm): Limit of module’s downward field of view, where the assumed module center height is k=2ℓmsin(45°)+1 m (1 meter ground clearance, 45° max tilt)
Using x1=−p is a simplification—the exact geometric view angle would extend beyond the adjacent row. This conservative approximation slightly underestimates ground-reflected irradiance.
Step 2: Calculate Shadow Boundary
The shadow boundary s marks where direct beam irradiance begins on the ground. Beyond s, the ground is sunlit; before s, the ground is shaded by the adjacent row.
Project the sun into the cross-axis plane:
The shadow calculation is performed in 2D, looking along the row axis (tracker or fixed-tilt). The sun’s position in 3D (zenith θz, azimuth γs) must be projected onto this cross-axis plane.
The angle between the sun’s and the row axis is (γs−γm). The effective solar in the cross-axis plane is:
tan(θz,eff)=tan(θz)⋅∣cos(γs−γm)∣
The shadow cast by a vertical object of height h extends horizontally in the cross-axis direction by:
Lshadow=h⋅tan(θz,eff)=h⋅tan(θz)⋅∣cos(γs−γm)∣
Locate the shadow-casting edge:
The top edge of the adjacent front row casts the shadow boundary. This edge is located at:
- Horizontal position: xadj,top=−p+2ℓmcos(βm)
- Height above ground: htop=k+2ℓmsin(βm)
Shadow boundary position:
The shadow boundary is located at the shadow-casting edge plus the projected shadow length:
s=xadj,top+Lshadow=(−p+2ℓmcos(βm))+(k+2ℓmsin(βm))tan(θz)∣cos(γs−γm)∣
Rearranging:
s=(k+2ℓmsin(βm))tan(θz)∣cos(γs−γm)∣−p+2ℓmcos(βm)
The shadow boundary is clamped to the integration limits: if s<x1, all visible ground is sunlit; if s>x2, all visible ground is shaded.
Step 3: Calculate Sky View Factor
The sky view factor at ground position x is the angular extent of sky visible from that point, bounded by the current row (above) and the adjacent row (in front):
fsky(x)=σadj,top(x)−σtop(x)
The angle to the top edge of the current row is:
σtop(x)=atan(xtop−xhtop)
The angle to the top edge of the adjacent row is:
σadj,top(x)=atan(xadj,top−xhtop)
where xtop=2ℓmcos(βm) is the horizontal position of the current row’s top edge and xadj,top=−p+2ℓmcos(βm)=xtop−p is the horizontal position of the adjacent row’s top edge.
Step 4: Calculate IAM Factor
The incidence angle for light traveling from ground position x to the module center, measured from the module surface normal, is:
θinc(x)=2π+atan(∣x∣k)−βm
The ASHRAE IAM factor is then:
fIAM(x)=1−b0(cos(θinc)1−1)
with fIAM=0 when θinc>87°.
Step 5: Integrate Shading Factors
The algorithm divides the ground between rows into 100 segments and integrates to calculate:
Ground diffuse shading factor — Accounts for sky view factor and IAM effects on diffuse-illuminated ground, integrated over the entire ground strip:
Ushd,Gd=∣x2−x1∣1∫x1x2fsky(x)⋅fIAM(x)dx
Ground direct shading factor — Accounts for IAM effects on sunlit ground, integrated from the shadow boundary s to the field-of-view limit:
Ushd,Gb=∣x2−x1∣1∫sx2fIAM(x)dx
Diffuse irradiance originates from the entire sky hemisphere (extended source), so fsky(x) is needed to determine what portion of the sky each ground position can see. Direct beam irradiance comes from a single direction (point source), so we only need to determine if ground is sunlit (starting integration at s) and apply the IAM correction.
Step 6: Combine Ground Shading Factors
The two ground shading factors are applied separately to the diffuse () and direct () components of horizontal irradiance before transposition:
GH,eff=Ushd,Gd⋅DHI+Ushd,Gb⋅DNI⋅cos(θz)
This effective horizontal irradiance is then transposed to the tilted plane using the standard ground-reflected formula with ρ:
Ggnd,POA=ρ⋅GH,eff⋅21−cos(βm)
A combined ground shading factor Ushd,G is back-calculated for reporting:
Ushd,G=Ggnd,POA,unshadedGgnd,POA
where Ggnd,POA,unshaded=ρ⋅GHI⋅21−cos(βm) is the ground-reflected irradiance without shading effects. Here is the total horizontal irradiance and refers to plane-of-array irradiance on the tilted module surface.
Substituting the definitions of Ggnd,POA and GH,eff:
Ushd,G=GHIUshd,Gd⋅DHI+Ushd,Gb⋅DNI⋅cos(θz)
This combined factor is what users see in output reports and represents the net effect of both shaded and sunlit ground contributions.