Octave avanzato A06 — Contesto, parametri e identità dello script
Corso avanzato di GNU Octave con GX-TXT · Modulo 01
Una stessa analisi può essere riutilizzata con parametri diversi senza modificare il codice sorgente. In GX-TXT la dichiarazione del parametro, il valore scelto nel Runner e il contesto di esecuzione hanno ruoli distinti.
Obiettivi e prerequisiti
Dopo il corso base e le prime lezioni avanzate sappiamo registrare ed eseguire uno script. Qui dichiariamo un parametro numerico, lo leggiamo dal contesto e applichiamo una precondizione scientifica. La prova usa GX-TXT dev112-P011-bis e GNU Octave 9.4.0.
Dichiarare e leggere un parametro
Importa parametri_contesto.m, assegnagli
un ID e salvalo nella Session. Apri Run → Open Script
Runner: il Runner presenta il campo frequency con
valore iniziale 5.0. Avvia quindi il Job.
% Advanced Octave course A06: typed parameters and execution context.
% SPDX-License-Identifier: GPL-3.0-or-later
gxtxt_parameter_declare('frequency', 'double', 'default', 5.0, ...
'min', 0.0, 'description', 'Frequency in Hz');
ctx = gxtxt_context();
frequency = ctx.parameters.frequency;
fprintf('Script: %s\n', ctx.script_name);
fprintf('Frequency: %.3f Hz\n', frequency);
if frequency <= 0
error('Frequency must be positive to compute a period.');
endif
fprintf('Period: %.3f s\n', 1 / frequency);
La dichiarazione descrive nome, tipo, default, limite inferiore e
descrizione del parametro. Il valore effettivo arriva dal contesto, qui
con ctx.parameters.frequency: la chiamata di dichiarazione
non assegna da sola la variabile Octave frequency.
Il calcolo usa la relazione T = 1/f. Il limite
dichiarato ammette zero, mentre il periodo richiede una frequenza
strettamente positiva; per questo lo script effettua una verifica
aggiuntiva prima della divisione. La descrizione specifica gli hertz,
mentre il periodo viene presentato in secondi: l’unità ha significato
nel modello, non viene aggiunta automaticamente a un numero Octave.
Nella prova la frequenza scelta è 5 Hz e il periodo
restituito è 0,200 s. Con 10 Hz il valore
atteso è 0,100 s; ripeti lo script cambiando il parametro e
controlla il risultato. Il contesto include anche informazioni
sull’esecuzione e sull’identità dello script: usa soltanto i campi
previsti dalla documentazione della versione installata.
Parametri affidabili
Una dichiarazione di tipo e limite facilita l’interazione, ma non esaurisce le verifiche scientifiche. Per esempio, un valore numericamente accettabile potrebbe essere incompatibile con l’intervallo fisico di un esperimento specifico. Se il calcolo dipende da più parametri, verifica anche le relazioni fra essi e documenta i valori usati nel risultato.
Il salvataggio registra lo script e consente al framework di rilevare le dichiarazioni ammesse: cambiare una copia del file sorgente esterno non aggiorna automaticamente lo script già registrato nella Session.
Esercizio
- Qual è il periodo atteso con frequenza
2 Hz? - Perché la guardia
frequency <= 0resta utile anche se il minimo dichiarato è zero? - Dove viene letto il valore scelto nel Runner?
Soluzione ragionata
0,5 s.- Il limite permette zero, ma la formula del periodo richiede una frequenza positiva.
- Dal campo
parameters.frequencydel contesto restituito dagxtxt_context().
Il prossimo modulo approfondirà schema e lettura dei Dataset scientifici.