RC Log Visualizer – Benutzerhandbuch und Online-Hilfe

1. Ziel und Einsatzbereich dieses Handbuchs #

Dieses Handbuch beschreibt den RC Log Visualizer systemübergreifend. Die Beschreibung ist bewusst allgemein gehalten, damit sie für jede Programmvariante des Visualizers verwendet werden kann. System- oder Herstellernamen werden vermieden; stattdessen wird von der jeweiligen Programmvariante, vom systemeigenen Telemetrie-Importer und von Flightcontroller-/Blackbox-Importen gesprochen.

Der Visualizer ist inzwischen kein reines CSV-Anzeigeprogramm mehr. Er verbindet Import, Datenprüfung, Diagramme, animierte Diagramm-Wiedergabe, Tabellenansicht, Flug-Replay und eine neue Kunstflug-Analyse. Dadurch entsteht ein sehr mächtiges Werkzeug, aber auch ein höherer Erklärungsbedarf. Dieses Dokument dient deshalb als Nachschlagewerk und nicht nur als Kurzanleitung.

Der Name „RC Log Visualizer“ macht deutlich, dass CSV nur noch einer von mehreren Importwegen ist. Je nach Programmvariante verarbeitet das Programm auch systemeigene Telemetrie-Logs, Excel- bzw. Tabellendaten, Flightcontroller- und Blackbox-Logs sowie eigene Replay- und Analyse-Projektdateien.

• für neue Nutzer: Überblick über den Arbeitsablauf und die Reiter
• für Tester: klare Erwartung, welches Ergebnis nach jedem Schritt sichtbar sein sollte
• für fortgeschrittene Nutzer: Erklärung von Projektdateien, Replay-Dateien, Kandidaten, Analysemarkierungen und Experten-CSV
• für spätere Online-Hilfe: Grundlage für verlinkte Stichworte und Suche

2. Grundprinzip des Programms #

Das Programm übernimmt Telemetrie- oder Flightcontroller-Daten, bereitet sie in einer einheitlichen internen Tabellenstruktur auf und stellt sie anschließend in mehreren spezialisierten Reitern dar. Jeder Reiter beantwortet eine andere Frage.

Die Reiter sind bewusst als Arbeitsfolge angeordnet: erst Daten importieren, dann Messwerte prüfen, dann zeitlich oder räumlich abspielen, danach Spezialanalysen durchführen.

3. Datenfluss und interne Bausteine #

Der Visualizer arbeitet mit mehreren Datenebenen. Diese Trennung ist wichtig, weil sie erklärt, warum eine Änderung in der Kunstflug-Analyse nicht den echten Flug verändert und warum ein Analyse-Projekt mehr enthält als eine CSV-Datei.

4. Wichtige Begriffe #

5. Schnellstart: Vom Log zur Auswertung #

Für die normale Arbeit reicht diese Reihenfolge meistens aus:

• 1. Im Reiter Importe die passende Importfunktion wählen.
• 2. Prüfen, ob der Import erfolgreich war und ob die Daten in Diagramm/Tabelle sichtbar sind.
• 3. Im Reiter Diagramm die wichtigsten Messwerte auswählen und den Verlauf prüfen.
• 4. Bei Bedarf im Diagramm-Player die Kurven zeitlich abspielen.
• 5. Im Flug-Replay prüfen, ob GPS/Höhe/Replay plausibel dargestellt werden.
• 6. Bei Kunstflug- oder Trainingslogs im Reiter Kunstflug-Analyse den Gesamtflug ansehen und Kandidaten suchen.
• 7. Wichtige Ergebnisse als Analyse-Projekt speichern.

6. Programmaufbau und Importer #

Der Visualizer besteht aus einem gemeinsamen Kern und mehreren Importwegen. Die jeweilige Programmvariante startet denselben Grundaufbau, verwendet aber einen passenden systemeigenen Importer und passende Standardbezeichnungen.

6.1 Importwege

6.2 Verarbeitung im Hintergrund

• Spaltennamen werden vereinheitlicht, soweit sie bekannt sind.
• Dezimaltrennzeichen und Zahlenformate werden normalisiert.
• Zeitangaben werden in eine nutzbare Zeitachse übertragen.
• GPS-Spalten werden erkannt und in lokale Meter-Koordinaten umgerechnet, sofern möglich.
• Höhe, Geschwindigkeit, Steigen/Sinken und Orientierung werden übernommen oder geschätzt, wenn ausreichend Daten vorhanden sind.
• Für den Replay-Player wird eine flight_replay-Struktur erzeugt.

7. Reiter Importe #

Der Reiter Importe ist der Einstiegspunkt. Hier werden neue Logdateien geladen, vorhandene Einträge aus der Historie geöffnet oder spezielle Importfunktionen genutzt. Ziel ist nicht nur das Einlesen der Datei, sondern die Vorbereitung für alle folgenden Reiter.

7.1 Typische Funktionen

7.2 Erwartung nach erfolgreichem Import

• Im Diagramm sind auswählbare Spalten vorhanden.
• In der Tabelle sind Zeilen und Werte sichtbar.
• Bei GPS-Flügen ist im Flug-Replay eine Strecke sichtbar.
• Bei geeigneten Daten ist eine Replay-Datei erzeugbar oder bereits vorhanden.
• Bei Flightcontroller-Daten können zusätzlich Roll/Nick/Gier für Kunstflug- oder 3D-Ansichten verfügbar sein.

7.3 Häufige Importprobleme

8. Reiter Diagramm #

Der Reiter Diagramm ist die wichtigste technische Messwertansicht. Hier werden Werte über einer X-Achse dargestellt. Typischerweise ist das die Zeit, es können aber auch andere Spalten als X-Achse genutzt werden, sofern die Programmvariante dies anbietet.

8.1 Grundbedienung

• Y-Werte auswählen: Messwerte wählen, die als Kurven dargestellt werden sollen.
• X-Achse prüfen: Meist Zeit; bei Spezialauswertungen auch andere Spalten möglich.
• Diagramm aktualisieren: Kurven werden mit der aktuellen Auswahl neu aufgebaut.
• Zoom: Ausschnitt vergrößern, z. B. per Maus oder Werkzeugleiste.
• Werte ablesen: Mausposition oder Wertanzeige nutzen, um konkrete Messwerte zu prüfen.
• Legende/Farben: Kurven anhand der Legende und Farben unterscheiden.

8.2 Eigene Y-Achsen

Mehrere Messwerte haben oft sehr unterschiedliche Wertebereiche. Höhe, Spannung, Geschwindigkeit und Steigen lassen sich auf einer gemeinsamen Y-Skala nur schwer vergleichen. Eigene Y-Achsen erzeugen pro Kurve oder Kurvengruppe getrennte Skalen.

8.3 Separate Diagrammansicht

Für Detailarbeit kann das Diagramm in einem separaten Fenster geöffnet werden, sofern die Programmvariante diese Funktion anbietet. Das ist besonders sinnvoll auf kleinen Bildschirmen oder bei mehreren Kurven.

8.4 Erwartetes Ergebnis

• Die ausgewählten Kurven sind sichtbar und eindeutig unterscheidbar.
• Die Achsen passen zu den angezeigten Messwerten.
• Beim Wechsel der Y-Werte verschwinden alte Kurven und alte Zusatzachsen vollständig.
• Zoom und Werteanzeige erlauben Detailkontrolle einzelner Flugabschnitte.

9. Reiter Diagramm-Player #

Der Diagramm-Player ist eine animierte Diagrammansicht. Er beantwortet die Frage, wie sich mehrere Messwerte im zeitlichen Ablauf verändern. Während der normale Diagramm-Reiter eher statisch analysiert, legt der Diagramm-Player den Fokus auf Abspielen, Zeitcursor und aktuelle Werte.

9.1 Grundfunktionen

9.2 Datenübernahme

Der Diagramm-Player nutzt die im Diagramm oder im importierten Flug vorhandenen Daten. Je nach Programmstand können entweder nur die aktuellen Diagrammspalten oder alle verfügbaren Diagrammdaten übernommen werden. Ziel ist, dass der Player keine eigene Importlogik benötigt, sondern dieselbe Datenbasis nutzt.

9.3 Erwartetes Ergebnis

• Beim Abspielen wandern die Kurven relativ zum Zeitcursor oder der Cursor zeigt eindeutig den aktuellen Zeitpunkt.
• Die Wertebox aktualisiert sich synchron.
• Die Zeitachse wird verständlich dargestellt, bevorzugt in Minuten oder mit klarer Sekundenanzeige.
• Eigene Y-Achsen und Nullachsen-Optionen verhalten sich konsistent zum normalen Diagramm.

10. Reiter Tabelle #

Die Tabelle zeigt die importierten und berechneten Werte zeilenweise. Sie ist die Kontrollansicht für alle automatischen Erkennungen. Wenn Diagramm oder Replay ungewöhnlich aussehen, sollte die Tabelle geprüft werden.

10.1 Typische Nutzung

• Prüfen, ob Zeitspalten korrekt gefüllt sind.
• Prüfen, ob GPS, Höhe, Geschwindigkeit und Steigen plausible Werte enthalten.
• Spaltennamen kontrollieren, wenn eine automatische Zuordnung nicht funktioniert.
• Auffällige Werte, Lücken oder falsche Einheiten erkennen.
• Bei generischem Import nachvollziehen, welche Spalten übernommen wurden.

10.2 Erwartetes Ergebnis

• Die Tabelle enthält mindestens Zeit und eine oder mehrere Messwertspalten.
• Bei Replay-fähigen Flügen sind GPS oder lokale Koordinaten vorhanden.
• Bei Kunstflug-/FC-Analysen sind idealerweise Roll/Nick/Gier oder ableitbare Orientierungswerte vorhanden.

11. Reiter Flug-Replay #

Der Reiter Flug-Replay stellt den Flug räumlich dar. Er ist die Brücke zwischen Tabellen-/Diagrammdaten und räumlicher Flugauswertung. Je nach Datenlage kann der Flug in 2D, als exportierte Replay-Datei oder im 3D-Player dargestellt werden.

11.1 2D-Überblick

Die 2D-Ansicht zeigt die Flugbahn aus der Vogelperspektive oder in einer Karten-/Streckenansicht. Sie ist der erste Plausibilitätscheck: Startpunkt, Flugrichtung, Ausdehnung und GPS-Sprünge sind hier schnell erkennbar.

11.2 3D-Player

Der 3D-Player verwendet eine Replay-Datei mit lokalen Koordinaten, Höhe und Orientierung. Er kann verschiedene Blickrichtungen anbieten, z. B. Bodenansicht, Verfolgungsmodus oder Pilotensicht. Je nach Programmstand stehen zusätzlich Modellwahl, HUD, Empfangswerte, Warnungen und Terrain-/Höhenlogik zur Verfügung.

11.3 Erwartetes Ergebnis

• Der Flug erscheint an einer plausiblen Position und Höhe.
• Start und Landung liegen nicht unbegründet unter dem Terrain.
• Bei fehlenden GPS-Daten gibt es eine verständliche Warnung statt eines Absturzes.
• Die räumliche Darstellung passt grundsätzlich zum Diagramm und zur Tabelle.

12. Reiter Kunstflug-Analyse #

Die Kunstflug-Analyse ist eine Spezialauswertung für räumliche Flugbeurteilung, Trainingsauswertung und die strukturierte Nachanalyse von Figurenabschnitten. Sie ergänzt Diagramm, Tabelle und Flug-Replay. Sie verändert den Originalflug nicht, sondern ergänzt nur Analyseinformationen.

12.1 Grundprinzip

• Der Rohflug bleibt immer unverändert.
• Kandidaten sind automatische Vorschläge für auffällige Abschnitte.
• Analysemarkierungen sind übernommene oder manuell gesetzte Abschnitte.
• Das Analyse-Projekt speichert Flugbahn, Markierungen und Kandidaten gemeinsam.
• Die Experten-CSV dient nur dem Datenaustausch und enthält nicht die vollständige Analyse.

12.2 Arbeitsablauf im Reiter

12.3 Flugüberblick und geladener Flug

Der Bereich „So nutzt man die Kunstflug-Analyse“ und „Flugüberblick“ ist der Einstieg. Er zeigt den geladenen Zustand, den nächsten Schritt und die wichtigsten Schaltflächen.

12.4 Detail zum aktuellen Punkt

Der Bereich zeigt den aktuell ausgewählten oder abgespielten Punkt mit Zeit, Position, Höhe, Roll/Nick/Gier, Speed/Steigen und Hinweisen zum Kunstflugfenster.

12.5 Ansichten für den Gesamtüberblick

Die Ansichtsschalter bestimmen den Blickwinkel. Für den Start eignen sich 3D oder Box oben 2D, danach ergänzend Richter-Sicht 2D.

12.6 Kandidaten finden und prüfen

Die Kandidatensuche ist bewusst vorsichtig. Bei normalen Strecken-, Thermik- oder Trainingsflügen ohne Kunstflug sind wenige oder keine Kandidaten erwartbar.

• Kandidaten suchen startet die automatische Suche.
• Kandidat anzeigen hebt den Vorschlag hervor.
• Kandidat abspielen spielt den Abschnitt ab.
• Übernehmen wandelt den Kandidaten in eine Analysemarkierung um.
• Verwerfen entfernt einen ungeeigneten Kandidaten.

12.7 Übernommene Analysemarkierungen

Analysemarkierungen sind bestätigte oder manuell gesetzte Abschnitte. Start und Ende können anhand des aktuellen Punkts gesetzt und anschließend gespeichert werden.

12.8 Fokus, Zoom und Darstellung

Mit diesen Optionen wechselt der Nutzer zwischen Gesamtflug, aktuellem Abschnitt, aktuellem Punkt, Wettbewerbsfenster und Replay-Spur.

12.9 Player sowie Speichern / Laden

Für normale Nutzer ist fast immer das Analyse-Projekt relevant. Es speichert Rohflug, Analysemarkierungen und Kandidaten gemeinsam.

Sobald die Checkbox aktiv ist, erscheinen die Buttons „CSV exportieren…“ und „CSV importieren…“. Diese CSV enthält nur die Flugbahn-Tabelle, aber nicht die komplette Analyse.

12.10 Separates Analysefenster

Die Kunstflug-Analyse kann in einem separaten, verschiebbaren und größenänderbaren Fenster geöffnet werden. Änderungen aus diesem Fenster können in das Hauptfenster übernommen werden.

12.11 Zusammenfassung für normale Nutzer

• Zuerst den Gesamtflug ansehen.
• Dann Kandidaten suchen.
• Gute Kandidaten prüfen und übernehmen.
• Markierungen bei Bedarf manuell korrigieren.
• Am Ende das Analyse-Projekt speichern.
• Die Experten-CSV nur für Datenaustausch oder Fehlersuche benutzen.

13. Unterstützte Dateiformate, Dateitypen und Speichern/Laden #

Das Programm verwendet mehrere Dateitypen. Für das Verständnis der Arbeitslogik ist es wichtig, Eingangsformate, interne Replay-Dateien, Analyse-Projekte und CSV-Exporte sauber zu unterscheiden.

13.1 Welche Dateien kann das Programm verarbeiten?

Die folgende Übersicht beschreibt die typischen Dateigruppen. Der genaue Umfang hängt von der jeweiligen Programmvariante, vom eingebauten Importdialog und von vorhandenen Decodern ab. Maßgeblich ist immer der Dateifilter bzw. die Schaltfläche im Importdialog.

14. Typische Arbeitsabläufe #

14.1 Normaler Telemetrieflug

• Log importieren.
• Diagramm öffnen und wichtige Werte auswählen: Höhe, Geschwindigkeit, Spannung, Empfang, Vario usw.
• Auffällige Stellen im Diagramm zoomen.
• Tabelle prüfen, wenn Werte nicht plausibel sind.
• Flug-Replay öffnen, wenn GPS vorhanden ist.
• Kunstflug-Analyse nur verwenden, wenn Figuren oder räumliche Trainingsbewertung interessant sind.

14.2 Flightcontroller-/Blackbox-Log

• Rohlog importieren oder dekodieren lassen.
• Bei großen Dateien Fortschritt abwarten.
• Diagramm prüfen, ob Zeit, Höhe, Speed, Roll/Nick/Gier plausibel sind.
• Flug-Replay prüfen.
• Kunstflug-Analyse öffnen und Kandidaten suchen.
• Kandidaten nur übernehmen, wenn sie im Plot und beim Abspielen plausibel wirken.

14.3 Kunstflugtraining

• Replay-Flug übernehmen oder Demo-Kunstflug laden.
• Gesamtflug in 3D und in Box oben 2D ansehen.
• Kandidaten suchen.
• Jeden Kandidaten anzeigen und abspielen.
• Gute Kandidaten übernehmen; Start/Ende bei Bedarf korrigieren.
• Markierungen benennen und als Figurtyp markieren.
• Analyse-Projekt speichern.

14.4 Test ohne echten Kunstfluglog

• Demo-Kunstflug laden.
• Kandidaten suchen lassen.
• Looping, Rolle, Humpty und Kurve prüfen.
• Ansichten und Wettbewerbsfenster testen.
• Nicht mit echter Bewertung verwechseln: Demo dient nur zur Funktionskontrolle.

15. Wichtige Einstellungen und Anzeigen #

16. Plausibilitätsprüfung #

Vor jeder tieferen Analyse sollte geprüft werden, ob die Daten plausibel sind. Viele scheinbare Programmfehler entstehen durch fehlende oder falsch erkannte Eingangsdaten.

17. Fehlersuche und typische Fragen #

18. Hinweise für Tester #

Tester sollten nicht nur prüfen, ob ein Programm startet, sondern auch, ob die erwartete Logik je Reiter eingehalten wird.

• Import: Wird die Datei geladen und erscheint ein Status? Gibt es verständliche Fehlermeldungen?
• Diagramm: Sind Kurven, Achsen und Zoom plausibel?
• Diagramm-Player: Läuft der Zeitcursor synchron zu den Werten?
• Tabelle: Stimmen Spalten und Werte mit dem Log überein?
• Flug-Replay: Stimmen Lage, Höhe und Startpunkt grob?
• Kunstflug-Analyse: Bleibt der Rohflug unverändert? Werden Kandidaten nur als Vorschläge behandelt?
• Separate Fenster: Sind sie verschiebbar, größenänderbar und besitzen normale Fenstersteuerungen?

19. Online-Hilfe, Suche und Verlinkung #

Für eine Online-Version sollte dieses Handbuch in Abschnitte mit eindeutigen Ankern unterteilt werden. Ein Suchfeld kann Überschriften, Fließtext und Stichworte durchsuchen. Das Stichwortregister am Ende sollte auf die passenden Abschnitte verlinken.

• Suchfeld oben auf der Seite.
• Inhaltsverzeichnis mit Sprungmarken.
• Stichwortregister am Ende mit Links auf relevante Abschnitte.
• Abschnitte kurz genug halten, damit Suchtreffer übersichtlich bleiben.
• Screenshots später ergänzen, wenn die Oberfläche endgültig stabil ist.

20. Stichwortregister #

Dieses Register ist für die Online-Version als verlinkte Stichwortsuche gedacht. In der Word-/PDF-Version dient es als Nachschlagehilfe.