Debugger GX-TXT · Guida 05 — Debugging dei dati scientifici: vettori, strutture e Dataset
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_05/scripts.
D32 — Righe, colonne e dimensioni
In Octave un vettore riga e un vettore colonna possono contenere gli stessi numeri, ma avere forme diverse. La forma influisce sulle operazioni matriciali e su come i dati vengono trasferiti.
Confrontare le forme nel debugger
Importa D32_shapes.m, salvalo nella
Session e imposta un breakpoint sulla prima stampa. Il codice crea
row = [1, 2, 3] e column = row.', quindi usa
size per salvare le dimensioni.
Avvia Start Debug. In pausa alla stampa, il pannello
mostra column con forma 3 1 e
column_shape con valore 3 1; scorri l’elenco
per vedere anche row e row_shape.
La forma del vettore riga è 1 3, quella della colonna è
3 1. Nota che column_shape è a sua volta un
vettore riga contenente due numeri: la sua forma nel pannello è
1 2, mentre il suo valore è
3 1. Sono due informazioni diverse.
Continua e verifica l’output ROW 1 3 e
COLUMN 3 1. Qui .' è la trasposizione senza
coniugazione; per dati complessi la distinzione rispetto a
' è significativa.
Esercizio
Un pannello mostra forma 1 2 e valore 3 1
per column_shape. Qual è la forma di
column?
Soluzione ragionata
column ha forma 3 1: è il valore salvato in
column_shape. La forma 1 2 descrive invece il
vettore che contiene le due dimensioni.
D33 — Operatori scalari e per elemento
In Octave gli operatori con il punto, come .* e
.^, operano elemento per elemento. Gli operatori matriciali
senza punto seguono invece regole di algebra lineare e richiedono
dimensioni compatibili.
Osservare i risultati intermedi
Importa e registra D33_elementwise.m. Lo script calcola i
quadrati di [1, 2, 3] con .^ 2 e moltiplica
ciascun elemento per il corrispondente elemento di
[2, 2, 2] con .*.
Imposta un breakpoint sulla prima stampa e avvia il debug. Nella
prova il pannello mostra samples con valore
1 2 3 e products con valore
2 4 6; scorri per vedere anche squares.
Continua: i risultati attesi sono SQUARES 1 4 9 e
PRODUCTS 2 4 6. Se sostituisci .* con
*, non stai semplicemente cambiando la grafia: stai
chiedendo una moltiplicazione matriciale, che per questi due vettori
riga non ha dimensioni compatibili.
Esercizio
Qual è il risultato di [1, 2, 3] .^ 2? Perché
.^ è appropriato qui?
Soluzione ragionata
Il risultato è [1, 4, 9]: l’elevamento al quadrato viene
applicato a ciascun elemento del vettore.
D41 — Pubblicazione e creazione di risultati
Un calcolo in memoria e la pubblicazione di un Dataset sono due momenti distinti. Un breakpoint prima della chiamata consente di controllare gli input prima che la Session riceva un risultato.
Preparare dati sintetici
Usa una Session di prova e importa D41_publish_series.m in Octave
Scripts. Il codice prepara tre tempi 0, 1, 2 s e tre
tensioni 1, 2, 3 V. La richiesta assegna l’ID
debug_sensor_series e le variabili time_s e
voltage_v.
Il Dataset è create-only: se esiste già, usa una nuova Session o cambia l’ID nello script e in quelli che lo leggono. Salva prima della prova.
Fermarsi prima della pubblicazione
Imposta un breakpoint sulla costruzione di request, dopo
la definizione dei due vettori. Avvia il debug e verifica i dati nel
sorgente e nei riepiloghi disponibili. La richiesta e la chiamata a
publish_series devono ancora essere eseguite:
Premi Continue. Nella prova il Job arriva a
COMPLETED; il Dataset sintetico è disponibile nella Session
e può essere letto dall’esempio della D39.
Se ripeti l’esecuzione con lo stesso ID nella stessa Session, non presumere che la pubblicazione sovrascriva il Dataset: scegli un ID nuovo o una Session di prova nuova.
Esercizio
Il programma è in pausa prima della costruzione della richiesta. Il Dataset è già stato pubblicato da questa esecuzione?
Soluzione ragionata
No. La chiamata a publish_series viene dopo la riga in
pausa. Dopo Continue, controlla l’esito del Job e verifica il Dataset
nella Session.
D39 — Lettura di Dataset e variabili
Quando un’analisi legge dati da GX-TXT, controlla il Dataset, i Variable ID richiesti, il numero di elementi e le unità prima di interpretare il risultato.
Preparare i dati
In una Session di prova crea il Dataset sintetico
debug_sensor_series con D41_publish_series.m, seguendo la
D41. La serie contiene tempi 0, 1, 2 s e tensioni
1, 2, 3 V. L’ID è create-only: per ripetere la
pubblicazione usa una Session nuova o cambia l’ID in entrambi gli
script.
Importa e registra D39_read_series.m. Imposta un
breakpoint sulla chiamata read_range e avvia il debug.
Prima della chiamata puoi verificare
dataset_id = debug_sensor_series, gli ID
time_s e voltage_v, l’inizio 0 e il numero
richiesto 3.
Premi Step Over per completare la chiamata, poi
altri due passi per estrarre i vettori dalla struttura restituita.
Scorri Locals / Globals: nella prova time_s e
voltage_v hanno forma 3 1 e valori
rispettivamente 0 1 2 e 1 2 3.
L’asserzione successiva controlla che entrambi abbiano tre elementi. I nomi delle variabili e le unità devono essere coerenti con il Dataset pubblicato; un’operazione disponibile, da sola, non garantisce che un ID richiesto sia corretto.
Esercizio
Perché il controllo delle dimensioni è utile prima di confrontare tempo e tensione?
Soluzione ragionata
Aiuta a rilevare letture incomplete o vettori di lunghezza incompatibile. Non dimostra da solo che unità e associazione fra campioni siano corrette: anche quelle vanno verificate.
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 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