Assi, unità, scala e titoli

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

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.

Script di configurazione degli assi nel Python Script Workspace.
Script di configurazione degli assi 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", "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.

Curva sintetica nel Viewer con asse verticale da 0 a 2 mV e unità nelle etichette.
Curva sintetica nel Viewer con asse verticale da 0 a 2 mV e unità nelle etichette.

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

  1. Quanto vale il segnale a 1 s? Come cambia il dato se l’asse Y viene esteso fino a 2 mV?
  2. Un’assegnazione label: "Segnale (V)" converte automaticamente dati in mV?
  3. È appropriato includere zero in un asse logaritmico?

Soluzione ragionata

  1. 1,3 mV; il dato non cambia, cambia soltanto la sua posizione nella rappresentazione.
  2. No. L’etichetta è testo; serve una conversione effettiva e coerente.
  3. 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.

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 *