Parametri avanzati e validazione del modello
Corso Python scientifico in GX-TXT · Modulo 7 · Lezione 37
I parametri permettono di riutilizzare lo stesso script con valori diversi senza modificarne il codice. In questa lezione dichiariamo tipo, valore predefinito e intervallo ammesso, poi confrontiamo due esecuzioni nel Runner.
Obiettivi
- Dichiarare parametri con tipo, descrizione e limiti.
- Leggere i valori scelti e lo schema dal contesto del Job.
- Usare argomenti esclusivamente nominali in una funzione Python.
- Verificare i dati anche all’interno del calcolo.
Il problema
Per n campioni equidistanti, il tempo fra primo e ultimo
campione è (n - 1) × passo: gli intervalli sono uno in meno
dei punti. Con quattro campioni a distanza di 0,5 s la durata è 1,5 s;
con sei campioni a distanza di 0,25 s è 1,25 s. Sono parametri sintetici
per l’esercizio.
Esegui lo script
Importa parametri_validazione.py
nella Sessione corso_python, salvalo e apri Run →
Open Script Runner.

from gxtxt import gxtxt_context, gxtxt_parameter_declare
gxtxt_parameter_declare("campioni", "integer", default=4, min=2, max=100, description="Numero di campioni sintetici")
gxtxt_parameter_declare("intervallo_s", "double", default=0.5, min=0.01, max=10.0, description="Passo temporale in secondi")
def durata(*, numero, passo):
if numero < 2 or passo <= 0:
raise ValueError("Servono almeno due campioni e un passo positivo")
return (numero - 1) * passo
contesto = gxtxt_context()
p = contesto["parameters"]
print("Parametri scelti:", p)
print("Schema disponibile:", contesto["parameter_schema"])
print("Durata (s):", durata(numero=p["campioni"], passo=p["intervallo_s"]))
gxtxt_parameter_declare dichiara campioni
intero fra 2 e 100 e intervallo_s reale fra 0,01 e 10 s. I
default sono rispettivamente 4 e 0,5.
gxtxt_context()["parameters"] espone i valori della singola
esecuzione; parameter_schema descrive lo schema e la
provenienza delle dichiarazioni.
Nella definizione def durata(*, numero, passo),
l’asterisco richiede di chiamare gli argomenti per nome:
durata(numero=..., passo=...). Questo rende più chiaro
quale valore rappresenti il numero di campioni e quale il passo. La
funzione verifica anche che i valori siano significativi per il proprio
calcolo e segnala un errore se non lo sono.
Esegui prima con i default. Poi riapri il Runner, imposta
campioni a 6 e intervallo_s a 0,25 e avvia un
secondo Job, senza cambiare lo script.


Il secondo output mostra i valori selezionati e
Durata (s): 1.25. Conservare insieme versione dello script
e parametri della singola esecuzione permette di comprendere come è
stato ottenuto un risultato. Cambiare il codice dopo aver verificato il
Runner produce uno script diverso: salva e controlla nuovamente prima di
eseguirlo.
Esercizio
- Qual è la durata di cinque campioni con passo di 0,2 s?
- Perché la formula usa
n - 1? - Qual è il vantaggio di
durata(numero=5, passo=0.2)rispetto a due numeri senza nomi?
Soluzione ragionata
(5 - 1) × 0,2 = 0,8 s.- Cinque punti consecutivi delimitano quattro intervalli.
- I nomi rendono esplicito il significato degli argomenti e riducono il rischio di scambiarli.
Nella prossima lezione esploreremo Sessione, Workspace e note scientifiche.