Corso Python scientifico in GX-TXT · Modulo 2 · Lezione 9

Un ciclo ripete un blocco per ogni elemento di una sequenza. In questa lezione attraverseremo liste e intervalli, poi useremo un ciclo per elencare Dataset realmente presenti in una Session GX-TXT. Per rendere l’esempio riproducibile, lo script prepara una piccola serie sintetica se non è già presente.

Obiettivi: usare for, range ed enumerate; capire unpacking e indentazione; interrogare il catalogo Dataset con API pubbliche e riconoscere il costo delle chiamate ripetute.

Prerequisiti: liste e dizionari del modulo 1, condizioni e booleani delle lezioni 7–8.

Un elemento alla volta

letture_mv = [1.2, 1.5, 1.3]
for lettura in letture_mv:
    print(lettura, "mV")

Per ogni elemento della lista, Python associa il valore corrente al nome lettura ed esegue il blocco indentato. Dopo l’ultimo elemento il ciclo termina. Se la lista è vuota, il corpo non viene eseguito. I valori qui sono sintetici: non sono misure e non hanno un’incertezza assegnata.

Il nome dopo for è una variabile ordinaria: il suo valore cambia a ogni iterazione. Evita di modificare la lunghezza della lista mentre la attraversi, perché è facile saltare o ripetere elementi. Se occorre trasformarla, prepara una nuova lista o usa una procedura esplicita.

range e posizioni

range(4) genera gli interi 0, 1, 2 e 3: il limite finale è escluso, come nello slicing. range(1, 4) produce 1, 2 e 3; range(0, 6, 2) produce 0, 2 e 4. Un ciclo può usare questi valori senza costruire prima una lista completa:

for indice in range(3):
    print(indice)

Se ti servono solo i valori di una lista, iterare direttamente sugli elementi è in genere più chiaro. Se ti servono posizione e valore insieme, usa enumerate.

enumerate e unpacking

for posizione, lettura in enumerate(letture_mv, start=1):
    print(posizione, lettura)

enumerate fornisce coppie posizione–valore. Python assegna i due elementi della coppia ai nomi posizione e lettura: questo si chiama unpacking. start=1 rende la numerazione più comoda da leggere, ma non cambia gli indici della lista, che continuano a partire da zero. Se una riga mostra posizione 1, il corrispondente indice Python è 0.

Un’altra forma di unpacking è x, y = (0.5, 1.5). Il numero di nomi deve essere compatibile con il numero di valori; altrimenti Python segnala un errore.

Il catalogo della Session

L’API pubblica CANONICAL_DATASET_API_v2 offre list per ottenere gli identificativi dei Dataset della Session e describe per leggere i metadati di un Dataset identificato. Tramite il client Python si usa gxtxt_api_call(api_id, operazione, argomenti): list riceve una lista di argomenti vuota, describe riceve l’identificativo in una lista.

Per la prova creiamo, se necessario, un Dataset chiamato corso_python_serie_sintetica con DATASET_PUBLICATION_API_v2/publish_series. I tempi sono [0.0, 0.5, 1.0, 1.5] s e i segnali [1.2, 1.5, 1.3, 1.6] mV. Sono valori sintetici scelti per il corso, non misure sperimentali; non è stata assegnata un’incertezza. La pubblicazione usa gli identificativi di variabile tempo e segnale e metadati che dichiarano la natura didattica.

Se l’identificativo è già nel catalogo, lo script non lo sovrascrive. Il controllo del nome da solo non dimostra che un Dataset preesistente contenga questi stessi dati: usa una Session dedicata al corso e, se esiste già un Dataset con quel nome ma diverso, scegline uno libero o controllane il contenuto prima di proseguire.

Codice completo

from gxtxt import gxtxt_api_call, gxtxt_api_require

gxtxt_api_require("CANONICAL_DATASET_API_v2@2")
gxtxt_api_require("DATASET_PUBLICATION_API_v2@2")
catalogo = gxtxt_api_call("CANONICAL_DATASET_API_v2", "list", [])
identificatore = "corso_python_serie_sintetica"
if identificatore not in catalogo:
    richiesta = {
        "dataset_id": identificatore, "contract": "table.generic", "storage": "csv",
        "x_values": [0.0, 0.5, 1.0, 1.5], "y_values": [1.2, 1.5, 1.3, 1.6],
        "x_variable": {"variable_id": "tempo", "name": "tempo", "unit": "s", "semantic_role": "time"},
        "y_variable": {"variable_id": "segnale", "name": "segnale", "unit": "mV"},
        "structured_metadata": {"experimental.sample": "serie sintetica didattica"},
    }
    gxtxt_api_call("DATASET_PUBLICATION_API_v2", "publish_series", [richiesta])
    catalogo = gxtxt_api_call("CANONICAL_DATASET_API_v2", "list", [])
print("Numero Dataset:", len(catalogo))
for posizione, dataset_id in enumerate(catalogo, start=1):
    descrizione = gxtxt_api_call("CANONICAL_DATASET_API_v2", "describe", [dataset_id])
    print(posizione, dataset_id, "campi:", list(descrizione.keys()))

Il dizionario richiesta descrive la serie e le sue variabili. Dopo la pubblicazione ricarichiamo il catalogo. Il ciclo visita ogni identificativo, chiede la descrizione e mostra le chiavi disponibili; i campi e l’ordine dipendono dal contenuto e dalla versione della Session.

Script che crea una serie sintetica ed elenca i Dataset nell'editor GX-TXT.
Script che crea una serie sintetica ed elenca i Dataset nell'editor GX-TXT.

Lo script nel Viewer Python; il codice completo è disponibile nel file della lezione.

Esecuzione

  1. Apri una Session dedicata al corso e il Viewer Python Scripts.
  2. Importa catalogo_dataset.py, assegna nome e Script ID nello scope session, quindi salva.
  3. Apri Run → Open Script Runner… e premi Run Job. La prima esecuzione pubblica la serie sintetica se l’identificativo non è presente.
  4. Leggi l’output e confronta il Dataset elencato con il catalogo della Session. Una Session può contenere più Dataset; la figura mostra un esempio con un solo elemento.
Output del catalogo Dataset nella Session GX-TXT.
Output del catalogo Dataset nella Session GX-TXT.

La Session di esempio contiene il Dataset sintetico del corso.

Attenzione al costo delle chiamate

Il ciclo effettua una chiamata describe per ogni Dataset. Per un catalogo grande o remoto, ogni chiamata può richiedere tempo: evita di richiedere ripetutamente gli stessi metadati se puoi conservarli durante l’elaborazione. Non assumere che la posizione di un Dataset nel catalogo sia stabile; usa il suo identificativo.

Esercizio

Data la lista sintetica tempi = [0.0, 0.5, 1.0], stampa una numerazione a partire da 1 e il tempo in secondi. Cosa succede se la lista è vuota?

Soluzione ragionata
tempi = [0.0, 0.5, 1.0]
for posizione, tempo in enumerate(tempi, start=1):
    print(posizione, tempo, "s")

Le righe sono numerate 1, 2 e 3; gli indici interni rimangono 0, 1 e 2. Con una lista vuota il corpo non viene eseguito e non viene stampata nessuna riga.

Nella prossima lezione leggeremo la serie per blocchi con un ciclo while.

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 *