Il debugger di GX-TXT · Corso in 10 moduli

Un vettore riga e un vettore colonna possono avere lo stesso numero di elementi, ma portare a calcoli diversi. Con GNU Octave partiamo da indici, forme e operatori, quindi seguiamo chiamate ed errori fra file .m, con punti di arresto pianificati per la versione usata nelle prove.

Scarica gli esempi Python e GNU Octave (ZIP). Estrai tutte le cartelle dell’archivio e mantieni insieme i file degli esempi multifile.

D31 — Indici Octave

GNU Octave usa normalmente indici a partire da 1. Questa differenza rispetto a Python è importante quando si trasferisce un algoritmo fra i due linguaggi.

Verificare un intervallo

Importa e registra indexing.m in Octave Scripts. Il vettore è [10, 20, 30, 40, 50]. samples(1) seleziona 10; samples(2:4) seleziona 20, 30 e 40, perché l’intervallo 2:4 contiene entrambi gli estremi.

Imposta un breakpoint sulla prima stampa e avvia Start Debug. Nella prova il debugger si ferma dopo le assegnazioni: first_sample vale 10 e samples è un vettore riga di cinque elementi. Scorri il pannello per esaminare anche window.

Primo campione e vettore Octave in pausa.
Debugger Octave con il primo campione e il vettore.

Prosegui e confronta l’output FIRST 10 e WINDOW 20 30 40 con le asserzioni. Nella D25, la stessa finestra era espressa in Python come samples[1:4], con limite superiore esclusivo.

Esercizio

Quale intervallo Octave seleziona gli ultimi due elementi del vettore di cinque campioni?

Soluzione ragionata

samples(4:5) seleziona 40 e 50. In un codice generale si può usare samples(end-1:end) dopo aver verificato che esistano almeno due elementi.

Indice del corso · Lezione precedente

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 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.

Vettore colonna e dimensioni nel debugger Octave.
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.

Indice del corso · Lezione precedente

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 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 e prodotti per elemento nel debugger Octave.
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.

Indice del corso · Lezione precedente

D34 — Funzioni e file .m

In un progetto Octave una funzione di supporto può risiedere in un file .m separato. Il debugger permette di fermarsi nella funzione e leggere i frame che hanno portato alla chiamata.

Preparare il progetto

L’esempio usa main.m e adjust_sample.m. Il primo assegna 4 a sample e chiama adjust_sample; la funzione restituisce il valore aumentato di 1.

In Octave Scripts scegli Project → New Project, usa lo scope Session e main.m come entrypoint. Inserisci il contenuto di main.m, crea il file adjust_sample.m con Project → New file e inserisci la funzione. Il nome del file corrisponde al nome della funzione. Salva l’intero progetto con File → Save All.

Fermarsi nella funzione

Apri adjust_sample.m dall’albero e imposta un breakpoint sulla riga result = value + 1. Avvia Start Debug: nella prova la freccia si ferma nella funzione e lo stack mostra adjust_sample e main.

Debugger fermo nella funzione Octave in un file separato.
Debugger Octave fermo nel file della funzione con value uguale a quattro.

Il valore locale value è 4. Con Step Out o Continue la funzione può tornare al chiamante; il risultato atteso del programma è ADJUSTED 5. Controlla sempre il percorso del file nello stack: un numero di riga senza il file non identifica completamente la posizione.

Esercizio

Quale file è l’entrypoint e quale contiene la funzione di supporto?

Soluzione ragionata

main.m è l’entrypoint; adjust_sample.m definisce la funzione chiamata. Il nome del file permette a Octave di risolvere la funzione nel progetto.

Indice del corso · Lezione precedente

D35 — Errori Octave e stack di origine

Quando uno script Octave fallisce, osserva il messaggio e il punto di origine, distinguendoli dai valori che il debugger aveva registrato durante l’ultima pausa.

Un indice fuori intervallo

Importa index_error.m. Il vettore contiene tre elementi, ma lo script usa index = 4. Imposta un breakpoint su value = samples(index) e avvia il debug. Prima dell’accesso, la prova mostra index = 4 e un vettore samples di forma 1 3:

Pausa prima di un indice errato.
Pausa prima dell’accesso fuori intervallo in Octave.

Premi Continue. Nella prova il Job termina con FAILED e il messaggio segnala che samples(4) è fuori dai limiti di un vettore con tre elementi, indicando l’origine alla riga 5.

Errore Octave e ultimo stato osservato.
Messaggio di errore Octave e indicazione dell’ultima pausa.

Le variabili indicate come last paused sono l’ultima fotografia osservata, non locali vivi dopo l’errore. Un frame già uscito dallo stack non va presentato come ancora selezionabile. Per approfondire apri Program output / diagnostics e consulta messaggio e flussi disponibili.

Correzione

Se l’obiettivo è leggere il terzo elemento, la copia index_fixed.m usa index = 3 e stampa SAMPLE 30. Se l’indice proviene da un input, valida i limiti in base al problema prima di accedere al vettore.

Esercizio

Quali sono gli indici validi per questo vettore di tre elementi in Octave?

Soluzione ragionata

Sono 1, 2 e 3. L’indice 4 richiederebbe un quarto elemento.

Indice del corso · Lezione precedente

D36 — Pause non disponibile in Octave

Nella versione GX-TXT usata per la guida, l’adapter gestito di GNU Octave non offre un Pause asincrono verificato. Il pulsante è disabilitato; per fermarsi in un punto noto si usano breakpoint e comandi di passo.

Pianificare la pausa

Usa temperature_fixed.m, registrato nella Session. Metti un breakpoint sulla stampa e avvia il debug. La prova si ferma sulla riga richiesta: la freccia gialla e il punto rosso sono visibili nel gutter.

Breakpoint Octave e Pause disabilitato.
Debugger Octave fermo su un breakpoint, con Pause disabilitato.

In questo esempio la pausa avviene prima della stampa, dopo il calcolo del valore in kelvin. Puoi usare Step Over o Continue secondo l’obiettivo e Stop per annullare. Per un ciclo più lungo, scegli prima una riga eseguibile nel corpo del ciclo e controlla a ogni arresto la variabile dell’iterazione.

La D30 ha mostrato una richiesta asincrona su Python: non trasferire automaticamente quella capacità all’adapter Octave. Un’interruzione del processo non equivale necessariamente a una pausa ispezionabile.

Esercizio

Vuoi fermarti a ogni iterazione di un ciclo Octave nella versione di riferimento. Quale metodo puoi preparare prima dell’avvio?

Soluzione ragionata

Imposta un breakpoint su una riga eseguibile del ciclo e usa Continue tra una pausa e la successiva, osservando la variabile di iterazione.

Indice del corso · Lezione precedente

Consolidati i controlli sui linguaggi, passiamo agli input gestiti da GX-TXT e alla distinzione tra errori di calcolo e risposte del Bridge.

Modulo 05 precedente · Indice dei 10 moduli · Modulo 07 successivo

#debugger #GNU Octave #GX-TXT

Altre tappe del progetto

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *