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.

Finestra di campioni in Python.
Finestra Python osservata prima della stampa.

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.

Finestra di campioni in Octave.
Lettura dei campioni nell’esempio Octave.

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.

Schermata reale del debugger GX-TXT.
Debugger Octave in pausa con maschera di validità e media.

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.

Indice del corso

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.

Schermata reale del debugger GX-TXT.
Pannello Octave per osservare valori e forma dei vettori.

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.

Indice del corso

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.

Schermata reale del debugger GX-TXT.
Debugger Octave durante un controllo delle unità di una trasformazione.

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.

Indice del corso

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.

Schermata reale del debugger GX-TXT.
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 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 esportato da GX-TXT per i tre campioni del sensore.
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.

Indice del corso

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.

Funzione helper e chiamante nel debugger.
Funzione helper e chiamante nello stack del progetto Python.

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.

Indice del corso

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

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