Assi, unità, scala e titoli
Corso Python scientifico in GX-TXT · Modulo 6 · Lezione 33
Lo stesso Dataset può essere mostrato con limiti e titoli diversi. Una buona presentazione rende leggibili le grandezze e non nasconde il significato delle variazioni. In questa lezione confrontiamo due grafici della stessa serie sintetica.
Obiettivi
- Impostare titoli e proprietà degli assi con la Plot API.
- Indicare le unità fisiche nelle etichette.
- Riconoscere l’effetto dei limiti sulla percezione della curva.
- Scegliere una scala coerente con il dominio dei dati.
Esempio pratico
La serie sintetica contiene tempi in secondi e segnali in millivolt.
Nella Sessione corso_python, importa assi_unita.py, salvalo nel Python
Script Workspace e avvialo da Run → Open Script Runner → Run
Job.

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", "Segnale sintetico"])
spec["panels"][0]["series"] = [{"id": "segnale", "dataset_id": "corso_python_serie_sintetica",
"x_variable_id": "tempo", "y_variable_id": "segnale", "axis": "left", "kind": "line_marker"}]
plot = gxtxt_api_call(api, "create_plot", [spec, "variant"])
gxtxt_api_call(api, "set_panel_title", [plot, "main", "Serie sintetica"])
gxtxt_api_call(api, "set_panel_axis", [plot, "main", "x", {"label": "Tempo (s)", "display_unit": "s", "scale": "linear"}])
gxtxt_api_call(api, "set_panel_axis", [plot, "main", "y_left", {"label": "Segnale (mV)", "display_unit": "mV", "scale": "linear", "min": 0.0, "max": 2.0}])
risultato = gxtxt_api_call(api, "render", [plot])
print("Grafico:", plot)
print("Asse X: tempo in s, scala lineare")
print("Asse Y: segnale in mV, scala lineare, limiti 0–2")
print("Rendering:", risultato.get("execution"))
Lo script crea una variante, assegna un titolo al pannello
main e configura i due assi con
set_panel_axis. Per X usa secondi, per Y millivolt;
entrambe le scale sono lineari. I limiti Y sono fissati da 0 a 2 mV.
L’etichetta è testo: quando la scegliamo esplicitamente includiamo
l’unità, perché deve corrispondere alla grandezza effettivamente
mostrata. display_unit stabilisce invece l’unità di
visualizzazione secondo il contratto dell’API; cambiare soltanto il
testo dell’etichetta non converte i valori.

Confronta questa figura con quella della lezione 32: la curva proviene dagli stessi quattro punti, ma lì l’intervallo verticale si adatta più strettamente ai dati. Una scala più ampia fa apparire più piccole le variazioni; una scala più stretta le evidenzia. Nessuna delle due cambia i dati. La scelta deve essere dichiarata e adatta alla domanda, soprattutto quando si confrontano figure diverse.
Scale e unità
Una scala lineare assegna distanze uguali a differenze numeriche uguali. Una scala logaritmica rappresenta rapporti: per una scala logaritmica reale occorrono valori positivi nel dominio visualizzato. Zero e numeri negativi non sono ammessi su un normale asse logaritmico. Prima di scegliere una scala, controlla dati, limiti e unità; non cambiare unità scrivendo soltanto un’altra etichetta.
Quando confronti due segnali, usa unità compatibili e limiti coerenti
con lo scopo. Se la variabile è in mV e desideri visualizzarla in V, una
conversione corretta cambia i valori visualizzati di un fattore 1000:
1 mV = 0,001 V. L’unità mostrata deve seguire la
conversione effettiva.
Esercizio
- Quanto vale il segnale a
1 s? Come cambia il dato se l’asse Y viene esteso fino a 2 mV? - Un’assegnazione
label: "Segnale (V)"converte automaticamente dati in mV? - È appropriato includere zero in un asse logaritmico?
Soluzione ragionata
1,3 mV; il dato non cambia, cambia soltanto la sua posizione nella rappresentazione.- No. L’etichetta è testo; serve una conversione effettiva e coerente.
- No: il logaritmo di zero non è definito. Occorre scegliere una scala e un dominio compatibili.
Nella prossima lezione confronteremo più serie e lavoreremo sulla loro identificazione visiva.