Pannelli multipli e asse X condiviso

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

Corso Python scientifico in GX-TXT · Modulo 6 · Lezione 35

Quando due serie si sovrappongono o hanno significati diversi, pannelli separati possono rendere più chiaro il confronto. Condividere l’asse X permette di confrontare gli stessi istanti senza obbligare le variabili a condividere l’asse verticale.

Obiettivi

  • Aggiungere un pannello e assegnargli una serie.
  • Attivare la disposizione multipannello e configurare l’asse X condiviso.
  • Leggere le unità e i limiti Y di ciascun pannello.
  • Distinguere una scelta di layout da una trasformazione dei dati.

Prepara il grafico

L’esempio usa i Dataset sintetici delle lezioni precedenti: corso_python_serie_sintetica e corso_python_seconda_serie. Completa la lezione 34 per pubblicare il secondo Dataset. Nella Sessione corso_python, importa pannelli.py, salva lo script e avvialo da Run → Open Script Runner → Run Job.

Script dei pannelli nel Python Script Workspace.
Script dei pannelli nel Python Script Workspace.
from gxtxt import gxtxt_api_call, gxtxt_api_require

gxtxt_api_require("PLOT_DATASET_API_v4@4")
api = "PLOT_DATASET_API_v4"
spec = gxtxt_api_call(api, "new_spec", ["plot.dataset.xy", "Due segnali sintetici"])
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 A"}]
plot = gxtxt_api_call(api, "create_plot", [spec, "variant"])
gxtxt_api_call(api, "add_panel", [plot, "secondo"])
gxtxt_api_call(api, "set_multi_panel", [plot, 1])
spec = gxtxt_api_call(api, "load_spec", [plot])
spec["panels"][1]["series"] = [{"id": "seconda", "dataset_id": "corso_python_seconda_serie", "x_variable_id": "tempo", "y_variable_id": "segnale", "axis": "left", "kind": "line_marker", "label": "Serie B"}]
gxtxt_api_call(api, "apply_spec", [plot, spec])
gxtxt_api_call(api, "set_panel_title", [plot, "main", "Serie A sintetica"])
gxtxt_api_call(api, "set_panel_title", [plot, "secondo", "Serie B sintetica"])
gxtxt_api_call(api, "set_panel_axis", [plot, "main", "y_left", {"label": "A (mV)", "min": 0., "max": 2.}])
gxtxt_api_call(api, "set_panel_axis", [plot, "secondo", "y_left", {"label": "B (mV)", "min": 0., "max": 2.}])
gxtxt_api_call(api, "shared_x_axis_set", [plot, {"display_unit": "s", "scale": "linear"}])
print("Pannelli:", gxtxt_api_call(api, "panel_ids", [plot]))
print("Grafico:", plot)
print("Rendering:", gxtxt_api_call(api, "render", [plot]).get("execution"))

Dopo la creazione della prima variante, add_panel aggiunge il pannello secondo e set_multi_panel attiva la disposizione. load_spec legge la specifica; aggiungiamo la serie B al secondo pannello e applichiamo la nuova struttura con apply_spec. I titoli chiariscono quali dati sono mostrati. Ogni asse Y ha etichetta e limiti propri; qui abbiamo scelto per entrambi l’intervallo 0–2 mV per facilitare il confronto.

shared_x_axis_set imposta la scala e l’unità dell’asse condiviso. Le due variabili temporali devono essere compatibili: il fatto che due colonne si chiamino entrambe tempo non basta da solo a dimostrarlo. In questo esempio sono entrambe in secondi e descrivono la stessa griglia sintetica.

Due pannelli GX-TXT con serie sintetiche e asse temporale condiviso.
Due pannelli GX-TXT con serie sintetiche e asse temporale condiviso.

A 1 s, la serie A vale 1,3 mV e la B 1,2 mV. Le tracce sono separate, ma le posizioni orizzontali corrispondono agli stessi tempi. L’asse X condiviso coordina la lettura: non riscalda né converte arbitrariamente le ordinate. Se i pannelli rappresentano grandezze diverse, ciascuno deve conservare la propria unità e una scala giustificata.

Esercizio

  1. Quale pannello contiene la serie B?
  2. Se cambi il limite Y del secondo pannello, hai cambiato i valori del Dataset?
  3. Quale controllo serve prima di condividere l’asse temporale di due Dataset?

Soluzione ragionata

  1. Il pannello secondo, visualizzato sotto il primo.
  2. No: hai cambiato la presentazione. La modifica può però influire sulla percezione delle variazioni.
  3. Verifica che le coordinate rappresentino la stessa grandezza e abbiano unità compatibili, oltre a controllarne il significato temporale.

Nella prossima lezione aggiungeremo informazioni testuali al grafico distinguendo annotazione e dati.

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 *