Debugger GX-TXT · Modulo 10 — Autonomia e progetto conclusivo
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.
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.
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.
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.
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.
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].
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.
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.
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.
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.
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.
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.
Nel report finale collega il risultato atteso, lo stato osservato e la verifica dopo la correzione. È questo confronto che rende la diagnosi riproducibile.
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 05 — Python: casi fondamentali
- Debugger GX-TXT · Modulo 01 — Fondamenti e primo Debug Job
- Debugger GX-TXT · Modulo 02 — Breakpoint e sorgente
- Debugger GX-TXT · Modulo 03 — Controllo del flusso e stack