Parametri avanzati e validazione del modello

di Giux GX-TXT, python-it, scripts-it 2 min di lettura

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.

Script dei parametri nel Python Script Workspace.
Script dei parametri nel Python Script Workspace.
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.

Seconda configurazione nel Runner: sei campioni e intervallo 0,25 s.
Seconda configurazione nel Runner: sei campioni e intervallo 0,25 s.
Output del secondo Job: parametri scelti e durata 1,25 s.
Output del secondo Job: parametri scelti e durata 1,25 s.

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

  1. Qual è la durata di cinque campioni con passo di 0,2 s?
  2. Perché la formula usa n - 1?
  3. Qual è il vantaggio di durata(numero=5, passo=0.2) rispetto a due numeri senza nomi?

Soluzione ragionata

  1. (5 - 1) × 0,2 = 0,8 s.
  2. Cinque punti consecutivi delimitano quattro intervalli.
  3. I nomi rendono esplicito il significato degli argomenti e riducono il rischio di scambiarli.

Nella prossima lezione esploreremo Sessione, Workspace e note scientifiche.

Scarica gli script del Modulo 07 (ZIP)

#GX-TXT #Python #Riproducibilità

Altre tappe del progetto

Lascia un commento

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