Update utils.py

utils.py

@@ -1,10 +1,11 @@
 """
-Utility functions for LabelIt! application
+Enhanced utility functions for LabelIt! application with real-time analytics
 """
 
 import json
 import os
 from PIL import Image
+from collections import Counter
 
 def load_users():
     """Load users from JSON file"""
@@ -73,4 +74,171 @@ def get_categories():
         'Nature',
         'People',
         'Transportation'
-    ]
+    ]
+
+def calculate_statistics():
+    """Calculate comprehensive real-time statistics for the analytics dashboard"""
+    users = load_users()
+    labels_data = load_labels()
+    
+    # Basic counts
+    total_users = len(users)
+    total_images = len(labels_data)
+    
+    # Count total labels across all images
+    total_labels = 0
+    languages_used = set()
+    language_breakdown = Counter()
+    category_breakdown = Counter()
+    
+    # Location-based statistics
+    images_with_location = 0
+    gps_accuracy_breakdown = Counter()
+    location_methods = Counter()
+    country_breakdown = Counter()
+    city_breakdown = Counter()
+    
+    for entry_data in labels_data.values():
+        # Count labels for this image
+        image_labels = entry_data.get('labels', [])
+        total_labels += len(image_labels)
+        
+        # Track languages used
+        for label in image_labels:
+            lang = label.get('language', 'unknown')
+            languages_used.add(lang)
+            language_breakdown[lang] += 1
+        
+        # Track categories
+        category = entry_data.get('category', 'Unknown')
+        category_breakdown[category] += 1
+        
+        # Track location data
+        location = entry_data.get('location')
+        if location and location.get('latitude'):
+            images_with_location += 1
+            
+            # Track location capture method
+            method = location.get('method', 'Unknown')
+            location_methods[method] += 1
+            
+            # Track GPS accuracy levels
+            accuracy = location.get('accuracy')
+            if accuracy is not None:
+                if accuracy <= 10:
+                    gps_accuracy_breakdown['High'] += 1
+                elif accuracy <= 50:
+                    gps_accuracy_breakdown['Medium'] += 1
+                else:
+                    gps_accuracy_breakdown['Low'] += 1
+            else:
+                gps_accuracy_breakdown['Unknown'] += 1
+            
+            # Track countries and cities
+            country = location.get('country')
+            if country:
+                country_breakdown[country] += 1
+            
+            city = location.get('city')
+            if city:
+                city_breakdown[city] += 1
+    
+    return {
+        'total_users': total_users,
+        'total_images': total_images,
+        'total_labels': total_labels,
+        'languages_used': len(languages_used),
+        'language_breakdown': dict(language_breakdown),
+        'category_breakdown': dict(category_breakdown),
+        'images_with_location': images_with_location,
+        'gps_accuracy_breakdown': dict(gps_accuracy_breakdown),
+        'location_methods': dict(location_methods),
+        'country_breakdown': dict(country_breakdown),
+        'city_breakdown': dict(city_breakdown)
+    }
+
+def get_location_accuracy_level(accuracy):
+    """Determine location accuracy level based on accuracy value"""
+    if accuracy is None:
+        return "Unknown", "#95a5a6"
+    
+    if accuracy <= 10:
+        return "High", "#27ae60"
+    elif accuracy <= 50:
+        return "Medium", "#f39c12"
+    else:
+        return "Low", "#e74c3c"
+
+def format_location_display(location_data):
+    """Format location data for display"""
+    if not location_data or not location_data.get('lat'):
+        return "📍 Location not available"
+    
+    lat = location_data['lat']
+    lon = location_data['lon']
+    method = location_data.get('method', 'Unknown')
+    accuracy = location_data.get('accuracy')
+    
+    # Method icon
+    method_icons = {
+        'GPS': '🛰️',
+        'IP': '🌐',
+        'Manual': '📝'
+    }
+    method_icon = method_icons.get(method, '📍')
+    
+    # Base location string
+    location_str = f"{method_icon} {lat:.6f}, {lon:.6f}"
+    
+    # Add accuracy if available
+    if accuracy:
+        level, _ = get_location_accuracy_level(accuracy)
+        location_str += f" (±{accuracy:.0f}m - {level} Accuracy)"
+    
+    # Add city/country if available
+    if location_data.get('city') and location_data.get('country'):
+        location_str += f" - {location_data['city']}, {location_data['country']}"
+    
+    return location_str
+
+def validate_coordinates(lat, lon):
+    """Validate latitude and longitude coordinates"""
+    try:
+        lat = float(lat)
+        lon = float(lon)
+        
+        if -90 <= lat <= 90 and -180 <= lon <= 180:
+            return True, lat, lon
+        else:
+            return False, None, None
+    except (ValueError, TypeError):
+        return False, None, None
+
+def get_user_contribution_stats(username):
+    """Get contribution statistics for a specific user"""
+    labels_data = load_labels()
+    
+    user_stats = {
+        'images_uploaded': 0,
+        'labels_added': 0,
+        'languages_contributed': set(),
+        'categories_contributed': set()
+    }
+    
+    for entry_data in labels_data.values():
+        # Check if user uploaded this image
+        if entry_data.get('uploaded_by') == username:
+            user_stats['images_uploaded'] += 1
+            user_stats['categories_contributed'].add(entry_data.get('category', 'Unknown'))
+        
+        # Check labels added by this user
+        for label in entry_data.get('labels', []):
+            if label.get('added_by') == username:
+                user_stats['labels_added'] += 1
+                user_stats['languages_contributed'].add(label.get('language', 'unknown'))
+    
+    # Convert sets to counts
+    user_stats['languages_contributed'] = len(user_stats['languages_contributed'])
+    user_stats['categories_contributed'] = len(user_stats['categories_contributed'])
+    
+    return user_stats