🌌 Galaxy Finder

Galaxy Finder è un software astronomico sviluppato in Python (PyQt5 + Astropy + Pandas) che consente di filtrare, analizzare ed esportare oggetti celesti (galassie) da cataloghi locali e integrati come PGC, UGC, NGC e IC.
Il programma è pensato per gli astrofili e i ricercatori che desiderano pianificare sessioni osservative e selezionare le galassie più adatte in base a posizione, magnitudine e visibilità.

---

🚀 Funzionalità principali

• Lettura automatica dei cataloghi:
  • galaxy.xls (catalogo interno personalizzato)
  • pgc.dat, ugc.dat, ngc.dat (cataloghi estesi)
• Calcolo in tempo reale di altezza sull’orizzonte, distanza dalla Luna e posizione cardinale (N/E/S/O)
• Filtro per magnitudine, direzione di osservazione, altitudine minima e massima
• Filtro per cataloghi selezionabili (PGC, UGC, NGC/IC)
• Esportazione dei risultati in diversi formati:
  • Voyager → TARGET;RA;DEC;PA;ORDINE
  • N.I.N.A / Telescopius → CSV standard per import diretto
  • CSV generico → compatibile con Excel e altri software

---

🖥️ Interfaccia

L’interfaccia, moderna e intuitiva, include:

• Campi di input per latitudine, longitudine e orario UTC
• Parametri configurabili per altezza minima per direzione e distanza minima dalla Luna
• Barra di avanzamento con stato di caricamento dei cataloghi
• Tabella dinamica dei risultati (RA, DEC, Mag, Alt, Lato, Distanza Luna)
• Finestra di esportazione avanzata con filtri combinabili:
  • PGC / UGC / NGC-IC
  • Nord / Est / Sud / Ovest
  • Magnitudine minima/massima
  • Altitudine e distanza minima dalla Luna
  • Numero massimo di oggetti da esportare

---

⚙️ Requisiti

Assicurarsi di avere installato Python ≥ 3.9 con i seguenti moduli:

pip install PyQt5 astropy pandas xlrd

---

🧭 Utilizzo

1. Posizionare i file dei cataloghi (galaxy.xls, pgc.dat, ugc.dat, ngc.dat) nella stessa cartella del programma.

2. Eseguire:

   python main.py

3. Inserire la posizione geografica (lat/lon), la data UTC, e impostare i parametri desiderati.

4. Premere Calcola / Filtra per generare la lista delle galassie visibili.

5. Utilizzare Esporta per generare i file in uno dei formati disponibili.

---

🧩 Formati di esportazione

🔹 Voyager

TARGET;RA;DEC;PA;ORDINE
IC10;00 20 24.33;+59 18 06.7;0.00;1

🔹 N.I.N.A / Telescopius

Object,RA,Dec,Constellation,Magnitude
NGC 7331,22:37:04,+34:25:31,,9.5

🔹 CSV generico

Tutte le colonne mostrate nella tabella (RA, DEC, Mag, Alt, Lato, Distanza Luna).

---

🧠 Logica direzioni

Il filtro direzionale usa la colonna Lato:

• N → include tutto tra 315°–45°
• E → include tutto tra 45°–135° (copre NE e SE)
• S → include tutto tra 135°–225°
• O → include tutto tra 225°–315°

Selezioni multiple (es. Nord + Est) sono supportate.

---

🏷️ Autore

Antonino Brosio
📡 ABProject Space
🌍 [https://www.antoninobrosio.it)

---

📄 Licenza

Software distribuito con licenza OPEN.

---

📁 Struttura del progetto

GalaxyFinder/
│
├── main.py              → Interfaccia principale
├── export.py            → Finestra di esportazione
├── galaxy.xls           → Catalogo interno (input)
├── ugc.dat              → Catalogo UGC
├── pgc.dat              → Catalogo PGC
├── ngc.dat              → Catalogo NGC/IC
├── icon.ico             → Icona programma
└── README.md            → Documentazione

---

🛰️ Galaxy Finder – un ponte tra i cataloghi e il cielo reale.