Debugger GX-TXT · Guida 06 — Debugging di un workflow scientifico completo
Questa guida fa parte del progetto GX-TXT Script Debugger. Le schermate provengono da esecuzioni reali in GX-TXT dev112-P011-bis, già realizzate per il corso sul debugger; gli esempi usano dati sintetici. I codici D identificano gli esercizi corrispondenti del corso completo sul debugger.
Scarica gli script delle sei guide pratiche (ZIP). Per ripetere questa guida, estrai i file della cartella lezione_06/scripts.
D40 — Trasformazioni e unità
Un valore numerico può essere calcolato correttamente e interpretato male se perdiamo l’unità. Prima di una trasformazione, rendiamo espliciti grandezza, unità di ingresso e unità del risultato.
Seguire una conversione
Usa D01_temperature_fixed.m
nella Session di prova. Lo script parte da celsius = 20,
aggiunge offset = 273.15 e ottiene
kelvin = 293.15. Metti un breakpoint sulla stampa e avvia
il debugger.
Nella prova il pannello mostra i tre scalari. Il valore numerico
293.15 va interpretato come kelvin perché lo specificano la
formula, i nomi e la stampa: il tipo numerico da solo non contiene
automaticamente questa spiegazione.
Quando questi valori provengono da un Dataset, verifica anche unità e
Variable ID dichiarati alla fonte. Nella D39, time_s e
voltage_v rappresentano grandezze diverse: non basta che i
vettori abbiano la stessa lunghezza per poterli scambiare.
Esercizio
Se interpreti 20 °C come 20 K senza conversione, il programma deve necessariamente dare un errore di sintassi?
Soluzione ragionata
No. Entrambi sono numeri validi; è l’interpretazione fisica a essere errata. Occorrono unità esplicite e controlli con valori attesi indipendenti.
D53 — Flusso da Dataset a grafico
Un grafico corretto richiede sia valori corretti sia la giusta associazione fra grandezze e assi. Prima di costruirlo, fermati alla lettura del Dataset.
Dalla Session agli assi
Segui la D41 per creare in
una Session di prova debug_sensor_series, poi la D39 per leggere
time_s e voltage_v. I dati sono
rispettivamente [0, 1, 2] s e [1, 2, 3] V. Il
Dataset è create-only: per ripetere la pubblicazione scegli una Session
nuova oppure un ID nuovo e aggiornalo anche nello script di lettura.
Nella schermata della D39 controlliamo valori e forme dopo
read_range. Per preparare un grafico XY associa tempo
all’asse orizzontale e tensione a quello verticale; le coppie attese
sono (0, 1), (1, 2), (2, 3).
Invertire le variabili conserva tre coppie numeriche ma cambia il
significato del grafico. Riporta unità e nomi sugli assi e verifica un
punto noto prima di trarre conclusioni.
Lo script D53_sensor_plot.m
costruisce il grafico tramite Plot Dataset API. Importalo nella stessa
Session, salvalo e avvia il debug; dopo l’eventuale pausa iniziale premi
Continue. Nella prova il Job è terminato con
COMPLETED e ha prodotto il grafico seguente con il renderer
nativo. Il file è il risultato esportato da GX-TXT, non una schermata
del viewer.
Il grafico usa i nomi Time e Voltage; nella documentazione associa esplicitamente le unità s e V. La disponibilità dell’API e del renderer dipende dalla configurazione installata.
Esercizio
Quale punto si ottiene con tempo 1 s e tensione 2 V?
Soluzione ragionata
Con tempo su X e tensione su Y il punto è (1, 2);
invertire gli assi darebbe (2, 1) e un’interpretazione
diversa.
Registrazione, Job e ripetizione
Nel workflow apri una Session di prova, salva ogni script con uno Script ID riconoscibile e avvia il Debug Job dalla revisione salvata. La pubblicazione del Dataset nella guida 05 è create-only: per una seconda prova usa una nuova Session o un ID distinto e aggiorna tutti gli script che lo leggono. Controlla stato del Job e Program output / diagnostics dopo ogni fase. Conserva la revisione e l’identità dello script che compaiono nei dettagli del Job: lo snapshot eseguito è distinto dalle successive modifiche nell’editor.
D48 — Riproduzione della diagnosi
Una diagnosi è utile quando un’altra persona può ripetere il caso e verificare la correzione. Una scheda essenziale raccoglie contesto, input, risultato atteso, risultato osservato e passaggi.
Esempio: indice errato
Usa D23_index_error.py. Annota
che la lista contiene 10, 20 e 30, che la chiamata usa l’indice 3 e che
si intendeva leggere il terzo elemento, cioè 30. Registra versione di
GX-TXT e Python, Session, identità e revisione dello script; indica il
breakpoint su return samples[index].
Nella prova si osservano lista di lunghezza 3 e indice 3, seguiti da
IndexError. La copia D23_index_fixed.py usa l’indice 2 e
produce SAMPLE 30. La scheda deve distinguere l’errore
intenzionale dell’esercizio dal funzionamento di GX-TXT.
Una buona riproduzione usa dati minimi e non include informazioni private. Non basta dire «non funziona»: specifica cosa fare, cosa aspettarsi e cosa si osserva.
Esercizio
Quali due informazioni distinguono il sintomo dalla verifica della correzione in questo caso?
Soluzione ragionata
Il sintomo è l’IndexError con indice 3; la verifica
della correzione è l’output 30 con indice 2 e gli stessi dati.
Altre tappe del progetto
- Debugger GNU Octave in GX-TXT: breakpoint, variabili e API pubbliche
- Debugger GX-TXT · Modulo 09 — Casi pratici integrati
- Debugger GX-TXT · Modulo 10 — Autonomia e progetto conclusivo
- Debugger GX-TXT · Modulo 05 — Python: casi fondamentali
- Debugger GX-TXT · Modulo 01 — Fondamenti e primo Debug Job
- Debugger GX-TXT · Modulo 02 — Breakpoint e sorgente