import 'dart:math' as math; import 'package:flutter_riverpod/flutter_riverpod.dart'; import '../../models/telemetry_sample.dart'; enum ValidationStatus { valid, suspect, rejected, } class TelemetryQuality { final ValidationStatus status; final List reasons; final double gpsConfidence; // 0.0 - 1.0 final double speedConfidence; // 0.0 - 1.0 final double leanConfidence; // 0.0 - 1.0 final double gForceConfidence; // 0.0 - 1.0 final double headingConfidence; // 0.0 - 1.0 final double overallConfidence; // 0.0 - 1.0 final bool isStationary; final bool isAccelerating; final bool isBraking; final bool isMountCalibrated; final bool isSensorSaturated; final int timestampDeltaMs; const TelemetryQuality({ this.status = ValidationStatus.valid, this.reasons = const [], this.gpsConfidence = 1.0, this.speedConfidence = 1.0, this.leanConfidence = 1.0, this.gForceConfidence = 1.0, this.headingConfidence = 1.0, this.overallConfidence = 1.0, this.isStationary = true, this.isAccelerating = false, this.isBraking = false, this.isMountCalibrated = true, this.isSensorSaturated = false, this.timestampDeltaMs = 50, }); bool get isValid => status == ValidationStatus.valid; bool get isSuspect => status == ValidationStatus.suspect; bool get isRejected => status == ValidationStatus.rejected; } final telemetryValidatorProvider = Provider((ref) { return TelemetryValidator(); }); class TelemetryValidator { DateTime? _lastTimestamp; double? _lastSpeedMph; double? _lastLeanAngle; double? _lastLat; double? _lastLng; // Diagnostic counters int _totalValidated = 0; int _validCount = 0; int _suspectCount = 0; int _rejectedCount = 0; int _timestampGapCount = 0; int get totalValidated => _totalValidated; int get validCount => _validCount; int get suspectCount => _suspectCount; int get rejectedCount => _rejectedCount; int get timestampGapCount => _timestampGapCount; void reset() { _lastTimestamp = null; _lastSpeedMph = null; _lastLeanAngle = null; _lastLat = null; _lastLng = null; _totalValidated = 0; _validCount = 0; _suspectCount = 0; _rejectedCount = 0; _timestampGapCount = 0; } TelemetryQuality validate(TelemetrySample sample) { _totalValidated++; final reasons = []; var status = ValidationStatus.valid; // 1. Numeric Sanity (NaN / Infinity) if (_hasInvalidNumeric(sample)) { status = ValidationStatus.rejected; reasons.add('Numeric error: sample contains NaN or Infinity'); _rejectedCount++; return TelemetryQuality( status: status, reasons: reasons, gpsConfidence: 0.0, speedConfidence: 0.0, leanConfidence: 0.0, gForceConfidence: 0.0, headingConfidence: 0.0, overallConfidence: 0.0, ); } // 2. Timestamp Validation int deltaMs = 50; if (_lastTimestamp != null) { deltaMs = sample.timestamp.difference(_lastTimestamp!).inMilliseconds; if (deltaMs <= 0) { status = ValidationStatus.suspect; reasons.add('Duplicate or reverse timestamp (delta: ${deltaMs}ms)'); } else if (deltaMs > 300) { _timestampGapCount++; if (deltaMs > 2000) { status = ValidationStatus.suspect; reasons.add('Large telemetry gap (${(deltaMs / 1000).toStringAsFixed(1)}s)'); } } } // 3. GPS Confidence & Quality double gpsConf = 1.0; if (sample.gpsAccuracy != null) { if (sample.gpsAccuracy! <= 5.0) { gpsConf = 1.0; } else if (sample.gpsAccuracy! <= 15.0) { gpsConf = 0.85; } else if (sample.gpsAccuracy! <= 35.0) { gpsConf = 0.60; if (status == ValidationStatus.valid) status = ValidationStatus.suspect; reasons.add('Degraded GPS accuracy (${sample.gpsAccuracy!.toStringAsFixed(1)}m)'); } else { gpsConf = 0.25; status = ValidationStatus.suspect; reasons.add('Poor GPS accuracy (${sample.gpsAccuracy!.toStringAsFixed(1)}m > 35m)'); } } else { gpsConf = 0.50; } // GPS Position Teleportation Check if (_lastLat != null && _lastLng != null && sample.latitude != null && sample.longitude != null && deltaMs > 0 && deltaMs < 3000) { final latDiff = (sample.latitude! - _lastLat!).abs() * 111139.0; final lngDiff = (sample.longitude! - _lastLng!).abs() * 111139.0 * math.cos(sample.latitude! * (math.pi / 180.0)); final distMeters = math.sqrt(latDiff * latDiff + lngDiff * lngDiff); final derivedSpeedMps = distMeters / (deltaMs / 1000.0); if (derivedSpeedMps > 110.0 && distMeters > 50.0) { status = ValidationStatus.rejected; gpsConf = 0.0; reasons.add('GPS position jump detected (${distMeters.toStringAsFixed(0)}m in ${deltaMs}ms)'); } } // 4. Speed Plausibility & Confidence double speedConf = gpsConf; final currentSpeed = sample.speed ?? 0.0; if (currentSpeed > 220.0) { status = ValidationStatus.rejected; speedConf = 0.0; reasons.add('Impossible vehicle speed (${currentSpeed.toStringAsFixed(1)} MPH > 220 MPH)'); } else if (_lastSpeedMph != null && deltaMs > 0 && deltaMs < 2000) { final deltaSpeedMph = (currentSpeed - _lastSpeedMph!).abs(); final dtSec = deltaMs / 1000.0; final accelMps2 = (deltaSpeedMph / 2.23694) / dtSec; // Realistic motorcycle acceleration ceiling: ~15 m/s² (~1.5g), spike ceiling: 25 m/s² if (accelMps2 > 25.0 && dtSec >= 0.1) { status = ValidationStatus.rejected; speedConf = 0.1; reasons.add('Impossible acceleration (${accelMps2.toStringAsFixed(1)} m/s² > 25 m/s²)'); } else if (accelMps2 > 16.0) { if (status == ValidationStatus.valid) status = ValidationStatus.suspect; speedConf = math.min(speedConf, 0.5); reasons.add('Suspicious acceleration spike (${accelMps2.toStringAsFixed(1)} m/s²)'); } } // 5. Lean Angle Plausibility & Confidence double leanConf = 1.0; final currentLean = sample.leanAngle ?? 0.0; if (currentLean.abs() > 65.0) { status = ValidationStatus.suspect; leanConf = 0.3; reasons.add('Extreme lean angle beyond physical motorcycle limit (${currentLean.toStringAsFixed(1)}° > 65°)'); } else if (_lastLeanAngle != null && deltaMs > 0 && deltaMs < 1000) { final deltaLean = (currentLean - _lastLeanAngle!).abs(); final rollRateDegPerSec = deltaLean / (deltaMs / 1000.0); // Motorcycle flick roll-rate ceiling is ~120 deg/sec if (rollRateDegPerSec > 180.0) { if (status == ValidationStatus.valid) status = ValidationStatus.suspect; leanConf = 0.4; reasons.add('Excessive roll rate (${rollRateDegPerSec.toStringAsFixed(0)}°/s)'); } } // 6. G-Force Plausibility & Sensor Saturation double gConf = 1.0; bool isSaturated = false; if (sample.accelX != null && sample.accelY != null && sample.accelZ != null) { final maxRawAccel = math.max(sample.accelX!.abs(), math.max(sample.accelY!.abs(), sample.accelZ!.abs())); // Typical mobile accelerometer saturates around ~78 m/s² (8g) or 156 m/s² (16g) if (maxRawAccel > 120.0) { isSaturated = true; gConf = 0.3; reasons.add('IMU accelerometer near saturation (${maxRawAccel.toStringAsFixed(1)} m/s²)'); } } // 7. Motion State Classification final isStationary = currentSpeed < 1.3; final isAccelerating = (sample.longitudinalG ?? 0.0) > 0.15 && currentSpeed >= 1.3; final isBraking = (sample.longitudinalG ?? 0.0) < -0.20 && currentSpeed >= 1.3; // 8. Overall Telemetry Confidence final overallConf = (gpsConf * 0.40 + speedConf * 0.30 + leanConf * 0.20 + gConf * 0.10).clamp(0.0, 1.0); if (status == ValidationStatus.valid) { _validCount++; } else if (status == ValidationStatus.suspect) { _suspectCount++; } else { _rejectedCount++; } // Update state tracking _lastTimestamp = sample.timestamp; if (status != ValidationStatus.rejected) { _lastSpeedMph = currentSpeed; _lastLeanAngle = currentLean; if (sample.latitude != null) _lastLat = sample.latitude; if (sample.longitude != null) _lastLng = sample.longitude; } return TelemetryQuality( status: status, reasons: reasons, gpsConfidence: gpsConf, speedConfidence: speedConf, leanConfidence: leanConf, gForceConfidence: gConf, headingConfidence: sample.heading != null ? 0.95 : 0.50, overallConfidence: overallConf, isStationary: isStationary, isAccelerating: isAccelerating, isBraking: isBraking, isMountCalibrated: true, isSensorSaturated: isSaturated, timestampDeltaMs: deltaMs, ); } bool _hasInvalidNumeric(TelemetrySample s) { if (s.latitude != null && (s.latitude!.isNaN || s.latitude!.isInfinite)) return true; if (s.longitude != null && (s.longitude!.isNaN || s.longitude!.isInfinite)) return true; if (s.speed != null && (s.speed!.isNaN || s.speed!.isInfinite)) return true; if (s.leanAngle != null && (s.leanAngle!.isNaN || s.leanAngle!.isInfinite)) return true; if (s.pitchAngle != null && (s.pitchAngle!.isNaN || s.pitchAngle!.isInfinite)) return true; if (s.accelX != null && (s.accelX!.isNaN || s.accelX!.isInfinite)) return true; if (s.accelY != null && (s.accelY!.isNaN || s.accelY!.isInfinite)) return true; if (s.accelZ != null && (s.accelZ!.isNaN || s.accelZ!.isInfinite)) return true; if (s.longitudinalG != null && (s.longitudinalG!.isNaN || s.longitudinalG!.isInfinite)) return true; if (s.lateralG != null && (s.lateralG!.isNaN || s.lateralG!.isInfinite)) return true; return false; } }