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

  1. Apri una Session e il Viewer Python Scripts.
  2. Importa parametri_runner.py, assegna un nome e uno Script ID nello scope session, quindi salva.
  3. Apri Run → Open Script Runner…. I tre controlli compaiono con i default dichiarati.
  4. Imposta campioni a 6, intervallo_s a 0.2 e deseleziona attivo.
  5. Premi Run Job e apri l’output quando l’esecuzione è conclusa.
Runner GX-TXT con i tre parametri modificati per l'esempio.
Runner GX-TXT con i tre parametri modificati per l'esempio.

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.

Output dello script con valori e tipi dei parametri.
Output dello script con valori e tipi dei parametri.

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.

Scarica gli script del Modulo 02 (ZIP)

#GX-TXT #Python #Script Runner

Altre tappe del progetto

Lascia un commento

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