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

Un ciclo while ripete un blocco finché una condizione rimane vera. È utile quando il numero di ripetizioni dipende da uno stato che cambia durante il lavoro, per esempio la posizione raggiunta nella lettura di un Dataset. Useremo la serie sintetica pubblicata nella lezione 9.

Obiettivi: costruire un while che termini; usare contatori e dimensioni di blocco; comprendere break, continue e sentinelle; leggere intervalli con l’API pubblica di GX-TXT.

Prerequisiti: condizioni, liste e cicli for; Dataset sintetico della lezione 9 nella Session.

La struttura di while

contatore = 0
while contatore < 3:
    print(contatore)
    contatore += 1

La condizione viene valutata prima di ogni passaggio. Finché è vera, Python esegue il blocco indentato; quando diventa falsa, prosegue dopo il ciclo. Qui vengono stampati 0, 1 e 2. contatore += 1 equivale a contatore = contatore + 1 per questo uso.

Se la condizione è falsa già all’inizio, il corpo non viene eseguito. Se dimentichi di aggiornare il contatore, la condizione può restare sempre vera e il ciclo può non terminare. Prima di eseguire un ciclo, individua la condizione di uscita e l’istruzione che fa avanzare lo stato.

break, continue e sentinelle

break termina il ciclo più interno; continue salta il resto dell’iterazione corrente e torna alla verifica della condizione. Con continue assicurati che l’aggiornamento necessario alla terminazione sia già avvenuto: altrimenti puoi creare un ciclo infinito.

Una sentinella è un valore scelto per indicare la fine di una sequenza, per esempio un messaggio esplicito di fine da una sorgente. Non usare un valore che potrebbe essere una misura valida come sentinella senza distinguere i due casi: uno zero può essere un dato scientifico reale.

Perché leggere per blocchi

Leggere un grande Dataset tutto insieme può richiedere molta memoria. Una lettura per blocchi richiede soltanto un intervallo limitato alla volta; permette anche di elaborare progressivamente i dati. Nell’esempio il Dataset è piccolo per rendere visibile il procedimento: quattro righe lette in due richieste di due righe.

La serie è sintetica, pubblicata nella lezione 9: segnali 1,2; 1,5; 1,3; 1,6 mV agli istanti 0; 0,5; 1,0; 1,5 s. Non sono misure sperimentali e non hanno un’incertezza assegnata. Assicurati di usare la Session e il Dataset creati nella lezione precedente.

API di lettura

CANONICAL_DATASET_API_v2/describe riceve un identificativo Dataset e restituisce metadati, fra cui il numero di righe. read_range riceve nell’ordine identificativo Dataset, lista degli identificativi di variabile, indice iniziale da zero e numero di righe. Restituisce una struttura indicizzata per ID di variabile, con i valori e metadati di forma e tipo.

Per non superare la fine, calcoliamo min(dimensione_blocco, numero_righe - inizio). Con quattro righe e blocchi di due, leggiamo gli intervalli che iniziano a 0 e 2. Dopo ogni lettura, incrementiamo inizio del numero di righe richieste. Se il Dataset è vuoto, il ciclo non effettua letture e la lista resta vuota.

Codice completo

from gxtxt import gxtxt_api_call, gxtxt_api_require

gxtxt_api_require("CANONICAL_DATASET_API_v2@2")
dataset_id = "corso_python_serie_sintetica"
descrizione = gxtxt_api_call("CANONICAL_DATASET_API_v2", "describe", [dataset_id])
numero_righe = int(descrizione["row_count"])
inizio = 0
dimensione_blocco = 2
valori = []
while inizio < numero_righe:
    quanti = min(dimensione_blocco, numero_righe - inizio)
    blocco = gxtxt_api_call("CANONICAL_DATASET_API_v2", "read_range", [dataset_id, ["segnale"], inizio, quanti])
    elementi = blocco["segnale"]["values"]
    valori.extend(elementi)
    print("Righe da", inizio, "numero", quanti, ":", elementi)
    inizio += quanti
print("Righe lette:", len(valori), "su", numero_righe)
print("Segnale ricomposto (mV):", valori)

extend aggiunge alla lista gli elementi restituiti per il blocco. Nella versione mostrata i dati numerici arrivano come array a colonna: ogni riga della lista ricomposta appare quindi come un piccolo array, non come uno scalare Python. Approfondiremo shape e array nel modulo 3. Qui controlliamo ordine e numero di righe, senza attribuire al formato una diversa unità o precisione.

Per Dataset molto grandi, accumulare tutti i blocchi in valori torna a richiedere memoria proporzionale all’intero insieme. L’elaborazione realmente progressiva dovrebbe calcolare o salvare il risultato di ogni blocco senza conservarli tutti, quando il problema lo consente.

Script di lettura per blocchi nell'editor Python di GX-TXT.
Script di lettura per blocchi nell'editor Python di GX-TXT.

Il ciclo aggiorna l’indice iniziale dopo ogni richiesta.

Esecuzione e controllo

  1. Apri la Session in cui hai eseguito la lezione 9 e verifica che contenga corso_python_serie_sintetica.
  2. In Viewers → Python Scripts, importa lettura_blocchi.py, assegna nome e Script ID nello scope session e salva.
  3. Apri Run → Open Script Runner…, premi Run Job e osserva l’output al termine.
  4. Devono comparire due blocchi da due righe, iniziando a 0 e 2; il totale deve essere 4 su 4. Confronta i valori nell’ordine con la serie originale della lezione 9.
Output della lettura di quattro righe in due blocchi.
Output della lettura di quattro righe in due blocchi.

Le righe lette nei due blocchi ricostruiscono la serie sintetica senza salti o duplicazioni.

Errore comune: un intervallo di troppo

Se il ciclo usasse inizio <= numero_righe, dopo aver letto l’ultima riga tenterebbe un’ulteriore richiesta a partire dalla posizione 4. Con indici da zero, quattro righe hanno posizioni da 0 a 3: la condizione corretta è inizio < numero_righe. Non aggiungere 1 al contatore dopo aver già avanzato di quanti, altrimenti salteresti una riga.

Esercizio

Per sette righe e blocchi di tre, quali sono gli indici iniziali e le dimensioni richieste? Applica la regola min(3, numero_righe - inizio).

Soluzione ragionata

Le richieste iniziano a 0, 3 e 6; le dimensioni sono rispettivamente 3, 3 e 1. Coprono le righe 0–2, 3–5 e 6. Poi inizio diventa 7 e la condizione inizio < numero_righe è falsa.

Nella prossima lezione raccoglieremo operazioni ripetute in funzioni riutilizzabili.

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 *