FITS Fast Viewer - Benutzerhandbuch
Willkommen beim FITS Fast Viewer! Die extrem performante Windows-Lösung für Astrofotografen, um Unmengen an rohen FITS-Dateien blitzschnell zu sichten und fehlerhafte Aufnahmen vor dem Stacking effektiv auszusortieren.
Hauptziel: Gewinne wertvolle Zeit durch extrem schnelles Laden, automatische Bildstreckung (Auto-Stretch), intelligentes Vorladen (Cache) im Hintergrund und intuitive Tastatursteuerung zur Qualitätssicherung Deiner Astrofotos.
1. Installation & Start
Wichtiger Hinweis: Führe die Software nicht direkt aus dem komprimierten Archiv aus!
- ZIP-Datei entpacken: Lade dir die aktuelle
.zip Datei herunter, mache einen Rechtsklick darauf und wähle "Alle extrahieren...".
- Installer ausführen: Gehe in den neu entpackten Ordner und starte die Datei
FITS_Fast_Viewer_Setup_v1.x.exe per Doppelklick.
- Installation abschließen: Der Setup-Assistent leitet dich durch die Installation (Standard:
C:\Program Files\FITS Fast Viewer). Auf Wunsch wird ein Desktop-Symbol angelegt.
- Anwendung starten: Nach der erfolgreichen Installation kannst du das Programm bequem über das Startmenü oder dein Desktop-Symbol öffnen!
2. Steuerung & Navigation
Die Software ist stark darauf optimiert, ohne Maus nur mit der linken oder rechten Hand an der Tastatur bedient zu werden:
- Leertaste oder Pfeil Rechts: Nächstes Bild (wird im Hintergrund per Multithreading bereits geladen, absolut keine Ladezeit!).
- Pfeil Links: Vorheriges Bild.
- X oder Pfeil Runter: Bild Aussortieren! Erkennt Fehler? Das Bild wird sofort physisch in den Unterordner
_bad_frames verschoben und automatisch das nächste Bild geladen.
Bildansicht (Zoom & Pan in Echtzeit)
- Zoomen: Benutze das Mausrad, um stufenlos in jeden Pixelbereich hinein- oder herauszuzoomen.
- Verschieben (Pan): Halte die linke Maustaste gedrückt und ziehe das vergrößerte Bild umher.
- Zurücksetzen: Ein Doppelklick auf das Bild setzt den Zoom sofort zurück, sodass das gesamte FITS-Bild wieder zu 100% ins Fenster passt.
- Tipp: Dein Zoom-Level und die absolute Position bleiben beim Wechseln zum nächsten Bild präzise bestehen! Das macht den mikroskopischen Vergleich von Sternformen/Nachführfehlern in den Bildecken zum Kinderspiel.
3. Analysetools & Kernfunktionen
Automatische Fehlererkennung (Auto Analysis)
Du kannst die Bilder nicht nur manuell, sondern auch von einem hochentwickelten Algorithmus automatisch prüfen lassen:
- Spürt lang gezogene Satellitengespuren, Flugzeuge ("Trails") oder generelle Verzerrungen (Eier-Sterne durch Wind/Nachführfehler) auf. Reguläre, runde Sterne werden absolut zuverlässig ignoriert.
- Ein Live-Zähler im Hauptmenü protokolliert sofort die fortlaufende Anzahl der fehlerhaften Bilder.
- Die Rechen-Intensive Analyse kann zu jedem Zeitpunkt mit dem Stop-Button sauber abgebrochen werden.
Quick Preview Stack
Markiere Bilder und klicke auf Quick Preview Stack. Das Tool nutzt mathematisches "Phase Correlation Alignment", um die riesigen Dateien blitzschnell zur Veranschaulichung exakt auszurichten und zu einem finalen Summenbild zu verrechnen.
FITS-Metadaten & Bildstatistik (Sky Background)
- Infobox: Lese alle relevanten Kamera- und Teleskopdaten ohne lästiges Scrollen kondensiert am rechten Rand aus dem nativen FITS Header aus.
- Hintergrundhelligkeit (Sky Background) & Sterne: Das Programm berechnet selbst den aktuellen Hintergrund-Wert und die Anzahl der nachgeführten Sterne. Perfekt, um die Wolken-/Mond-Beeinflussung pro Bild zu quantifizieren.
Performance Boost: Diese Messwerte werden unsichtbar als .json gespeichert, sodass beim erneuten Öffnen einer Fotosession alle Statistiken sofort wieder geladen sind, ohne aufwendig neu zu rechnen!
4. Benutzeroberfläche (UI) anpassen
- Zweisprachigkeit: Oben rechts kannst du jederzeit in Echtzeit über die Ländersymbole (🇩🇪 / 🇬🇧) zwischen der englischen und deutschen Benutzeroberfläche navigieren.
- Responsive Scaling: Arbeite am Laptop oder am riesigen Desktop-Monitor: Das Hauptfenster ist in jeder Richtung bis minimal 800x600 Pixel flüssig skalierbar.
5. Versionshistorie (Changelog)
Version 1.2.5
1. März 2026 - Zweisprachigkeit & UI Updates
- Vollständige Zweisprachigkeit (Deutsch / Englisch) der gesamten App. Mit Echtzeit-Flags via UI-Button oben rechts.
- Der Begriff "Aussortieren" wurde aus der Beschreibung des Hintergrunds entfernt, um Verwirrungen in der reinen Anzeige zu verringern.
Version 1.2.3 & 1.2.4
1. März 2026 - Bugfixes Statistics & JSON Caching
- Der Fehler wurde behoben, dass "Sky Background" Statistiken beim Zurückblättern genullt wurden. Die Statistik bleibt nun permanent im RAM pro Session.
- Neue Funktion: Statistiken pro Bild werden ab sofort langlebig als `.json`-Datei im Vorschaubild-Archiv gecached, um das Laden etablierter Sessions radikal zu beschleunigen.
Version 1.2.1 & 1.2.2
1. März 2026 - UI Scaling & Sky Background
- Das Fenster ist nun beliebig responsiv skalierbar. Mindestanforderung: kompakte 800x600 Pixel.
- Das verwirrende Histogramm-Widget im Analyse-Panel wurde entfernt. Stattdessen gibt nun ein klar definierter Text ("Sky Background / Helligkeit des Himmels") eine direkte Einordnung (Klares Bild vs. Mond/Wolkenverdeckt).
Version 1.2.0
28. Februar 2026 - Quick Stack Alignment
- Korrekte Anbindung und Bugfix des "Quick Preview Stack"-Buttons. Die Phase Correlation verrechnet die Rohdaten jetzt absolut exakt zu einem sauberen Sternenfeld-Summenbild.
- Die FITS-Header-Infobox wurde deutlich kompakter ins Design verankert – ohne störende Scrollbalken oder ausufernde Texteite.
Version 1.1.0
27. Februar 2026 - Error Detection Module
- Neuer erweiterter Algorithmus: Der Trail-Detector entscheidet nun sauber zwischen kreisrunden Sternen, Satelliten-Strichen und feinsten Eier-Sternen aus Windstößen.
- Integration einer Stop-Funktion für Analysen, fortlaufende Nummerierung bearbeiteter Dateien und ein Live-Error-Tracker oben im UI.
Version 1.0.0
Initial Release - Core Viewer
- Blitzschnelles Öffnen der riesigen, linearen 16/32-Bit FITS-Dateien via Python-Astropy/OpenCV-Schnittstelle.
- Auto-Stretch der Pixelwerte (Percentile Clipping).
- Multithread-Hintergrund Caching (erlaubt 0 Sekunden Ladezeit beim blättern).
- Zoom & Pan (QGraphicsView) bei 100% Tastatur-Navigierbarkeit (Bild-verwerfen Taste).
- Standalone EXE-Packaging durch PyInstaller/Nuitka implementiert!