driving_conditions

Pure Dart computation models for weather-driven driving safety assessment.

This package converts a WeatherCondition into structured driving guidance:

• Road surface classification (dry, wet, slush, compactedSnow, blackIce, standingWater)
• Grip factor estimation
• Visibility degradation parameters for UI overlays
• Precipitation particle parameters for renderers
• Monte Carlo safety score simulation

Scope

driving_conditions does not render UI and does not depend on Flutter. It provides computation outputs that app and package layers can consume.

Install

dependencies:
  driving_conditions: ^0.1.1

Core Models

RoadSurfaceState

Decision tree from weather conditions:

• iceRisk => blackIce
• no precipitation and temperature <= -3°C => blackIce
• rain and heavy intensity with temperature > 3°C => standingWater
• rain and temperature <= 0°C => blackIce
• snow and temperature > 2°C => slush
• snow and temperature < -2°C with moderate or heavy intensity => compactedSnow
• sleet => slush

Grip factors:

State	Grip
dry	1.0
wet	0.7
slush	0.5
compactedSnow	0.3
blackIce	0.15
standingWater	0.6

PrecipitationConfig

Particle count formula:

particleCount = round(intensityFactor * 500)

Intensity factors:

Intensity	Factor	Particles
none	0.0	0
light	0.3	150
moderate	0.6	300
heavy	1.0	500

Velocity ranges:

Type	Min m/s	Max m/s
snow	2.0	4.0
rain	7.0	12.0
sleet	4.0	8.0
hail	8.0	15.0

VisibilityDegradation

Formulas:

opacity = 1.0 - clamp(visibilityMeters / 1000.0, 0.1, 1.0)
blurSigma = max(0.0, (500.0 - visibilityMeters) / 50.0)

Examples:

• 0m => opacity 0.9, blur 10.0
• 100m => opacity 0.9, blur 8.0
• 500m => opacity 0.5, blur 0.0
• 1000m+ => clear

DrivingConditionAssessment

Bridge model combining:

• RoadSurfaceState
• gripFactor
• VisibilityDegradation
• PrecipitationConfig
• advisory message

SafetyScoreSimulator

Monte Carlo scoring model:

gripScore = gripFactor * (1 - gripJitter) * (1 - speedFactor * 0.3)
visibilityScore = clamp(visibilityMeters / 1000.0, 0, 1) * (1 - visJitter)
fleetConfidenceScore = 0.8
overall = gripScore * 0.4 + visibilityScore * 0.4 + fleetConfidenceScore * 0.2

Jitter is random 0.0..0.1 per run. Use seed for deterministic tests.

Usage

import 'package:driving_conditions/driving_conditions.dart';
import 'package:driving_weather/driving_weather.dart';

final condition = WeatherCondition(
  precipType: PrecipitationType.snow,
  intensity: PrecipitationIntensity.heavy,
  temperatureCelsius: -4,
  visibilityMeters: 180,
  windSpeedKmh: 25,
  iceRisk: false,
  timestamp: DateTime.now(),
);

final assessment = DrivingConditionAssessment.fromCondition(condition);

final simulator = SafetyScoreSimulator();
final score = simulator.simulate(
  speed: 50,
  gripFactor: assessment.gripFactor,
  surface: assessment.surfaceState,
  visibilityMeters: condition.visibilityMeters,
  seed: 42,
);

API Overview

Type	Purpose
DrivingConditionAssessment	Converts a weather condition into surface, grip, visibility, particles, and advisory output.
RoadSurfaceState	Canonical road-surface classification for dry, wet, slush, snow, ice, and standing water.
PrecipitationConfig	Particle-system parameters derived from precipitation type and intensity.
VisibilityDegradation	UI-facing opacity and blur values derived from visibility distance.
SafetyScoreSimulator	Monte Carlo simulator for advisory safety scoring under uncertain conditions.
SimulationBackend / SimulationOptions	Extension points for native or alternative simulation engines.

Validation

Current package status:

• Pure Dart
• 60 passing tests
• Path-dependent monorepo package

See Also

• driving_weather — Weather conditions model (upstream dependency providing WeatherCondition)
• kalman_dr — Dead reckoning through GPS loss (tunnels, urban canyons)
• routing_engine — Engine-agnostic routing (OSRM + Valhalla)
• driving_consent — Privacy consent with Jidoka semantics (UNKNOWN = DENIED)
• fleet_hazard — Fleet telemetry hazard model and geographic clustering
• navigation_safety — Flutter navigation safety state machine and safety overlay
• map_viewport_bloc — Flutter viewport and layer composition state machine
• routing_bloc — Flutter route lifecycle state machine and progress UI
• offline_tiles — Flutter offline tile manager with MBTiles fallback

All ten extracted packages are part of SNGNav, a driver-assisting navigation reference product.

License

BSD-3-Clause — see LICENSE.