Solve-Field-GUI/README.md

Solve-Field-GUI

Grafische Windows-Oberfläche für solve-field aus Astrometry.net mit Ausführung auf einem Linux-Server per SSH.

Die Software richtet sich an Anwender, die Astrometrie komfortabel über eine GUI steuern möchten, ohne die solve-field-Befehle jedes Mal von Hand zusammenzubauen.

Was die Software macht

Die Anwendung läuft lokal unter Windows und verbindet sich per SSH mit einem entfernten Linux-Server.

Dort kann sie:

• Bilddateien auf den Server hochladen
• solve-field mit vielen Parametern starten
• die Ausgabe live im Log anzeigen
• Ergebnisdateien im Remote-Verzeichnis anzeigen
• einzelne oder mehrere Ergebnisdateien wieder lokal herunterladen
• Serverfunktionen wie SExtractor-Prüfung und Diagnose ausführen

Hauptfunktionen

• SSH-Verbindung zu einem Linux-Server mit Benutzername, Passwort und Port
• Upload lokaler Bilddateien per SFTP
• grafische Konfiguration fast aller wichtigen solve-field-Parameter
• automatische Befehlsvorschau des erzeugten solve-field-Aufrufs
• Unterstützung für Maßstab, RA/Dek, Suchradius, Downsampling, CPU-Limit, Tweak-Order und viele weitere Optionen
• Unterstützung für Source Extractor per --use-source-extractor
• automatische Berechnung von --plot-scale aus der lokalen Bildgröße
• serverseitige Diagnose für solve-field, astrometry.cfg, Indexdateien, SExtractor und Speicherplatz
• Remote-Ergebnis-Tab mit Dateiliste
• Mehrfachdownload ausgewählter Ergebnisdateien
• Profilspeicherung und Profilladen für komplette GUI-Einstellungen

Unterstützte Dateitypen

Als Eingabedatei lokal:

• FITS
• FIT
• FTS
• JPG / JPEG
• PNG
• TIFF / TIF

Für die automatische Plot-Skalierung kann die Anwendung Bildgrößen direkt aus mehreren Formaten lesen, darunter FITS, PNG, JPG, GIF und BMP.

Voraussetzungen

Lokal unter Windows

• Python 3
• asyncssh
• Netzwerkzugriff auf den Linux-Server per SSH

Installation von asyncssh:

pip install asyncssh

Auf dem Linux-Server

• Astrometry.net mit solve-field
• passende Indexdateien
• SSH-Zugang

Optional:

• source-extractor, wenn SExtractor zur Quellenerkennung genutzt werden soll

Starten

Direkt mit Python:

python astrometry_gui.py

Oder unter Windows über:

astrometry_gui.bat

Bedienung

1. SSH eintragen

Oben in der GUI:

• Host
• Port
• Benutzer
• Passwort

Mit Verbinden & testen kann geprüft werden, ob der Server erreichbar ist und solve-field vorhanden ist.

2. Bild auswählen und hochladen

Im Tab Input / Output:

• lokale Datei auswählen
• Remote-Verzeichnis festlegen
• Datei per Hochladen auf den Server übertragen

Nach dem Upload wird der Remote-Dateipfad automatisch als Eingabedatei gesetzt.

3. Solver-Parameter einstellen

Je nach Bedarf können unter anderem gesetzt werden:

• Maßstabsbereich
• RA / Dek / Radius
• CPU-Limit
• Downsampling
• Plot-Skalierung
• Tweak-Order
• Verifikation
• Invertierung
• SExtractor-Nutzung

4. Befehl prüfen und starten

Im Tab Befehlsvorschau sieht man den tatsächlich erzeugten solve-field-Befehl.

Mit solve-field starten wird der Befehl auf dem Server ausgeführt.

Tabs im Überblick

Input / Output

• lokale Bilddatei
• Remote-Verzeichnis
• Upload
• Eingabedatei auf dem Server
• Ausgabeoptionen wie --wcs, --corr, --rdls, --match, --new-fits

Maßstab & Position

• --scale-low
• --scale-high
• --scale
• --scale-err
• --ra
• --dec
• --radius

Solver-Parameter

• --depth
• --cpulimit
• --plot-scale
• --downsample
• --tweak-order
• --odds-*
• --objs
• --pixel-error
• zahlreiche Flags wie --no-plots, --invert, --no-verify

Zusätzlich gibt es einen Plot-Helfer:

• automatische Berechnung von plot-scale
• Zielkantenlänge einstellbar

Erweitert

• manuelle Indexdateien
• zusätzliche freie Kommandozeilenargumente

Befehlsvorschau

• zeigt den generierten Befehl
• kann aktualisiert werden
• kann in die Zwischenablage kopiert werden

Server Setup

• SExtractor prüfen
• SExtractor installieren
• Server-Diagnose ausführen

Remote-Ergebnisse

• zeigt Dateien im aktuellen Remote-Verzeichnis
• lädt den Inhalt beim Öffnen des Tabs automatisch neu
• erlaubt Auswahl und Download von einer oder mehreren Dateien

Remote-Ergebnisse herunterladen

Im Tab Remote-Ergebnisse:

• eine oder mehrere Dateien markieren
• Herunterladen klicken
• Zielordner auswählen

Standardmäßig wird als Zielordner der Ordner der ursprünglich lokal ausgewählten Bilddatei vorgeschlagen.

Remote-Verzeichnis leeren

Im Tab Input / Output gibt es die Funktion:

• Remote-Inhalt löschen

Dabei wird nur der Inhalt des Remote-Verzeichnisses gelöscht, nicht das Verzeichnis selbst.

Profile speichern und laden

Über die Menühleiste:

• Profil -> Profil speichern…
• Profil -> Profil laden…

Gespeichert werden:

• SSH-Daten
• Solver-Parameter
• Ein-/Ausgabe-Einstellungen
• Zusatzargumente
• Indexliste

Das Passwort wird nicht im Klartext gespeichert, sondern mit einer einfachen internen Verschlüsselung abgelegt.

Typischer Workflow

1. Serververbindung eintragen
2. Lokales Bild auswählen
3. Datei hochladen
4. Maßstab und Solver-Parameter setzen
5. Optional SExtractor aktivieren
6. solve-field starten
7. Ergebnisse im Tab Remote-Ergebnisse prüfen
8. Gewünschte Dateien lokal herunterladen

Hinweise

• Die GUI baut nur den Befehl und führt ihn per SSH aus. Die eigentliche Astrometrie läuft vollständig auf dem Server.
• Die installierte Astrometry-Version auf dem Server bestimmt, welche Optionen tatsächlich verfügbar sind.
• Für SExtractor muss auf dem Server in der Regel source-extractor installiert sein.
• Für gute Ergebnisse müssen die passenden Indexdateien serverseitig vorhanden und in astrometry.cfg korrekt eingebunden sein.

Dateien im Projekt

• astrometry_gui.py
• astrometry_gui.bat

Lizenz / Nutzung

Dieses Repository enthält eine GUI zur Bedienung von Astrometry.net. Die Lizenz und Bedingungen von Astrometry.net sowie von eventuell installierten Serverpaketen gelten zusätzlich zu diesem Projekt.