Implement server-side trail tracking and fix aircraft marker orientation

- Replace client-side trail collection with server-provided position history
- Fix aircraft markers to properly orient based on track heading using SVG rotation
- Add beast-dump binary to debian package with comprehensive man pages
- Trail visualization now uses gradient effect where newer positions are brighter
- Marker icons update when track heading changes by more than 5 degrees for performance

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Ole-Morten Duesund 2025-08-24 15:18:51 +02:00
commit da4645d483
5 changed files with 231 additions and 32 deletions

95
debian/usr/share/man/man1/beast-dump.1 vendored Normal file
View file

@ -0,0 +1,95 @@
.TH BEAST-DUMP 1 "2024-08-24" "SkyView 2.0.0" "User Commands"
.SH NAME
beast-dump \- Utility for analyzing raw ADS-B data in Beast binary format
.SH SYNOPSIS
.B beast-dump
[\fIOPTIONS\fR] [\fIFILE\fR]
.SH DESCRIPTION
beast-dump is a command-line utility for analyzing and decoding ADS-B
(Automatic Dependent Surveillance-Broadcast) data stored in Beast binary
format. It can read from files or connect to Beast format TCP streams
to decode and display aircraft messages.
.PP
The Beast format is a compact binary representation of Mode S/ADS-B
messages commonly used by dump1090 and similar software-defined radio
applications for aircraft tracking.
.SH OPTIONS
.TP
.B \-host \fIstring\fR
Connect to TCP host instead of reading from file
.TP
.B \-port \fIint\fR
TCP port to connect to (default 30005)
.TP
.B \-format \fIstring\fR
Output format: text, json, or csv (default "text")
.TP
.B \-filter \fIstring\fR
Filter by ICAO hex code (e.g., "A1B2C3")
.TP
.B \-types \fIstring\fR
Message types to display (comma-separated)
.TP
.B \-count \fIint\fR
Maximum number of messages to process
.TP
.B \-stats
Show statistics summary
.TP
.B \-verbose
Enable verbose output
.TP
.B \-h, \-help
Show help message and exit
.SH EXAMPLES
.TP
Analyze Beast format file:
.B beast-dump data.bin
.TP
Connect to live Beast stream:
.B beast-dump \-host localhost \-port 30005
.TP
Export to JSON format with statistics:
.B beast-dump \-format json \-stats data.bin
.TP
Filter messages for specific aircraft:
.B beast-dump \-filter A1B2C3 \-verbose data.bin
.TP
Process only first 1000 messages as CSV:
.B beast-dump \-format csv \-count 1000 data.bin
.SH OUTPUT FORMAT
The default text output shows decoded message fields:
.PP
.nf
ICAO: A1B2C3 Type: 17 Time: 12:34:56.789
Position: 51.4700, -0.4600
Altitude: 35000 ft
Speed: 450 kt
Track: 090°
.fi
.PP
JSON output provides structured data suitable for further processing.
CSV output includes headers and is suitable for spreadsheet import.
.SH MESSAGE TYPES
Common ADS-B message types:
.IP \(bu 2
Type 4/20: Altitude and identification
.IP \(bu 2
Type 5/21: Surface position
.IP \(bu 2
Type 9/18/22: Airborne position (baro altitude)
.IP \(bu 2
Type 10/18/22: Airborne position (GNSS altitude)
.IP \(bu 2
Type 17: Extended squitter ADS-B
.IP \(bu 2
Type 19: Military extended squitter
.SH FILES
Beast format files typically use .bin or .beast extensions.
.SH SEE ALSO
.BR skyview (1),
.BR dump1090 (1)
.SH BUGS
Report bugs at: https://github.com/skyview/skyview/issues
.SH AUTHOR
SkyView Team <admin@skyview.local>