Meteor Detection System Enhancements

This document provides an overview of the recent enhancements made to the meteor detection system, focusing on advanced features for video processing, frame analysis, and data sharing.

Meteor Detection System Enhancements

CAMS FTP Format Implementation

The CAMS FTP format is a specialized technique for meteor detection that compresses 256 consecutive video frames into 4 feature images that preserve key information needed for analysis:

maxpixel: Records maximum brightness value across frames
avepixel: Calculates average brightness (excluding maximum)
stdpixel: Computes standard deviation (excluding maximum)
maxframe: Records which frame contained the maximum value

Our implementation provides a complete, optimized solution for generating these feature images, allowing for efficient storage and analysis of large volumes of video data.

Detailed Documentation: CAMS FTP Format

Watermark Overlay System

The watermark overlay system adds critical contextual information directly onto video frames, including:

Precise timestamps
GPS coordinates and camera orientation
Environmental data (temperature, humidity)
Custom text

This feature ensures that all scientific observations are properly annotated with metadata for validation and analysis. The system is highly configurable, allowing for different positioning, formatting, and content.

Detailed Documentation: Watermark Overlay

Frame Hook System

The frame hook system provides a flexible framework for processing video frames at different stages in the pipeline. It allows for:

Adding modular frame processing capabilities
Enabling/disabling processing features at runtime
Implementing custom processing hooks
Organizing hooks in a priority-based execution order

This extensible architecture enables easy addition of new video processing features without modifying core application code.

Detailed Documentation: Hook System

RTSP Streaming

The RTSP streaming system broadcasts live video feeds over a network using the industry-standard Real-Time Streaming Protocol. Features include:

Multiple quality presets (Low, Medium, High, Custom)
Configurable network settings (port, mount point)
Optional authentication
Runtime configuration updates

This enables remote monitoring, collaborative observation, and integration with other systems that support standard video streaming protocols.

Detailed Documentation: RTSP Streaming

System Integration

All of these enhancements are fully integrated into the meteor detection system:

Data Flow:
- Camera frames → Frame hooks (including watermark) → Detection pipeline → CAMS format processing → RTSP streaming
Shared Resources:
- GPS data is used for both watermark overlay and meteor trajectory calculations
- Environmental data is used for both watermarking and sensor calibration
- Frame buffer is shared between detection and streaming systems
Configuration:
- All new features are configurable through the central configuration system
- Default settings provide sensible values for most deployments
- Settings can be changed at runtime for many features

Configuration Options

The enhancements are configured through the application's main configuration file:

# Configuration for watermark overlay
[watermark]
enabled = true
position = "BottomLeft"  # "TopLeft", "TopRight", "BottomLeft", "BottomRight", or [x, y] custom position
font_scale = 0.6
thickness = 1
color = [255, 255, 255, 255]  # White (BGRA)
background = true
background_color = [0, 0, 0, 128]  # Semi-transparent black (BGRA)
padding = 8
content = ["Timestamp", "GpsCoordinates", "Environment"]  # Can also include "CameraOrientation" or "Custom"
time_format = "%Y-%m-%d %H:%M:%S%.3f"
coordinate_format = "decimal"  # "decimal" or "dms"
temperature_format = "C"  # "C" or "F"

# Configuration for RTSP streaming
[rtsp]
enabled = true
port = 8554
mount_point = "/meteor"
quality = "Medium"  # "Low", "Medium", "High", or "Custom"
custom_width = 1280  # Only used if quality = "Custom"
custom_height = 720  # Only used if quality = "Custom"
custom_bitrate = 1500  # In kbps, only used if quality = "Custom"
custom_framerate = 30  # Only used if quality = "Custom"
username = "admin"  # Optional
password = "password"  # Optional

# Configuration for frame stacking
[detection.stacker]
frames_per_stack = 256
save_stacked_frames = true
output_directory = "data/stacked"
write_fits = false
max_pixel_value = 255

Conclusion

These enhancements significantly expand the capabilities of the meteor detection system, adding critical features for scientific observation, data preservation, and collaboration. The modular design ensures that these features can be further extended and customized as needed, while the comprehensive documentation provides clear guidance for both users and developers.

5.4 KiB Raw Permalink Blame History