Serie multiple, stili e legende
Corso Python scientifico in GX-TXT · Modulo 6 · Lezione 34
Un grafico con più serie permette di confrontare andamenti sullo stesso sistema di riferimento. In questa lezione pubblichiamo una seconda serie sintetica e la mostriamo insieme alla prima, mantenendo identità e unità esplicite.
Obiettivi
- Comporre una lista di serie in un PlotSpec.
- Collegare ogni serie al proprio Dataset e alle proprie variabili.
- Distinguere le curve mediante etichette e legenda.
- Interpretare un confronto senza confondere dati sintetici e misure.
Preparazione
La serie A è nel Dataset corso_python_serie_sintetica.
Lo script pubblica la serie B nel Dataset
corso_python_seconda_serie, con tempi
[0, 0.5, 1, 1.5] s e valori
[1.0, 1.1, 1.2, 1.3] mV. Entrambe sono costruite per il
corso: nessuna rappresenta osservazioni reali.
Nella Sessione corso_python, importa serie_multiple.py, salva lo script
e avvialo da Run → Open Script Runner → Run Job.

import numpy as np
from gxtxt import gxtxt_api_call, gxtxt_api_require
gxtxt_api_require("DATASET_PUBLICATION_API_v2@2")
gxtxt_api_require("PLOT_DATASET_API_v4@4")
tempo = np.array([0., 0.5, 1., 1.5])
seconda = np.array([1.0, 1.1, 1.2, 1.3])
richiesta = {"dataset_id": "corso_python_seconda_serie", "contract": "table.generic", "storage": "csv", "replace_owned": True,
"x_values": tempo, "y_values": seconda,
"x_variable": {"variable_id": "tempo", "name": "tempo", "unit": "s", "semantic_role": "time"},
"y_variable": {"variable_id": "segnale", "name": "segnale", "unit": "mV", "semantic_role": "voltage"},
"provenance": "Seconda serie sintetica didattica"}
gxtxt_api_call("DATASET_PUBLICATION_API_v2", "publish_series", [richiesta])
api = "PLOT_DATASET_API_v4"
spec = gxtxt_api_call(api, "new_spec", ["plot.dataset.xy", "Due serie sintetiche"])
spec["panels"][0]["series"] = [
{"id": "prima", "dataset_id": "corso_python_serie_sintetica", "x_variable_id": "tempo", "y_variable_id": "segnale", "axis": "left", "kind": "line_marker", "label": "Serie sintetica A"},
{"id": "seconda", "dataset_id": "corso_python_seconda_serie", "x_variable_id": "tempo", "y_variable_id": "segnale", "axis": "left", "kind": "line_marker", "label": "Serie sintetica B"}]
print("Spec valido:", gxtxt_api_call(api, "validate_spec", [spec]))
plot = gxtxt_api_call(api, "create_plot", [spec, "variant"])
gxtxt_api_call(api, "set_panel_axis", [plot, "main", "x", {"label": "Tempo (s)", "display_unit": "s"}])
gxtxt_api_call(api, "set_panel_axis", [plot, "main", "y_left", {"label": "Segnale (mV)", "display_unit": "mV", "min": 0.0, "max": 2.0}])
print("Grafico:", plot)
print("Rendering:", gxtxt_api_call(api, "render", [plot]).get("execution"))
La lista assegnata a series contiene due dizionari. Ogni
dizionario ha un ID della serie, un Dataset e due ID di variabili. Il
campo label fornisce il testo della legenda;
kind: line_marker disegna una linea e i punti. Il programma
usa lo stesso asse Y perché entrambe le variabili sono espresse in mV e
sono confrontabili nell’esempio. La scelta va verificata per ogni nuovo
Dataset.

In questo rendering la serie A è blu e la B è rossa, con etichette esplicite. I colori sono parte della presentazione; la legenda associa ogni traccia al suo nome. Per grafici destinati anche alla stampa in bianco e nero o a lettori con difficoltà nella distinzione dei colori, scegli inoltre tratteggi o marcatori diversi quando disponibili, e verifica la leggibilità. Non affidarti soltanto al colore.
Leggere il confronto
A 0,5 s la serie A vale 1,5 mV e la B
1,1 mV. La differenza è 0,4 mV ai punti
indicati. Il grafico non dice che una serie sia una misura e l’altra una
previsione: entrambe sono sintetiche. Se confronti invece osservazioni e
modello, dichiaralo nei nomi e nella descrizione, senza attribuire alle
stime lo stato di misure.
Esercizio
- Quali Dataset alimentano le due curve?
- Che cosa succede alla lista
seriesse aggiungi un terzo dizionario valido? - Perché non basta assegnare la stessa etichetta a entrambe le serie?
Soluzione ragionata
- A usa
corso_python_serie_sintetica; B usacorso_python_seconda_serie. - La specifica contiene una terza serie: occorre assegnarle ID univoco, riferimenti validi e una presentazione leggibile.
- La legenda non permetterebbe di distinguere chiaramente le sorgenti. Le etichette devono identificare ciò che rappresentano.
Nella prossima lezione separeremo le serie in pannelli coordinati con un asse temporale condiviso.