FA-93566 / Solar tracker geometry / Open access
Fixed-tilt row pitch for a design sun: sun behind rows · case 01
A northern design sun shrinks the pitch below the panel footprint.
ROOT CAUSE
Negative relative azimuth cosines are not clipped.
VERIFIED REPAIR
Clip the relative factor at zero.
Unsuccessful approach: The absolute value casts a forward shadow from a sun behind the rows.
Case contract
Rows of slant length length (mm) tilted by tilt degrees face row_az. The shadow reaches forward height*max(cos(sun_az - row_az), 0)/tan(sun_el). Minimum unshaded pitch = length*cos(tilt) + shadow. Return [pitch rounded 3, length/pitch rounded 4]; None when sun_el <= 0.
Why this case matters
Single-axis and dual-axis solar trackers turn a sun direction into actuator commands; a sign, frame or limit mistake points a whole plant away from the sun or into a mechanical stop.
1 / The failure
Exit 1"""Failure Map reference implementation. Python standard library only."""
import json
import math
N = 1
observations = []
def solve(length, tilt, sun_el, sun_az, row_az):
if sun_el <= 0:
return None
t = math.radians(tilt)
rel = math.cos(math.radians(sun_az - row_az))
depth = length * math.cos(t)
height = length * math.sin(t)
shadow = height * rel / math.tan(math.radians(sun_el))
pitch = depth + shadow
return [round(pitch, 3), round(length / pitch, 4)]
def check(label, actual, expected):
observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
fixtures = [[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [1700, 10, 15, 340, 200], [1674.173, 1.0154]],
['regression: sun behind rows (partial repair)', [2300, 10, 30, 340, 200], [2265.058, 1.0154]],
['control 1', [1700, 30, 30, 90, 200], [1472.243, 1.1547]],
['control 2', [1700, 30, 0, 90, 180], None]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [1700, 20, 10, 300, 180], [1597.477, 1.0642]],
['regression: sun behind rows (partial repair)', [1700, 25, 10, 60, 180], [1540.723, 1.1034]],
['control 1', [1700, 30, 0, 225, 170], None],
['control 2', [2000, 30, 30, 135, 180], [2956.796, 0.6764]]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [1000, 30, 10, 200, 0], [866.025, 1.1547]],
['regression: sun behind rows (partial repair)', [1700, 25, 30, 340, 170], [1540.723, 1.1034]],
['control 1', [2000, 0, -2, 315, 0], None], ['control 2', [2000, 30, 0, 30, 0], None]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [2300, 35, 15, 0, 170], [1884.05, 1.2208]],
['regression: sun behind rows (partial repair)', [1000, 20, 20, 45, 180], [939.693, 1.0642]],
['control 1', [2300, 35, 30, 60, 0], [3026.533, 0.7599]],
['control 2', [1000, 30, 20, 250, 180], [1335.872, 0.7486]]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [2300, 30, 30, 60, 200], [1991.858, 1.1547]],
['regression: sun behind rows (partial repair)', [2000, 30, 15, 45, 200], [1732.051, 1.1547]],
['control 1', [2000, 35, -2, 225, 170], None],
['control 2', [1700, 20, 20, 90, 170], [1874.877, 0.9067]]]]
for label, args, expected in fixtures[N-1]:
check(label, solve(*args), expected)
print(json.dumps({"observations": observations, "passed": all(x["passed"] for x in observations)}, ensure_ascii=False))
raise SystemExit(0 if all(x["passed"] for x in observations) else 1)
| Boundary fixture | Actual | Expected | Outcome |
|---|---|---|---|
| normal: winter noon design sun | [5464.102, 0.366] | [5464.102, 0.366] | Passed |
| boundary: flat rows | [2000.0, 1.0] | [2000.0, 1.0] | Passed |
| boundary: sun behind the rows | [-2000.0, -1.0] | [1732.051, 1.1547] | Failed |
| regression: sun behind rows | [830.216, 2.0477] | [1674.173, 1.0154] | Failed |
| regression: sun behind rows (partial repair) | [1735.135, 1.3255] | [2265.058, 1.0154] | Failed |
| control 1 | [968.706, 1.7549] | [1472.243, 1.1547] | Failed |
| control 2 | None | None | Passed |
SHA-256 / 5a72fec243e32bcb1b48799aaea40f3b6d2a26cc0a910c1cd23b6b513dc1a498
2 / The unsuccessful fix
Exit 1"""Failure Map reference implementation. Python standard library only."""
import json
import math
N = 1
observations = []
def solve(length, tilt, sun_el, sun_az, row_az):
if sun_el <= 0:
return None
t = math.radians(tilt)
rel = math.cos(math.radians(sun_az - row_az))
depth = length * math.cos(t)
height = length * math.sin(t)
shadow = height * abs(rel) / math.tan(math.radians(sun_el))
pitch = depth + shadow
return [round(pitch, 3), round(length / pitch, 4)]
def check(label, actual, expected):
observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
fixtures = [[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [1700, 10, 15, 340, 200], [1674.173, 1.0154]],
['regression: sun behind rows (partial repair)', [2300, 10, 30, 340, 200], [2265.058, 1.0154]],
['control 1', [1700, 30, 30, 90, 200], [1472.243, 1.1547]],
['control 2', [1700, 30, 0, 90, 180], None]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [1700, 20, 10, 300, 180], [1597.477, 1.0642]],
['regression: sun behind rows (partial repair)', [1700, 25, 10, 60, 180], [1540.723, 1.1034]],
['control 1', [1700, 30, 0, 225, 170], None],
['control 2', [2000, 30, 30, 135, 180], [2956.796, 0.6764]]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [1000, 30, 10, 200, 0], [866.025, 1.1547]],
['regression: sun behind rows (partial repair)', [1700, 25, 30, 340, 170], [1540.723, 1.1034]],
['control 1', [2000, 0, -2, 315, 0], None], ['control 2', [2000, 30, 0, 30, 0], None]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [2300, 35, 15, 0, 170], [1884.05, 1.2208]],
['regression: sun behind rows (partial repair)', [1000, 20, 20, 45, 180], [939.693, 1.0642]],
['control 1', [2300, 35, 30, 60, 0], [3026.533, 0.7599]],
['control 2', [1000, 30, 20, 250, 180], [1335.872, 0.7486]]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [2300, 30, 30, 60, 200], [1991.858, 1.1547]],
['regression: sun behind rows (partial repair)', [2000, 30, 15, 45, 200], [1732.051, 1.1547]],
['control 1', [2000, 35, -2, 225, 170], None],
['control 2', [1700, 20, 20, 90, 170], [1874.877, 0.9067]]]]
for label, args, expected in fixtures[N-1]:
check(label, solve(*args), expected)
print(json.dumps({"observations": observations, "passed": all(x["passed"] for x in observations)}, ensure_ascii=False))
raise SystemExit(0 if all(x["passed"] for x in observations) else 1)
| Boundary fixture | Actual | Expected | Outcome |
|---|---|---|---|
| normal: winter noon design sun | [5464.102, 0.366] | [5464.102, 0.366] | Passed |
| boundary: flat rows | [2000.0, 1.0] | [2000.0, 1.0] | Passed |
| boundary: sun behind the rows | [5464.102, 0.366] | [1732.051, 1.1547] | Failed |
| regression: sun behind rows | [2518.131, 0.6751] | [1674.173, 1.0154] | Failed |
| regression: sun behind rows (partial repair) | [2794.981, 0.8229] | [2265.058, 1.0154] | Failed |
| control 1 | [1975.78, 0.8604] | [1472.243, 1.1547] | Failed |
| control 2 | None | None | Passed |
SHA-256 / 5c9fae67bc40df27555c132af87963a5b0706fb51a6c2e983585d511f09371a8
3 / The verified repair
Exit 0"""Failure Map reference implementation. Python standard library only."""
import json
import math
N = 1
observations = []
def solve(length, tilt, sun_el, sun_az, row_az):
if sun_el <= 0:
return None
t = math.radians(tilt)
rel = math.cos(math.radians(sun_az - row_az))
depth = length * math.cos(t)
height = length * math.sin(t)
shadow = height * max(rel, 0.0) / math.tan(math.radians(sun_el))
pitch = depth + shadow
return [round(pitch, 3), round(length / pitch, 4)]
def check(label, actual, expected):
observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
fixtures = [[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [1700, 10, 15, 340, 200], [1674.173, 1.0154]],
['regression: sun behind rows (partial repair)', [2300, 10, 30, 340, 200], [2265.058, 1.0154]],
['control 1', [1700, 30, 30, 90, 200], [1472.243, 1.1547]],
['control 2', [1700, 30, 0, 90, 180], None]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [1700, 20, 10, 300, 180], [1597.477, 1.0642]],
['regression: sun behind rows (partial repair)', [1700, 25, 10, 60, 180], [1540.723, 1.1034]],
['control 1', [1700, 30, 0, 225, 170], None],
['control 2', [2000, 30, 30, 135, 180], [2956.796, 0.6764]]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [1000, 30, 10, 200, 0], [866.025, 1.1547]],
['regression: sun behind rows (partial repair)', [1700, 25, 30, 340, 170], [1540.723, 1.1034]],
['control 1', [2000, 0, -2, 315, 0], None], ['control 2', [2000, 30, 0, 30, 0], None]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [2300, 35, 15, 0, 170], [1884.05, 1.2208]],
['regression: sun behind rows (partial repair)', [1000, 20, 20, 45, 180], [939.693, 1.0642]],
['control 1', [2300, 35, 30, 60, 0], [3026.533, 0.7599]],
['control 2', [1000, 30, 20, 250, 180], [1335.872, 0.7486]]],
[['normal: winter noon design sun', [2000, 30, 15, 180, 180], [5464.102, 0.366]],
['boundary: flat rows', [2000, 0, 15, 180, 180], [2000.0, 1.0]],
['boundary: sun behind the rows', [2000, 30, 15, 0, 180], [1732.051, 1.1547]],
['regression: sun behind rows', [2300, 30, 30, 60, 200], [1991.858, 1.1547]],
['regression: sun behind rows (partial repair)', [2000, 30, 15, 45, 200], [1732.051, 1.1547]],
['control 1', [2000, 35, -2, 225, 170], None],
['control 2', [1700, 20, 20, 90, 170], [1874.877, 0.9067]]]]
for label, args, expected in fixtures[N-1]:
check(label, solve(*args), expected)
print(json.dumps({"observations": observations, "passed": all(x["passed"] for x in observations)}, ensure_ascii=False))
raise SystemExit(0 if all(x["passed"] for x in observations) else 1)
| Boundary fixture | Actual | Expected | Outcome |
|---|---|---|---|
| normal: winter noon design sun | [5464.102, 0.366] | [5464.102, 0.366] | Passed |
| boundary: flat rows | [2000.0, 1.0] | [2000.0, 1.0] | Passed |
| boundary: sun behind the rows | [1732.051, 1.1547] | [1732.051, 1.1547] | Passed |
| regression: sun behind rows | [1674.173, 1.0154] | [1674.173, 1.0154] | Passed |
| regression: sun behind rows (partial repair) | [2265.058, 1.0154] | [2265.058, 1.0154] | Passed |
| control 1 | [1472.243, 1.1547] | [1472.243, 1.1547] | Passed |
| control 2 | None | None | Passed |
SHA-256 / 5aab3d4f83c24be76440aeeeb3033eafb57516f3530821110f2618a7225b5757
Verification & scope
Deterministic stipulated toy contract for teaching; no claim of conformance with any standard, vendor protocol or production controller. This reproducer isolates one failure mechanism. Results cover the supplied fixtures. Variants within a family share a test contract and should remain grouped when constructing evaluation splits. Related mechanisms with a shared evaluation_group must also remain together; these controlled models are not independent production incidents.
Observations recorded using Python 3.12.14 at 2026-09-29T14:51:56.276269+00:00.
Case digest / c05ad62af4d3fee7f2bd52c629c613b8379dbe99dc8468a050c2e35297ac7ee9