Debugger GX-TXT · Modulo 06 — Octave: casi fondamentali
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.
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.
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.
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.
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:
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.
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.
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
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