Serie multiple, stili e legende

di Giux GX-TXT, python-it, scripts-it 3 min di lettura

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.

Script per due serie nell'editor GX-TXT.
Script per due serie nell'editor GX-TXT.
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.

Grafico reale delle due serie sintetiche A e B, con legenda e unità.
Grafico reale delle due serie sintetiche A e B, con legenda e unità.

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

  1. Quali Dataset alimentano le due curve?
  2. Che cosa succede alla lista series se aggiungi un terzo dizionario valido?
  3. Perché non basta assegnare la stessa etichetta a entrambe le serie?

Soluzione ragionata

  1. A usa corso_python_serie_sintetica; B usa corso_python_seconda_serie.
  2. La specifica contiene una terza serie: occorre assegnarle ID univoco, riferimenti validi e una presentazione leggibile.
  3. 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.

Scarica gli script del Modulo 06 (ZIP)

#GX-TXT #Python #Visualizzazione scientifica

Altre tappe del progetto

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *