Weather and clouds

1/// Fetches hourly weather forecast for the next 16 days (Open-Meteo max)2/// Returns map with hourly arrays for: temperature_2m, relativehumidity_2m, cloudcover, windspeed_10m3/// AC#3: Extended from 7 to 16 days to support +/- 10 day cloud cover window4Future<Map<String, dynamic>> getHourlyForecast(GeoLocation location) async {5  final Response response = await _dio.get(6    '${ApiConfig.weatherBaseUrl}/forecast',7    queryParameters: <String, dynamic>{8      'latitude': location.latitude,9      'longitude': location.longitude,10      'hourly': 'temperature_2m,relativehumidity_2m,cloudcover,windspeed_10m,weathercode',11      'forecast_days': 16, // AC#3: Extended from 7 to 16 (Open-Meteo max)12      'past_days': 10, // AC#3: Include 10 days of historical data13    },14  );1516  if (response.statusCode == 200) {17    final data = response.data;18    final hourly = data['hourly'];19    20    if (hourly != null) {21      return <String, dynamic>{22        'time': (hourly['time'] as List).cast<String>(),23        'temperature': (hourly['temperature_2m'] as List).map((e) => (e as num?)?.toDouble() ?? 0.0).toList(),24        'humidity': (hourly['relativehumidity_2m'] as List).map((e) => (e as num?)?.toDouble() ?? 0.0).toList(),25        'cloudCover': (hourly['cloudcover'] as List).map((e) => (e as num?)?.toDouble() ?? 0.0).toList(),26        'windSpeed': (hourly['windspeed_10m'] as List).map((e) => (e as num?)?.toDouble() ?? 0.0).toList(),27        'weatherCode': (hourly['weathercode'] as List).map((e) => (e as num?)?.toDouble() ?? 0.0).toList(),28      };29    }30  }31  32  throw Exception('Failed to fetch hourly forecast data');33}

1return WeatherNotifier();

1/// SeeingCalculator Service - AC#2, AC#42/// Calculates atmospheric seeing quality using Pickering Scale (1-10) heuristic3/// 4/// **AC#2: Heuristic Calculation Model**5/// The true Pickering scale is observational (astronomer visually assesses star diffraction6/// pattern through telescope). This implementation uses meteorological data as a proxy.7/// 8/// **AC#4: Algorithm Logic**9/// - Base Score: Start at 10 (perfect seeing)10/// - Temperature Gradient Penalty:11///   * variance > 5°C over 3 hours: -2 points (high turbulence)12///   * variance > 3°C over 3 hours: -1 point (moderate turbulence)13/// - Wind Speed Penalty:14///   * wind > 30 km/h: -3 points (severe atmospheric mixing)15///   * wind > 20 km/h: -2 points16///   * wind > 10 km/h: -1 point17/// - Humidity Bonus:18///   * humidity > 70% with stable temp (<3°C variance): +1 point (stable air mass)19/// - Final Score: Clamp to 1-10 range20/// 21/// **Research Citations:**22/// - Pickering, William H. (Harvard College Observatory) - Original seeing scale definition23/// - "Atmospheric Seeing" - Wikipedia (https://en.wikipedia.org/wiki/Astronomical_seeing)24/// - Atmospheric turbulence factors: Temperature gradients, wind shear, humidity25///   (Sources: SPIE, astrobackyard.com)26library;2728class SeeingCalculator {29  /// Calculates Pickering Seeing score (1-10) from hourly weather data30  /// 31  /// AC#4: Input requires at least 3 hours of data for temperature variance calculation32  /// Returns tuple: (score, label)33  /// 34  /// Labels (AC#1):35  /// - 1-2: "Extremely Poor"36  /// - 3-4: "Poor"37  /// - 5-6: "Fair"38  /// - 7-8: "Good"39  /// - 9-10: "Excellent"40  (int, String) calculateSeeing({41    required List<double> temperatures, // Hourly temperatures in °C (AC#3)42    required List<double> windSpeeds,   // Hourly wind speeds in km/h (AC#3)43    required List<double> humidities,   // Hourly humidity percentages (AC#3)44  }) {45    // Validate input data46    if (temperatures.isEmpty || windSpeeds.isEmpty || humidities.isEmpty) {47      return (5, 'Fair'); // Default to middle score if no data48    }4950    // Use current hour (index 0) for instant calculations51    final double currentWind = windSpeeds[0];52    final double currentHumidity = humidities[0];5354    // Calculate temperature variance over 3 hours (AC#4)55    final double tempVariance = _calculateTemperatureVariance(temperatures);5657    // AC#4: Start with base score (perfect seeing)58    int score = 10;5960    // AC#4: Temperature Gradient Penalty61    if (tempVariance > 5.0) {62      score -= 2; // High turbulence63    } else if (tempVariance > 3.0) {64      score -= 1; // Moderate turbulence65    }6667    // AC#4: Wind Speed Penalty68    if (currentWind > 30.0) {69      score -= 3; // Severe atmospheric mixing70    } else if (currentWind > 20.0) {71      score -= 2;72    } else if (currentWind > 10.0) {73      score -= 1;74    }7576    // AC#4: Humidity Bonus (stable air mass)77    if (currentHumidity > 70.0 && tempVariance < 3.0) {78      score += 1;79    }8081    // AC#4: Clamp final score to 1-10 range82    score = score.clamp(1, 10);8384    // AC#1: Map score to descriptive label85    final String label = _getSeeingLabel(score);8687    return (score, label);88  }8990  /// Calculates temperature variance over 3-hour window91  /// Returns maximum temperature difference in °C92  double _calculateTemperatureVariance(List<double> temperatures) {93    if (temperatures.length < 3) {94      // Not enough data for 3-hour window, use available data95      if (temperatures.length == 1) return 0;96      return (temperatures.reduce((double a, double b) => a > b ? a : b) - 97              temperatures.reduce((double a, double b) => a < b ? a : b)).abs();98    }99100    // Use first 3 hours (indices 0, 1, 2)101    final List<double> threeHourData = temperatures.take(3).toList();102    final double maxTemp = threeHourData.reduce((double a, double b) => a > b ? a : b);103    final double minTemp = threeHourData.reduce((double a, double b) => a < b ? a : b);104    105    return (maxTemp - minTemp).abs();106  }107108  /// Maps Pickering score to descriptive label (AC#1)109  String _getSeeingLabel(int score) {110    if (score >= 9) return 'Excellent';  // 9-10111    if (score >= 7) return 'Good';       // 7-8112    if (score >= 5) return 'Fair';       // 5-6113    if (score >= 3) return 'Poor';       // 3-4114    return 'Extremely Poor';              // 1-2115  }116}