Parametri tipizzati e Runner GX-TXT
Corso Python scientifico in GX-TXT · Modulo 2 · Lezione 12
Uno script riutilizzabile non dovrebbe richiedere una modifica del codice per ogni esecuzione. In GX-TXT possiamo dichiarare parametri tipizzati nel sorgente: il Runner presenta controlli adatti e lo script legge i valori scelti dalla Session di esecuzione.
Obiettivi: dichiarare parametri letterali con
gxtxt_parameter_declare; scegliere tipo, default e limiti;
modificare i valori nel Runner; leggere parameters dal
contesto e distinguere validazione tecnica da validità scientifica.
Prerequisiti: variabili e tipi, condizioni e funzioni delle lezioni precedenti.
Parametri dello script e parametri di una funzione
Nella lezione 11 abbiamo scritto parametri nella firma di una funzione Python. Qui dichiariamo invece parametri di esecuzione dello script: sono valori che il Runner raccoglie prima di avviare il programma e rende disponibili nel contesto GX-TXT. I due concetti sono collegati dall’idea di un valore in ingresso, ma vengono configurati in punti diversi.
Un valore predefinito (default) viene proposto quando non ne
è stato scelto un altro. Un tipo indica quale forma di dato il Runner
deve accettare: integer per un intero, double
per un numero in virgola mobile e boolean per vero/falso.
Le unità restano una parte del significato scientifico: il nome
intervallo_s e la descrizione indicano secondi, ma non
effettuano conversioni automatiche.
Dichiarare tre parametri
gxtxt_parameter_declare("campioni", "integer", default=4, min=1, max=100,
description="Numero di campioni sintetici")
I primi due argomenti sono il nome e il tipo; le opzioni
default, min, max e
description specificano rispettivamente valore proposto,
limiti e testo di aiuto. Per la scoperta statica GX-TXT richiede la
forma pubblica e valori letterali nelle dichiarazioni: non calcola
espressioni arbitrarie per costruire lo schema. Dichiarazioni non
letterali, duplicate o in conflitto con nomi definiti altrove possono
essere rifiutate al salvataggio.
Lo script dell’esempio dichiara campioni da 1 a 100,
intervallo_s da 0 a 10 e attivo come booleano.
Il Runner usa questi vincoli per controllare l’input. Il limite
min=0.0 per l’intervallo è una scelta didattica: per molti
strumenti reali un intervallo zero non sarebbe fisicamente utilizzabile
e servirebbe un vincolo più rigoroso.
Leggere i valori scelti
gxtxt_context()["parameters"] restituisce il dizionario
dei parametri effettivi dell’esecuzione. Lo script legge le chiavi
dichiarate e usa i valori già tipizzati:
parametri = gxtxt_context()["parameters"]
campioni = parametri["campioni"]
type(campioni) permette di osservare che il valore
ricevuto è un intero. Non è necessario interpretare a mano il testo
digitato nel controllo quando il Runner ha già fornito il valore
tipizzato. Non assumere comunque che la validazione del tipo dimostri la
correttezza del modello scientifico.
Esempio: campionamento sintetico
Per sei campioni separati da 0,2 s, la durata tra il primo e l’ultimo
è (6 − 1) × 0,2 = 1,0 s. Il booleano attivo è
stampato per mostrare un terzo tipo di parametro; in questo esempio
non controlla l’acquisizione e non impedisce il calcolo
della durata. Sono dati sintetici scelti per l’esercizio, non misure
effettuate e senza incertezza assegnata.
Codice completo
from gxtxt import gxtxt_context, gxtxt_parameter_declare
gxtxt_parameter_declare("campioni", "integer", default=4, min=1, max=100, description="Numero di campioni sintetici")
gxtxt_parameter_declare("intervallo_s", "double", default=0.5, min=0.0, max=10.0, description="Intervallo in secondi")
gxtxt_parameter_declare("attivo", "boolean", default=True, description="Campionamento attivo")
parametri = gxtxt_context()["parameters"]
campioni = parametri["campioni"]
intervallo_s = parametri["intervallo_s"]
attivo = parametri["attivo"]
print("Campioni:", campioni, type(campioni))
print("Intervallo (s):", intervallo_s, type(intervallo_s))
print("Attivo:", attivo, type(attivo))
print("Durata sintetica (s):", (campioni - 1) * intervallo_s)
Le dichiarazioni sono parte del sorgente salvato. Cambiare i valori nel Runner modifica gli input di quella esecuzione, non riscrive i default nello script. Se modifichi una dichiarazione, salva nuovamente e controlla i campi proposti prima di eseguire.
Esecuzione nel Runner
- Apri una Session e il Viewer Python Scripts.
- Importa
parametri_runner.py, assegna un nome e uno Script ID nello scopesession, quindi salva. - Apri Run → Open Script Runner…. I tre controlli compaiono con i default dichiarati.
- Imposta
campionia6,intervallo_sa0.2e deselezionaattivo. - Premi Run Job e apri l’output quando l’esecuzione è conclusa.

I valori scelti nel Runner: sei campioni, 0,2 s e booleano disattivato.
Nell’output devono comparire 6 come int,
0.2 come float, False come
bool e durata 1.0 s. Le rappresentazioni
decimali floating point possono richiedere tolleranze in altri
calcoli.

Il programma riceve i valori modificati e calcola la durata sintetica attesa.
Errori e limiti
Se un valore è fuori dai limiti dichiarati o non è compatibile con il tipo, il Runner può rifiutare l’esecuzione e indicare il campo da correggere. Non aggirare il controllo convertendo qualsiasi input in modo silenzioso: per esempio, trasformare un numero frazionario in intero può troncarlo e cambiare il significato dei dati.
Anche un input tecnicamente valido può essere scientificamente inappropriato. Prima di applicare lo script a un esperimento reale, stabilisci se il numero di campioni, l’intervallo, l’unità e l’incertezza sono adeguati allo strumento e alla domanda scientifica.
Esercizio
Senza modificare il codice, scegli nel Runner
campioni = 5, intervallo_s = 0.5 e
attivo = True. Prevedi durata e tipi, poi esegui lo
script.
Soluzione ragionata
La durata attesa è (5 − 1) × 0.5 = 2.0 s. I tipi attesi
sono int, float e bool; il
booleano viene mostrato ma non cambia il calcolo. Il risultato descrive
la sequenza sintetica proposta, non una misura sperimentale.
Nel prossimo modulo passeremo dalle sequenze Python agli array numerici.