@@ -11,19 +11,22 @@ Real-time aircraft pattern detection system that monitors TAR1090 feeds to ident
1111## 🎯 Features
1212
1313### Pattern Detection
14+
1415- ** Circle Detection** : Identifies aircraft flying in circular patterns (training, holding, orbits)
1516- ** Grid Detection** : Detects survey/search grid patterns, mapping flights, and search & rescue operations
1617- ** Real-time Monitoring** : Continuously analyzes aircraft movements from TAR1090 data feeds
1718- ** Historical Tracking** : Maintains comprehensive logs of all detected patterns with TAR1090 replay links
1819
1920### Web Interface
21+
2022- ** Live Map View** : Real-time visualization of aircraft and detected patterns
2123- ** TAR1090-style Icons** : Aircraft displayed with type-appropriate icons and altitude-based coloring
2224- ** Track History** : Flight path visualization with altitude-based color coding
2325- ** Pattern History Page** : Browse and filter all historical pattern detections
2426- ** Interactive Controls** : Toggle aircraft display, tracks, and pattern overlays
2527
2628### Data & Integration
29+
2730- ** CSV Logging** : Automatic logging of all detections for analysis
2831- ** TAR1090 Integration** : Direct links to view patterns in TAR1090 with proper time ranges
2932- ** Multi-source Support** : Works with any TAR1090-compatible data source
@@ -94,27 +97,35 @@ python app.py --server http://your-tar1090:8080 --web
9497### Detection Parameters
9598
9699#### Circle Detection
100+
97101| Variable | Description | Default |
98102| ----------| -------------| ---------|
99103| ` MIN_RADIUS ` | Minimum circle radius (km) | ` 0.5 ` |
100104| ` MAX_RADIUS ` | Maximum circle radius (km) | ` 10 ` |
101105| ` MIN_TURNS ` | Minimum number of turns | ` 1.5 ` |
102106
103107#### Grid Detection
108+
104109| Variable | Description | Default |
105110| ----------| -------------| ---------|
106111| ` MIN_GRID_LEGS ` | Minimum parallel legs | ` 3 ` |
107112| ` MIN_LEG_LENGTH ` | Minimum leg length (km) | ` 2.0 ` |
108113
109114## 🖥️ Web Interface
110115
111- ### Live View (http://localhost:8888)
116+ ### Live View
117+
118+ Access at: ` http://localhost:8888 `
119+
112120- Real-time aircraft positions with TAR1090-style icons
113121- Live pattern detection with visual overlays
114122- Interactive controls for display options
115123- Auto-centering on new pattern detections
116124
117- ### History View (http://localhost:8888/history)
125+ ### History View
126+
127+ Access at: ` http://localhost:8888/history `
128+
118129- Browse all historical pattern detections
119130- Filter by date range, pattern type, and callsign
120131- Visual timeline of detection activity
@@ -124,12 +135,14 @@ python app.py --server http://your-tar1090:8080 --web
124135## 📊 Data Output
125136
126137### CSV Files
138+
127139Pattern detections are automatically logged to CSV files in the data directory:
128140
129141- ` circle_detections.csv ` - All circular pattern detections
130142- ` grid_detections.csv ` - All grid pattern detections
131143
132144### CSV Fields
145+
133146- Timestamp, Aircraft ID, Callsign
134147- Pattern characteristics (radius, turns, coverage area)
135148- Position data (center lat/lon)
@@ -139,7 +152,9 @@ Pattern detections are automatically logged to CSV files in the data directory:
139152## 🐳 Docker Deployment
140153
141154### Multi-Architecture Support
155+
142156The container supports multiple architectures:
157+
143158- ` linux/amd64 ` - Standard x86-64
144159- ` linux/arm64 ` - 64-bit ARM (Raspberry Pi 4, etc.)
145160- ` linux/arm/v7 ` - 32-bit ARM
@@ -201,13 +216,15 @@ Options:
201216## 📈 Pattern Detection Logic
202217
203218### Circle Detection Algorithm
219+
2042201 . Analyzes aircraft track points to identify curved paths
2052212 . Calculates center point and radius of potential circles
2062223 . Counts completed turns (360° rotations)
2072234 . Validates against minimum radius and turn requirements
2082245 . Logs detection with TAR1090 replay link
209225
210226### Grid Detection Algorithm
227+
2112281 . Identifies parallel flight segments
2122292 . Analyzes heading changes between legs
2132303 . Validates grid spacing and coverage area
@@ -249,4 +266,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
249266
250267---
251268
252- Made with ❤️ for the aviation and SDR community
269+ Made with ❤️ for the aviation and SDR community
0 commit comments