Sensor Limitation Analysis

"""Camera sensor limitation analysis for SOTIF."""
from dataclasses import dataclass
from typing import List

@dataclass
class CameraLimitation:
    limitation_id:   str
    condition:       str
    effect:          str   # what degrades
    threshold:       str   # when degradation becomes safety-relevant
    detection_by:    str   # how to detect this condition on vehicle
    mitigation:      str

CAMERA_LIMITATIONS: List[CameraLimitation] = [
    CameraLimitation(
        limitation_id="CL_001",
        condition="Direct sun glare (sun angle 10-30 deg above horizon)",
        effect="Image saturation; object detector confidence < 0.3",
        threshold="Luminance > 80,000 lux in camera FOV",
        detection_by="Luminance sensor + sun angle from GPS/time",
        mitigation="Radar primary source; HMI warning; reduce AEB distance"
    ),
    CameraLimitation(
        limitation_id="CL_002",
        condition="Rain on windshield: > 5mm/h",
        effect="Detection range reduced from 80m to < 20m",
        threshold="Wiper speed high (proxy for heavy rain)",
        detection_by="Wiper speed signal via CAN",
        mitigation="Radar takes over; AEB performance reduced; HMI warning"
    ),
    CameraLimitation(
        limitation_id="CL_003",
        condition="Tunnel entry: sudden luminance drop (>10:1 ratio)",
        effect="Auto-exposure lag: 0.5-2s of degraded detection",
        threshold="Luminance drop > 10x within 200ms",
        detection_by="Map+GPS pre-emptive or camera luminance histogram",
        mitigation="Increase AEB brake distance during exposure transition"
    ),
]

for cl in CAMERA_LIMITATIONS:
    print(f"[{cl.limitation_id}] {cl.condition[:45]}...")
    print(f"  Mitigation: {cl.mitigation[:60]}...")