Dizionari, dati strutturati e introspezione
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.

Il dizionario sintetico e le chiamate al bridge nell’editor.
Esecuzione
- Apri una Session, quindi Viewers → Python Scripts.
- Importa
dizionari_api.pycon File → Import .py…, assegna nome e Script ID nello scopesessione salva. - Apri Run → Open Script Runner…, premi Run Job e leggi l’output al termine.
- Controlla
Volume (mL): 2.5,Incertezza dichiarata: NoneeTemperatura presente: False. Se almeno due API sono disponibili, osserva anche i due identificativi e i campi dei loro descrittori.

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) # Falsein 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.