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.

Debugger Octave con il vettore colonna e le sue dimensioni.
Debugger Octave con il vettore colonna e le sue dimensioni.

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.

Vettori Octave in pausa dopo le operazioni per elemento.
Vettori Octave in pausa dopo le operazioni per elemento.

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:

Pausa prima della costruzione della richiesta di pubblicazione.
Pausa prima della costruzione della richiesta di pubblicazione.

Premi Continue. Nella prova il Job arriva a COMPLETED; il Dataset sintetico è disponibile nella Session e può essere letto dall’esempio della D39.

Debug Job completato dopo la pubblicazione del Dataset sintetico.
Debug Job completato dopo la pubblicazione del Dataset sintetico.

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.

Pausa prima della lettura del Dataset e controllo dell'identificativo.
Pausa prima della lettura del Dataset e controllo dell’identificativo.

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.

Valori e forma dei vettori letti dal Dataset.
Valori e forma dei vettori letti dal Dataset.

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.

Indice delle sei guide

Guida 04 precedente · Guida 06 successiva

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