FAILURE MAP
← Case archive

FA-93601 / Solar tracker geometry / Open access

Torque-tube inclinometer rotation: west mounting flip · case 01

Rows with west-mounted sensors rotate the wrong way.

Verified by executionVariant 1 · 7 checks per implementationDownload source bundle ↓JSON ↗

ROOT CAUSE

The sensor mounting side is ignored.

VERIFIED REPAIR

Negate the reading for west-mounted sensors.

Unsuccessful approach: Mirroring about vertical adds 180 degrees instead of negating.

Case contract

ax (across-axis) and az (normal) are gravity components in g. The magnitude must be within [0.8, 1.2] g, else [None, 'fault']. Rotation = atan2(ax, az) in degrees, negated for a sensor mounted on the west side, then minus the calibration offset, normalised to (-180, 180]. Return [angle rounded 2, 'ok'].

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(ax, az, mount, offset):
    mag = math.hypot(ax, az)
    if not 0.8 <= mag <= 1.2:
        return [None, 'fault']
    ang = math.degrees(math.atan2(ax, az))
    ang -= offset
    ang = (ang + 180) % 360 - 180
    if ang == -180:
        ang = 180.0
    return [round(ang, 2), 'ok']
def check(label, actual, expected):
    observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
fixtures = [[['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [0.7778, -0.7778, 'west', 5], [-140.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [1.2, 0.0, 'west', 0], [-90.0, 'ok']],
  ['control 1', [-1.1, 0.0, 'west', 0], [90.0, 'ok']],
  ['control 2', [-0.4, 0.6928, 'east', 0], [None, 'fault']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [0.8485, 0.8485, 'west', 0], [-45.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [1.2, 0.0, 'west', 0], [-90.0, 'ok']],
  ['control 1', [-0.7778, 0.7778, 'east', 0], [-45.0, 'ok']],
  ['control 2', [0.5657, -0.5657, 'west', 2], [-137.0, 'ok']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [-0.5657, 0.5657, 'west', 0], [45.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [0.0, -1.1, 'west', -3], [-177.0, 'ok']],
  ['control 1', [0.25, 0.433, 'west', 2], [None, 'fault']],
  ['control 2', [0.8485, -0.8485, 'west', -3], [-132.0, 'ok']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [0.9526, 0.55, 'west', 0], [-60.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [1.0392, 0.6, 'west', 5], [-65.0, 'ok']],
  ['control 1', [0.5657, -0.5657, 'east', -3], [138.0, 'ok']],
  ['control 2', [-0.6, 1.0392, 'east', 0], [-30.0, 'ok']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [-0.866, -0.5, 'west', 2], [118.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [0.8, 0.0, 'west', -3], [-87.0, 'ok']],
  ['control 1', [0.6928, 0.4, 'east', 5], [None, 'fault']],
  ['control 2', [-0.55, 0.9526, 'east', 2], [-32.0, 'ok']]]]
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 fixtureActualExpectedOutcome
boundary: magnitude at lower bound[0.0, 'ok'][0.0, 'ok']Passed
boundary: magnitude at upper bound[90.0, 'ok'][90.0, 'ok']Passed
boundary: upside-down reading[180.0, 'ok'][180.0, 'ok']Passed
regression: west mounting flip[130.0, 'ok'][-140.0, 'ok']Failed
regression: west mounting flip (partial repair)[90.0, 'ok'][-90.0, 'ok']Failed
control 1[-90.0, 'ok'][90.0, 'ok']Failed
control 2[None, 'fault'][None, 'fault']Passed

SHA-256 / 619d500e051f52c279793bdbb9cde179719b01046043ede8b2315f9f1d255005

2 / The unsuccessful fix

Exit 1
"""Failure Map reference implementation. Python standard library only."""
import json
import math
N = 1
observations = []
def solve(ax, az, mount, offset):
    mag = math.hypot(ax, az)
    if not 0.8 <= mag <= 1.2:
        return [None, 'fault']
    ang = math.degrees(math.atan2(ax, az))
    if mount == 'west':
        ang = 180 - ang
    ang -= offset
    ang = (ang + 180) % 360 - 180
    if ang == -180:
        ang = 180.0
    return [round(ang, 2), 'ok']
def check(label, actual, expected):
    observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
fixtures = [[['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [0.7778, -0.7778, 'west', 5], [-140.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [1.2, 0.0, 'west', 0], [-90.0, 'ok']],
  ['control 1', [-1.1, 0.0, 'west', 0], [90.0, 'ok']],
  ['control 2', [-0.4, 0.6928, 'east', 0], [None, 'fault']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [0.8485, 0.8485, 'west', 0], [-45.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [1.2, 0.0, 'west', 0], [-90.0, 'ok']],
  ['control 1', [-0.7778, 0.7778, 'east', 0], [-45.0, 'ok']],
  ['control 2', [0.5657, -0.5657, 'west', 2], [-137.0, 'ok']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [-0.5657, 0.5657, 'west', 0], [45.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [0.0, -1.1, 'west', -3], [-177.0, 'ok']],
  ['control 1', [0.25, 0.433, 'west', 2], [None, 'fault']],
  ['control 2', [0.8485, -0.8485, 'west', -3], [-132.0, 'ok']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [0.9526, 0.55, 'west', 0], [-60.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [1.0392, 0.6, 'west', 5], [-65.0, 'ok']],
  ['control 1', [0.5657, -0.5657, 'east', -3], [138.0, 'ok']],
  ['control 2', [-0.6, 1.0392, 'east', 0], [-30.0, 'ok']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [-0.866, -0.5, 'west', 2], [118.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [0.8, 0.0, 'west', -3], [-87.0, 'ok']],
  ['control 1', [0.6928, 0.4, 'east', 5], [None, 'fault']],
  ['control 2', [-0.55, 0.9526, 'east', 2], [-32.0, 'ok']]]]
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 fixtureActualExpectedOutcome
boundary: magnitude at lower bound[0.0, 'ok'][0.0, 'ok']Passed
boundary: magnitude at upper bound[90.0, 'ok'][90.0, 'ok']Passed
boundary: upside-down reading[180.0, 'ok'][180.0, 'ok']Passed
regression: west mounting flip[40.0, 'ok'][-140.0, 'ok']Failed
regression: west mounting flip (partial repair)[90.0, 'ok'][-90.0, 'ok']Failed
control 1[-90.0, 'ok'][90.0, 'ok']Failed
control 2[None, 'fault'][None, 'fault']Passed

SHA-256 / 91aaa30fcb73f0999b339fc794a2ce52ca0ef00f83ea86b83f9c8c725a8dfbf8

3 / The verified repair

Exit 0
"""Failure Map reference implementation. Python standard library only."""
import json
import math
N = 1
observations = []
def solve(ax, az, mount, offset):
    mag = math.hypot(ax, az)
    if not 0.8 <= mag <= 1.2:
        return [None, 'fault']
    ang = math.degrees(math.atan2(ax, az))
    if mount == 'west':
        ang = -ang
    ang -= offset
    ang = (ang + 180) % 360 - 180
    if ang == -180:
        ang = 180.0
    return [round(ang, 2), 'ok']
def check(label, actual, expected):
    observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
fixtures = [[['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [0.7778, -0.7778, 'west', 5], [-140.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [1.2, 0.0, 'west', 0], [-90.0, 'ok']],
  ['control 1', [-1.1, 0.0, 'west', 0], [90.0, 'ok']],
  ['control 2', [-0.4, 0.6928, 'east', 0], [None, 'fault']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [0.8485, 0.8485, 'west', 0], [-45.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [1.2, 0.0, 'west', 0], [-90.0, 'ok']],
  ['control 1', [-0.7778, 0.7778, 'east', 0], [-45.0, 'ok']],
  ['control 2', [0.5657, -0.5657, 'west', 2], [-137.0, 'ok']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [-0.5657, 0.5657, 'west', 0], [45.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [0.0, -1.1, 'west', -3], [-177.0, 'ok']],
  ['control 1', [0.25, 0.433, 'west', 2], [None, 'fault']],
  ['control 2', [0.8485, -0.8485, 'west', -3], [-132.0, 'ok']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [0.9526, 0.55, 'west', 0], [-60.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [1.0392, 0.6, 'west', 5], [-65.0, 'ok']],
  ['control 1', [0.5657, -0.5657, 'east', -3], [138.0, 'ok']],
  ['control 2', [-0.6, 1.0392, 'east', 0], [-30.0, 'ok']]],
 [['boundary: magnitude at lower bound', [0.0, 0.8, 'east', 0], [0.0, 'ok']],
  ['boundary: magnitude at upper bound', [1.2, 0.0, 'east', 0], [90.0, 'ok']],
  ['boundary: upside-down reading', [0.0, -1.0, 'east', 0], [180.0, 'ok']],
  ['regression: west mounting flip', [-0.866, -0.5, 'west', 2], [118.0, 'ok']],
  ['regression: west mounting flip (partial repair)', [0.8, 0.0, 'west', -3], [-87.0, 'ok']],
  ['control 1', [0.6928, 0.4, 'east', 5], [None, 'fault']],
  ['control 2', [-0.55, 0.9526, 'east', 2], [-32.0, 'ok']]]]
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 fixtureActualExpectedOutcome
boundary: magnitude at lower bound[0.0, 'ok'][0.0, 'ok']Passed
boundary: magnitude at upper bound[90.0, 'ok'][90.0, 'ok']Passed
boundary: upside-down reading[180.0, 'ok'][180.0, 'ok']Passed
regression: west mounting flip[-140.0, 'ok'][-140.0, 'ok']Passed
regression: west mounting flip (partial repair)[-90.0, 'ok'][-90.0, 'ok']Passed
control 1[90.0, 'ok'][90.0, 'ok']Passed
control 2[None, 'fault'][None, 'fault']Passed

SHA-256 / bf48c656cc57562ef1664e8ea8d57e00796e269c3280cb91b63bfbbec2d60e04

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.785823+00:00.

Case digest / cb4999b76c2076d5ee8e6496e1ab9d9c78026b7d15c296c72f85f229956ad2b5