Prima curva 2D nel Viewer GX-TXT
Corso Python scientifico in GX-TXT · Modulo 6 · Lezione 32
Creiamo un grafico persistente a partire da un Dataset canonico della Sessione. Useremo il PlotSpec preparato nella lezione precedente e chiederemo a GX-TXT di renderizzare la serie sintetica del corso.
Obiettivi
- Associare un’ascissa e un’ordinata a una serie.
- Validare lo spec, creare una variante e richiedere il rendering.
- Aprire il risultato nella finestra grafica di GX-TXT e leggere gli assi.
- Distinguere l’oggetto grafico dai dati sorgente e dall’immagine visualizzata.
Dati e scelta degli assi
La serie corso_python_serie_sintetica contiene quattro
coppie sintetiche: tempo 0, 0,5,
1, 1,5 s e segnale 1,2,
1,5, 1,3, 1,6 mV. In questo
esempio il tempo è la coordinata orizzontale, mentre il segnale è la
coordinata verticale. line_marker mostra i punti e li
collega con segmenti: il collegamento aiuta la lettura, ma non trasforma
i valori intermedi in misure.
Crea il grafico
Nella Sessione corso_python, importa prima_curva.py, salva lo script nel
Python Script Workspace e avvialo con 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 nel tempo"])
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"}]
print("PlotSpec valido:", gxtxt_api_call(api, "validate_spec", [spec]))
riferimento = gxtxt_api_call(api, "create_plot", [spec, "variant"])
print("Riferimento grafico:", riferimento)
risultato = gxtxt_api_call(api, "render", [riferimento])
print("Rendering completato:", risultato)
La validazione controlla la specifica. create_plot crea
una variante e restituisce un riferimento; render usa quel
riferimento per generare la rappresentazione. Conserva l’identità
restituita se devi riaprire o modificare lo stesso grafico. Ogni nuova
creazione di una variante può produrre un’identità diversa.
Nella scheda Plots di GX-TXT seleziona la variante creata. Il grafico compare nell’anteprima; facendo doppio clic sull’immagine puoi aprirlo nella finestra grafica e usare i comandi di adattamento e zoom.

Nota sulla versione. La guida è stata realizzata con GX-TXT dev112-P011-bis. In questa versione, l’opzione per nascondere la legenda nello
native_presentationpuò impedire la creazione del grafico anche quando la specifica risulta valida. Per questo non è disponibile uno screenshot della curva con la legenda nascosta: la figura sopra mostra il rendering effettivo con la configurazione predefinita, nella quale la legenda copre l’ultimo punto. Il comportamento previsto è mostrare la curva completa senza legenda quando si sceglieplacement: none. Secondo l’indicazione fornita per il corso, il problema è corretto in dev112-P012 e nelle versioni successive; la correzione non è stata verificata su questa installazione P011-bis.
Il titolo indica che si tratta di dati sintetici. Le etichette degli assi riportano le unità delle variabili. L’immagine è una rappresentazione del Dataset: non sostituisce i dati, gli ID o le scelte dello spec. Se le etichette o la disposizione non sono leggibili, nella prossima lezione vedremo come intervenire sulle opzioni del grafico.
Controlla la lettura
A 0,5 s la serie raggiunge 1,5 mV; a
1 s scende a 1,3 mV. La scala verticale
mostrata è adattata ai dati, quindi non parte necessariamente da zero:
quando confronti grafici diversi controlla i limiti degli assi, oltre
alla forma della linea.
Esercizio
- Quali campi della serie scelgono X e Y?
- Qual è il valore sintetico a
1 s? - Il segmento tra due punti prova che siano stati misurati tutti i valori intermedi?
Soluzione ragionata
x_variable_idey_variable_id, rispettivamentetempoesegnale.1,3 mV.- No. Il segmento è una scelta grafica che collega punti disponibili; i valori intermedi non diventano nuove misure.
Nella prossima lezione affineremo titoli, unità e scale.