Debugger GX-TXT · Modulo 09 — Casi pratici integrati
Il debugger di GX-TXT · Corso in 10 moduli
Se un grafico o una statistica appare plausibile, il difetto può essere nascosto nei passaggi precedenti. Qui seguiamo il percorso dei dati: campionamento, valori mancanti, residui, scala e pubblicazione. I sei esempi aiutano a scegliere un controllo intermedio che renda evidente il punto in cui il risultato cambia.
Scarica gli esempi Python e GNU Octave (ZIP). Estrai tutte le cartelle dell’archivio e mantieni insieme i file degli esempi multifile.
D49 — Serie temporale con un campione saltato
Un errore di confine può escludere un campione da una finestra temporale. Con dati piccoli e identificabili possiamo verificare quali posizioni entrano nel calcolo prima di applicarlo a una serie più ampia.
La stessa finestra in due linguaggi
Considera cinque campioni sintetici
[10, 20, 30, 40, 50]. Vogliamo selezionare il secondo, il
terzo e il quarto: il risultato atteso è [20, 30, 40].
In slices.py,
samples[1:4] usa indici da zero e limite finale esclusivo.
Ferma il debugger sulla stampa: nella prova window ha
lunghezza 3.
In indexing.m, la
stessa finestra è samples(2:4): Octave parte da 1 e
l’intervallo comprende 4. La prova si ferma prima della stampa dopo aver
letto il primo campione e la finestra.
La forma corretta dipende dalla convenzione del linguaggio. Se invece il requisito includesse anche il quinto campione, bisognerebbe cambiare entrambi gli intervalli e il risultato atteso; il debugger aiuta a verificare la scelta, ma il requisito viene prima del codice.
Esercizio
Quali espressioni selezionano 30 e 40 rispettivamente in Python e in Octave?
Soluzione ragionata
Python: samples[2:4]. Octave: samples(3:4).
Entrambe selezionano il terzo e il quarto campione.
Indice del corso · Lezione precedente
D50 — Statistiche con valori mancanti
Una misura assente non equivale a una misura uguale a zero. Per rendere esplicita la distinzione usiamo una maschera di validità separata dai valori.
Seguire il filtro
Importa e registra missing_mean.m in Octave Scripts. Il
vettore samples = [2, 0, 4, 6] contiene un segnaposto nella
seconda posizione; is_valid = [1, 0, 1, 1] indica quali
osservazioni sono valide. La scelta di escludere quella posizione è
dichiarata dalla maschera, non dedotta dal valore zero.
Apri View → Debugger, imposta un breakpoint sulla
stampa e avvia Start Debug. Controlla in Locals /
Globals valid, valid_count e
mean_valid: i risultati attesi sono rispettivamente
[2, 4, 6], 3 e 4. La seconda posizione non contribuisce
alla media. Completa il Job con Continue.
Nella prova la maschera e la media sono visibili in Locals / Globals; scorri il pannello per raggiungere gli altri valori. Se il tuo dataset usa un’altra codifica dei valori mancanti, costruisci la maschera secondo il suo contratto, senza supporre che ogni zero sia mancante. Gestisci esplicitamente anche il caso in cui nessun elemento sia valido.
Esercizio
Se tutte le quattro posizioni fossero valide, quale media otterresti?
Soluzione ragionata
La media sarebbe (2 + 0 + 4 + 6) / 4 = 3: includere il
segnaposto cambia sia il conteggio sia la media.
D51 — Fit e residui
Una regressione semplice offre diversi punti di controllo: dati di ingresso, coefficienti, previsione e residui. Un valore conclusivo da solo non spiega dove sia nato un eventuale scostamento.
Seguire una retta
Importa e registra linear_fit.m. I
quattro punti sintetici seguono y = 2x + 1; i coefficienti
attesi sono pendenza 2 e intercetta 1. Metti un breakpoint sulla stampa,
avvia il debugger e osserva coefficients,
prediction, residuals e max_error
in Locals / Globals. Dopo Continue, la stampa mostra i
coefficienti con due decimali e il massimo residuo con sei.
Questa schermata, tratta dall’esercizio sulle forme, mostra dove
leggere tipo, forma e valore dei vettori. Nel fit confronta anche le
dimensioni di x, y e prediction
prima di sottrarre. L’asserzione richiede un residuo massimo inferiore a
1e-10: l’aritmetica in virgola mobile può lasciare
differenze molto piccole, perciò non occorre pretendere uno zero
esatto.
Esercizio
Se il massimo residuo è 1e-14, supera la tolleranza
1e-10?
Soluzione ragionata
No. È più piccolo della tolleranza; la stampa arrotondata a sei decimali può mostrare zero anche quando il valore interno non è esattamente zero.
D52 — Integrazione numerica e scala
Integrazione e unità devono essere coerenti: una formula può essere eseguita senza errori e produrre un risultato mille volte troppo grande se il tempo è espresso nell’unità sbagliata.
Tempo, velocità e distanza
In integral.m,
time_s = [0, 1, 2, 3] è espresso in secondi e
speed_m_per_s = [2, 2, 2, 2] in metri al secondo. L’area
sotto la curva è 2 × 3 = 6 metri. Importa e registra lo
script in Octave Scripts, metti un breakpoint sulla stampa e avvia il
debugger. Controlla i vettori e distance_m, poi prosegui:
la stampa attesa è DISTANCE 6.0 m.
L’immagine riprende la conversione della D40: il debugger mostra
numeri, mentre i nomi e il contesto chiariscono le unità. Se il tempo
arrivasse come [0, 1000, 2000, 3000] millisecondi,
convertilo in secondi dividendo per 1000 prima di trapz.
Passarlo direttamente alla formula con velocità in m/s produrrebbe 6000,
senza rappresentare correttamente metri.
Esercizio
Quale distanza percorre una velocità costante di 2 m/s in 3 s?
Soluzione ragionata
6 m. Il prodotto tra secondi e metri al secondo lascia metri.
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 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.
D54 — Progetto multifile con errore propagato
Quando un dato attraversa più funzioni e file, il punto in cui appare un risultato inatteso non coincide necessariamente con la sua origine. Seguiamo il valore dal chiamante alla funzione di supporto.
Una base riproducibile
Prepara il progetto main.py e helpers.py,
come nella D18.
Il chiamante passa 4 e si aspetta che adjust restituisca 5.
Salva entrambi i file e ferma il debugger sulla riga di calcolo
nell’helper.
La prova mostra value = 4 nella funzione e il chiamante
nello stack. Se una copia dell’helper aggiungesse erroneamente 2, il
sintomo nel chiamante sarebbe 6, ma il punto da correggere sarebbe
l’operazione nell’helper. Per esercitarti, modifica una copia del
progetto, salva e riavvia: verifica prima l’argomento in ingresso, poi
l’operazione e infine il valore restituito. Aggiorna o rimuovi
temporaneamente l’asserzione intenzionalmente non soddisfatta durante la
diagnosi e ripristinala per verificare la correzione.
Esercizio
Se l’helper riceve già 5 invece di 4, è sufficiente correggere la sua addizione?
Soluzione ragionata
Non necessariamente: occorre prima risalire al chiamante e controllare perché ha fornito 5. Il valore osservato all’ingresso distingue un problema a monte da uno nella funzione.
Questi casi preparano il progetto finale, nel quale serve documentare il difetto, la correzione e la verifica in modo che un’altra persona possa ripeterli.
Modulo 08 precedente · Indice dei 10 moduli · Modulo 10 successivo
Altre tappe del progetto
- Debugger GNU Octave in GX-TXT: breakpoint, variabili e API pubbliche
- 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
- Debugger GX-TXT · Modulo 03 — Controllo del flusso e stack