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.

Valori celsius, offset e kelvin nel debugger Octave.
Valori celsius, offset e kelvin nel debugger Octave.

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.

Dati del Dataset letti nel debugger Octave.
Dati del Dataset letti nel debugger Octave.

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.

Grafico XY prodotto da GX-TXT: la tensione cresce da 1 a 3 mentre il tempo va da 0 a 2.
Grafico XY prodotto da GX-TXT: la tensione cresce da 1 a 3 mentre il tempo va da 0 a 2.

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].

Valori dell'esempio di indice errato prima dell'accesso.
Valori dell’esempio di indice errato prima dell’accesso.

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.

Indice delle sei guide

Guida 05 precedente

#debugger #GNU Octave #GX-TXT #Python

Altre tappe del progetto

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *