Corso Python scientifico in GX-TXT · Modulo 1 · Lezione 5

Nella lezione precedente abbiamo trattato sequenze ordinate. Un dizionario permette invece di associare un valore a una chiave: è utile quando un dato ha campi con significati differenti, come nome, volume e incertezza di un campione o le operazioni offerte da un’API.

Obiettivi: costruire un dict, accedere ai campi, usare get e items, distinguere un campo assente da un valore None e leggere descrizioni pubbliche di GX-TXT.

Prerequisiti: variabili, stringhe, liste e slicing delle lezioni 1–4.

Coppie chiave–valore

Un dizionario si scrive fra parentesi graffe. Ogni coppia contiene una chiave, due punti e un valore:

campione = {"nome": "soluzione sintetica", "volume_ml": 2.5}
print(campione["volume_ml"])

L’output è 2.5. Le chiavi dell’esempio sono stringhe; i valori possono avere tipi diversi. Le chiavi di un dizionario devono essere uniche e utilizzabili come chiavi: stringhe e numeri sono esempi comuni. Una chiave ripetuta in un letterale lascia il valore associato all’ultima occorrenza, quindi va evitata se non è intenzionale.

Il volume è un dato inventato per imparare, non una misura. Il suffisso _ml e la documentazione indicano millilitri: il numero 2.5 da solo non incorpora l’unità né un’incertezza. Per un dato reale occorre conservare anche provenienza, unità e incertezza appropriate.

Accedere, aggiungere e modificare

campione["nome"] legge un campo obbligatorio. Se la chiave non esiste, Python solleva KeyError. Per un campo facoltativo possiamo usare campione.get("temperatura"): quando la chiave manca, restituisce None per impostazione predefinita. È possibile specificare un valore alternativo, ad esempio campione.get("temperatura", "non specificata").

Un dizionario è mutabile: campione["volume_ml"] = 3.0 aggiorna il campo, mentre campione["unita"] = "mL" ne aggiunge uno. Come per le liste, altro = campione crea un secondo riferimento allo stesso oggetto; campione.copy() crea una copia superficiale. Se i valori contengono liste o dizionari, questi possono rimanere condivisi nella copia superficiale.

Assente non significa nullo

Considera:

campione = {"incertezza_ml": None}
print("incertezza_ml" in campione)  # True
print("temperatura" in campione)    # False

La chiave incertezza_ml è presente, ma il suo valore è None, che qui usiamo per indicare che non è stato fornito un valore. La chiave temperatura è assente. get senza valore alternativo restituirebbe None in entrambi i casi: per distinguere le situazioni usa in oppure un valore sentinella appropriato. None non è zero e non certifica che l’incertezza sia nulla.

Dizionari annidati e iterazione

Un valore può essere a sua volta un dizionario:

misura = {"volume": {"valore": 2.5, "unita": "mL"}}
print(misura["volume"]["unita"])

La prima coppia di parentesi accede al dizionario interno, la seconda alla sua chiave unita. Prima di usare dati provenienti da una fonte esterna occorre conoscere la struttura attesa; non tutti i campi devono necessariamente essere presenti.

d.items() fornisce coppie chiave–valore. L’esempio seguente anticipa il ciclo for, che approfondiremo nel modulo successivo: a ogni passaggio chiave e valore ricevono una coppia e il corpo indentato viene eseguito.

for chiave, valore in campione.items():
    print(chiave, valore)

Non modificare la dimensione dello stesso dizionario durante questa iterazione. L’ordine di inserimento è conservato nelle versioni moderne di Python, ma quando consumi risposte di un servizio non assumere che quell’ordine abbia un significato scientifico.

Descrivere le API di GX-TXT

gxtxt_api_list() restituisce un elenco di descrizioni pubblicate dal bridge; ogni voce osservata include api_id. gxtxt_api_describe(api_id) prende un identificativo e restituisce un descrittore strutturato con campi come identificativo, versione, provider e operazioni. La presenza di un’operazione nel descrittore non garantisce che ogni dato in ingresso sia adatto né che una risorsa esterna sia configurata.

Nello script scegliamo fino a due voci effettivamente presenti con api[:2], leggiamo il loro identificativo e chiediamo il rispettivo descrittore. Stampiamo le chiavi disponibili e il campo operations quando presente. Il numero e il contenuto delle API dipendono dalla Session e dalla versione; non usare gli identificativi visualizzati nella figura come elenco fisso. Se la lista è vuota, il ciclo non stampa descrizioni, senza inventarne.

Codice completo

from gxtxt import gxtxt_api_list, gxtxt_api_describe, gxtxt_context

campione = {"nome": "soluzione sintetica", "volume_ml": 2.5, "incertezza_ml": None}
print("Campione:", campione)
print("Volume (mL):", campione["volume_ml"])
print("Incertezza dichiarata:", campione.get("incertezza_ml"))
print("Temperatura presente:", "temperatura" in campione)
print("Modulo:", gxtxt_context().get("module_id"))

api = gxtxt_api_list()
for voce in api[:2]:
    identificatore = voce["api_id"]
    descrizione = gxtxt_api_describe(identificatore)
    print("API:", identificatore)
    print("Campi del descrittore:", list(descrizione.keys()))
    print("Operazioni:", descrizione.get("operations", "non specificate"))

list(descrizione.keys()) crea una lista delle chiavi del descrittore per visualizzarle. La slice limita l’output a due descrizioni; non ne cambia il contenuto. Il campo obbligatorio api_id è letto con parentesi quadre, così un’eventuale risposta priva del campo produce un errore visibile anziché nascondere il problema.

Script sui dizionari nell'editor Python di GX-TXT.
Script sui dizionari nell'editor Python di GX-TXT.

Il dizionario sintetico e le chiamate al bridge nell’editor.

Esecuzione

  1. Apri una Session, quindi Viewers → Python Scripts.
  2. Importa dizionari_api.py con File → Import .py…, assegna nome e Script ID nello scope session e salva.
  3. Apri Run → Open Script Runner…, premi Run Job e leggi l’output al termine.
  4. Controlla Volume (mL): 2.5, Incertezza dichiarata: None e Temperatura presente: False. Se almeno due API sono disponibili, osserva anche i due identificativi e i campi dei loro descrittori.
Output del dizionario e delle descrizioni delle API in GX-TXT.
Output del dizionario e delle descrizioni delle API in GX-TXT.

Il campione sintetico e un estratto dei descrittori realmente disponibili nell’esecuzione.

Errore frequente

Scrivere campione["temperatura"] quando il campo è assente solleva KeyError. Se la temperatura è facoltativa, verifica prima la presenza oppure usa get con un valore di riserva. Se invece è necessaria per il calcolo, l’assenza va segnalata: sostituirla automaticamente con zero cambierebbe il significato scientifico del dato.

Esercizio

Crea misura = {"valore": 12.0, "unita": "mV", "incertezza": None}. Stampa il valore con la sua unità; verifica se la chiave incertezza è presente e se la chiave temperatura è presente. Spiega perché il primo controllo è vero anche se l’incertezza è None.

Soluzione ragionata
misura = {"valore": 12.0, "unita": "mV", "incertezza": None}
print(misura["valore"], misura["unita"])
print("incertezza" in misura)  # True
print("temperatura" in misura)  # False

in controlla le chiavi, non se il valore associato sia noto. Il valore di esempio è sintetico e non costituisce una misura reale.

Nella prossima lezione affronteremo le eccezioni e i controlli prima delle chiamate alle API.

Scarica gli script del Modulo 01 (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 *