Blocco dell'analisi astrometrica in presenza di file FIT problematici
adminDescrizione del problema
Software: MeStar v.2.0.0
Modulo: Astrometria
Tipologia: Bug / Miglioramento della gestione degli errori
Risolto in: MeStar v.2.0.1
Descrizione del problema
Attualmente, durante l'elaborazione di una sequenza di immagini FIT nella schermata Astrometria, la presenza di uno o più file problematici può provocare l'interruzione dell'intero processo di calcolo.
Il problema si verifica quando un file FIT presenta anomalie che ne impediscono la corretta elaborazione, per esempio file danneggiati, dati incompleti, metadati non validi oppure errori nella lettura o nell'analisi dell'immagine.
Questo comportamento è particolarmente penalizzante quando si elaborano sequenze composte da numerosi FIT, poiché un singolo file problematico può impedire di ottenere i risultati astrometrici dagli altri file perfettamente validi.
Comportamento attuale
- L'utente seleziona una sequenza di file FIT da analizzare.
- MeStar avvia l'elaborazione astrometrica.
- Uno dei file genera un errore durante l'elaborazione.
- Il processo si interrompe, impedendo il completamento dell'analisi degli altri FIT.
Comportamento atteso
La presenza di un file FIT problematico non dovrebbe necessariamente interrompere l'intera analisi astrometrica.
Si propone di introdurre una politica di esclusione automatica dei file FIT non elaborabili, analogamente ai meccanismi di gestione degli errori ed esclusione dei frame utilizzati in altre procedure di MeStar, come la risoluzione astrometrica delle immagini.
Il programma dovrebbe essere in grado di identificare il file problematico, escluderlo dall'elaborazione e proseguire con quelli successivi.
Soluzioni proposte
1. Gestione degli errori per singolo file FIT
Implementare una gestione delle eccezioni a livello del singolo frame.
Quando un FIT genera un errore recuperabile:
- Identificare il file responsabile.
- Registrare la causa dell'errore.
- Escludere il file dall'elaborazione corrente.
- Proseguire automaticamente con il FIT successivo.
- Conservare tutti i risultati validi già ottenuti.
Gli errori relativi a un singolo file devono essere distinti da eventuali errori globali che rendono impossibile continuare il calcolo.
2. Politica di esclusione configurabile
Valutare l'introduzione di un'impostazione che consenta di scegliere il comportamento in presenza di file FIT problematici:
- Esclusione automatica (consigliata): il programma ignora i FIT non elaborabili e prosegue.
- Interruzione immediata: il calcolo si arresta al primo errore, mantenendo il comportamento attuale per chi necessita di una verifica rigorosa.
Si potrebbe inoltre prevedere una soglia massima di file esclusi, oltre la quale l'analisi viene interrotta.
3. Resoconto dei FIT esclusi
Al termine dell'elaborazione, MeStar dovrebbe presentare un riepilogo contenente:
- Numero totale di FIT selezionati.
- Numero di FIT elaborati correttamente.
- Numero di FIT esclusi.
- Elenco dei file esclusi e relativa motivazione.
Le stesse informazioni dovrebbero essere registrate nel file di log per consentire all'utente di identificare e verificare successivamente i frame problematici.
4. Verifica della validità dei risultati
L'esclusione di uno o più file non deve compromettere l'affidabilità dei risultati astrometrici.
Il software dovrebbe quindi verificare che, dopo le esclusioni, rimanga un numero sufficiente di misure valide per eseguire l'analisi richiesta.
Se le misure residue sono insufficienti, MeStar dovrebbe interrompere il calcolo con un messaggio esplicativo anziché produrre risultati non attendibili.
Le esclusioni dovrebbero inoltre essere chiaramente segnalate, per evitare che l'utente interpreti una sequenza incompleta come un'elaborazione di tutti i FIT originariamente selezionati.
Risultato atteso
Con questa modifica, MeStar dovrebbe essere in grado di completare un'analisi astrometrica anche in presenza di singoli FIT danneggiati o non elaborabili, purché rimangano dati sufficienti.
Ad esempio, caricando una sequenza di 100 file FIT, di cui 3 problematici, il programma dovrebbe poter elaborare correttamente i restanti 97 file e segnalare chiaramente le tre esclusioni.
Criteri di accettazione
Il bug potrà essere considerato risolto quando:
- Un errore recuperabile relativo a un singolo FIT non provocherà più l'interruzione dell'intera elaborazione.
- I file problematici saranno identificati ed esclusi senza compromettere i risultati dei file validi.
- Il programma produrrà un riepilogo dei FIT elaborati ed esclusi, indicando le cause degli errori.
- Gli errori saranno registrati nel log.
- In caso di dati residui insufficienti, MeStar mostrerà un messaggio appropriato senza generare risultati astrometrici non affidabili.
- Sarà verificata l'assenza di regressioni nell'elaborazione delle sequenze composte esclusivamente da FIT validi.
Impatto
Questa modifica migliorerebbe sensibilmente la robustezza e l'affidabilità operativa del modulo Astrometria, soprattutto durante l'elaborazione di lunghe sequenze di immagini astronomiche.
Soluzione raccomandata: implementare la gestione indipendente degli errori per ciascun file FIT, con esclusione automatica dei frame non elaborabili, prosecuzione del calcolo e resoconto dettagliato delle esclusioni.
