Octave avanzato A06 — Contesto, parametri e identità dello script

di Giux GX-TXT, octave-it, scripts-it 3 min di lettura

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.

Runner GX-TXT con il parametro numerico frequency impostato a 5 Hz.
Runner GX-TXT con il parametro numerico frequency impostato a 5 Hz.
% 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.

Output del Job: frequenza 5 Hz e periodo 0,200 secondi.
Output del Job: frequenza 5 Hz e periodo 0,200 secondi.

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

  1. Qual è il periodo atteso con frequenza 2 Hz?
  2. Perché la guardia frequency <= 0 resta utile anche se il minimo dichiarato è zero?
  3. Dove viene letto il valore scelto nel Runner?

Soluzione ragionata

  1. 0,5 s.
  2. Il limite permette zero, ma la formula del periodo richiede una frequenza positiva.
  3. Dal campo parameters.frequency del contesto restituito da gxtxt_context().

Il prossimo modulo approfondirà schema e lettura dei Dataset scientifici.

Scarica gli script del Modulo 01 (ZIP)

#GX-TXT #Octave #Script Runner

Altre tappe del progetto

Lascia un commento

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