Kleinigkeiten
This commit is contained in:
@@ -0,0 +1,248 @@
|
||||
# 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`:
|
||||
|
||||
```bash
|
||||
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:
|
||||
|
||||
```bash
|
||||
python astrometry_gui.py
|
||||
```
|
||||
|
||||
Oder unter Windows über:
|
||||
|
||||
```bash
|
||||
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](C:/Users/ich/source/repos/Solve-Field-GUI/astrometry_gui.py)
|
||||
- [astrometry_gui.bat](C:/Users/ich/source/repos/Solve-Field-GUI/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.
|
||||
Reference in New Issue
Block a user