Il debugger di GX-TXT · Corso in 10 moduli

L’ultima verifica del corso è riuscire a spiegare perché una correzione funziona. Riduciamo il caso, distinguiamo un difetto da un comportamento numerico legittimo, scegliamo il viewer adatto e affrontiamo gli ostacoli di avvio. Il progetto finale raccoglie diagnosi, correzione e consegna riproducibile.

Scarica gli esempi Python e GNU Octave (ZIP). Estrai tutte le cartelle dell’archivio e mantieni insieme i file degli esempi multifile.

D55 — Strategia di isolamento

Di fronte a un risultato inatteso, riduci il caso e formula un’ipotesi verificabile. Cambiare più cose insieme rende difficile capire quale modifica abbia risolto il problema.

Una domanda per volta

Riprendi index_error.py: tre valori e indice 3. L’obiettivo è ottenere il terzo valore, 30. Importa lo script, metti un breakpoint sulla riga di accesso e avvia il debugger; controlla la lunghezza della lista e l’indice. La schermata mostra la situazione prima dell’accesso.

Schermata reale del debugger GX-TXT.
Lista e indice nella riproduzione minima.

Ipotesi A: la lista è più corta di quanto previsto. Ipotesi B: l’indice è calcolato con una convenzione diversa. I tre elementi previsti sono presenti; in Python il terzo usa indice 2. Nella copia index_fixed.py cambia solo l’indice e verifica SAMPLE 30. Conserva input e risultato atteso: sono il confronto indipendente.

Esercizio

Perché non è utile aggiungere un elemento alla lista e cambiare l’indice nello stesso tentativo?

Soluzione ragionata

Potresti ottenere un risultato senza sapere quale cambiamento fosse necessario. Prova una sola ipotesi per volta e confronta con il requisito.

Indice del corso

D56 — Quando il risultato non è un errore

Un numero visualizzato può essere arrotondato; un pannello può anche riassumere una collezione. Prima di correggere il programma, controlla cosa rappresenta la visualizzazione.

Forma, valore e precisione

Nella D32, column_shape contiene 3 1, cioè la forma del vettore column. Lo stesso column_shape è un vettore di forma 1 2: i due dati non si contraddicono.

Schermata reale del debugger GX-TXT.
Forma e valore di una variabile nel debugger Octave.

Nella D51, un residuo molto piccolo può apparire come 0.000000 con sei decimali senza essere zero esatto. Controlla un valore numerico con una tolleranza giustificata dal problema; non scegliere una tolleranza così larga da nascondere un errore concreto. Se il pannello mostra un riepilogo, usa le informazioni di forma e gli output previsti dallo script per stabilire che cosa hai effettivamente osservato.

Esercizio

column_shape ha forma 1 2 e valore 3 1: quante righe ha column?

Soluzione ragionata

Tre. Il valore di column_shape descrive column; la forma 1 2 descrive il contenitore delle sue dimensioni.

Indice del corso

D57 — Confronto Python e Octave

La stessa operazione numerica può richiedere indici diversi nei due linguaggi. Confrontiamo il risultato e il significato degli estremi, non solo la grafia.

Selezionare una finestra

Usa slices.py e indexing.m. Su [10, 20, 30, 40, 50], il secondo, terzo e quarto campione sono [20, 30, 40]. In Python la selezione è samples[1:4], con indice iniziale da zero e limite finale esclusivo; in Octave è samples(2:4), con indice iniziale da uno ed estremo incluso.

Schermata reale del debugger GX-TXT.
La finestra Python nel debugger GX-TXT.

Importa ciascuno script nel viewer corrispondente, salvalo nella Session e ferma la prova dopo la selezione. Verifica contenuto e lunghezza della finestra nel rispettivo pannello. Controlla anche la forma in Octave se il dato sarà usato in operazioni matriciali: una lista Python e un vettore Octave non hanno automaticamente le stesse regole.

Esercizio

Come selezioni il terzo e quarto campione?

Soluzione ragionata

Python: samples[2:4]; Octave: samples(3:4). Il risultato comune è [30, 40].

Indice del corso

D58 — Problemi frequenti di avvio

Quando Start Debug non è disponibile, controlla il contesto prima di modificare il codice: Session, identità dello script, salvataggio e stato del Job.

Una scheda dopo il cambio di Session

Nella prova della D45, una scheda dello script della prima Session rimane aperta dopo l’apertura di un’altra Session. Start Debug appare disabilitato; la vecchia scheda non diventa per questo uno script della nuova Session.

Schermata reale del debugger GX-TXT.
Scheda precedente con Start Debug disabilitato dopo il cambio di Session.

Termina prima un eventuale Job attivo, controlla quale Session è aperta e torna al contesto corretto con Sessions → Session → Open Session. Riapri lo script giusto, controlla scope e Script ID e salva la revisione prima di avviare. Se il problema persiste, consulta messaggi e diagnostica del viewer e verifica runtime e dipendenze: un pulsante disabilitato da solo non identifica ogni possibile causa.

Esercizio

Hai cambiato Session e una vecchia scheda è ancora visibile. È sufficiente vedere il sorgente per essere certi che sia registrato nella nuova Session?

Soluzione ragionata

No. Verifica Session, scope e identità; poi apri o registra lo script nel contesto desiderato.

Indice del corso

D59 — Progetto finale: diagnosi

Un sensore sintetico registra tre tensioni in volt. Il programma deve convertirle in millivolt e calcolarne la media. È un caso piccolo, ma riproduce una pipeline reale: input, conversione, aggregazione e controllo.

Il risultato atteso

Le misure sono 0.1, 0.2, 0.3 V. Poiché 1 V = 1000 mV, le misure attese sono 100, 200, 300 mV e la media è 200 mV. Le versioni volutamente errate calibration_bug.py e calibration_bug.m usano invece fattore 100 e stampano MEAN 20.0 mV.

Individuare l’origine

Importa lo script del linguaggio scelto nel viewer GX-TXT, registralo nella Session e apri View → Debugger. Nel programma Python metti un breakpoint sulla riga return della funzione; in Octave sulla riga converted_mv = .... Avvia il debug e usa Continue se necessario per arrivare al breakpoint. Controlla input e fattore; con Step Over osserva il passaggio successivo. Per Python, se ti fermi al return, torna al chiamante per esaminare converted_mv. Risali alla conversione prima di cambiare il calcolo della media.

Schermata reale del debugger GX-TXT.
Debugger su una funzione Python e chiamante nello stack.

L’immagine riprende il progetto multifile della D18 e mostra come collegare una funzione al chiamante; i valori visualizzati appartengono a quell’esempio. In questo progetto annota lingua, input, punto di pausa, fattore osservato, valore atteso e valore ottenuto. Nella D60 trovi la correzione.

Esercizio

Se la conversione produce [10, 20, 30], la media 20 dimostra che l’aggregazione è sbagliata?

Soluzione ragionata

No. La media di quei tre valori è 20; l’errore è già nella conversione in ingresso all’aggregazione.

Indice del corso

D60 — Progetto finale: correzione e consegna

Completiamo il progetto della D59 correggendo il fattore di conversione e verificando il risultato con gli stessi dati.

Correggere e verificare

Le versioni corrette calibration_fixed.py e calibration_fixed.m usano 1000. Importa quella del linguaggio scelto, salvala nella Session e metti un breakpoint dopo la conversione, sulla riga che calcola mean_mv. Avvia il debug e controlla converted_mv: i valori attesi sono [100, 200, 300]. Con Step Over controlla mean_mv, quindi continua: l’output atteso è MEAN 200.0 mV e l’asserzione verifica il risultato entro 1e-10.

Schermata reale del debugger GX-TXT.
Controllo di valori e unità nel debugger Octave.

La schermata è quella della D40: illustra il controllo delle variabili in una diversa conversione di unità. Nel tuo esercizio confronta la nuova esecuzione con la diagnosi D59 senza cambiare i dati. Prova anche 0 V e 1 V: devono corrispondere a 0 e 1000 mV. Documenta versione, Session, script, dati, risultato atteso e risultato ottenuto; conserva sia la versione errata didattica sia quella corretta con nomi distinti.

Esercizio conclusivo

Una media corretta garantisce che ogni campione sia corretto?

Soluzione ragionata

No. Errori diversi possono compensarsi. Controlla anche i valori convertiti singolarmente, le unità e casi di riferimento indipendenti.

Indice del corso

Nel report finale collega il risultato atteso, lo stato osservato e la verifica dopo la correzione. È questo confronto che rende la diagnosi riproducibile.

Modulo 09 precedente · Indice dei 10 moduli

#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 *