Dataset Preview — consultare i dati canonici e la tracciabilità dei punti

La scheda Canonical Data del Dataset Preview consente di leggere le coordinate scientifiche pubblicate dal Curve Digitalizer e di risalire, per ciascun punto, all’identità della curva, della calibrazione e della posizione sul raster originale. È una vista di consultazione: non modifica il Dataset e non ricostruisce i dati partendo dall’immagine.

Per illustrare la paginazione utilizziamo un raster didattico sintetico da 1280 × 900 pixel. Tre delle cinque tracce sono state digitalizzate con 22 punti ciascuna, per un totale di 66 righe canoniche. I punti comprendono posizioni intermedie aggiunte lungo le tracce sintetiche tramite il Viewer: non rappresentano misure sperimentali né costituiscono una stima dell’incertezza fisica.

1. Perché serve Canonical Data

Un grafico può mostrare le curve corrette, ma non consente sempre di distinguere tutti i punti, le loro identità e le informazioni di origine. Canonical Data affianca alla rappresentazione grafica una lettura tabellare dei valori effettivamente pubblicati.

È utile per verificare i numeri prima di effettuare analisi successive, distinguere le varie curve e riconoscere la provenienza dei punti. La fonte resta il Dataset canonico della Session.

2. La calibrazione precedente alla pubblicazione

Il lavoro parte dal Curve Digitalizer, con asse X Elapsed time (s) da 0 a 10 e asse Y Detector response (mV) da −20 a 80, su scale lineari. Sono stati accettati quattro riferimenti di calibrazione BL, BR, TL e TR.

Figura 1. Calibrazione reale dell’immagine sintetica nella scheda Calibration del Viewer, con intervalli e unità dichiarate.

La calibrazione definisce la trasformazione fra coordinate pixel e coordinate scientifiche. Un ingrandimento della tabella o del grafico non modifica questa trasformazione.

3. Tre curve indipendenti per superare una pagina

Nell’esempio sono state create Bias -2 V, Bias -1 V e Bias +0 V, ciascuna con 22 punti. Per ottenere un esercizio sufficientemente lungo sono state inserite posizioni intermedie sul disegno sintetico, senza utilizzare un’acquisizione strumentale.

Figura 2. Scheda Curves con tre serie e 66 punti ottenuti attraverso le azioni originali del Viewer.

Le due tracce aggiuntive del raster originale non fanno parte delle curve pubblicate. Un’immagine con cinque linee non implica la presenza di cinque serie numeriche.

4. Scegliere l’output numerico da pubblicare

Nella scheda Publish è stata selezionata una calibrazione accettata e la modalità separate. Il piano mostra il Dataset numerico previsto per quella realizzazione.

Figura 3. Piano nativo di pubblicazione per l’esempio scientifico da 66 punti.

L’identificativo del Dataset in uscita deve essere distinto dall’ID dell’immagine sorgente. La pubblicazione numerica conserva entrambi i riferimenti.

5. Confermare la pubblicazione

Premere Publish selected calibrations. In questo caso il Viewer conferma una pubblicazione riuscita, con un Dataset numerico, tre curve e 66 righe scientifiche.

Figura 4. Conferma reale dell’operazione Publish nella finestra del Curve Digitalizer.

Non è necessario ripetere Publish per cambiare pagina, visualizzazione o numero di cifre della tabella.

6. Selezionare il Dataset nel browser GX-TXT

Nella finestra principale aprire Dataset → Preview. Nel pannello Datasets scegliere la pubblicazione numerica, non l’Image Dataset precedente.

Figura 5. Il Dataset numerico è attivo nel browser del framework e presenta le schede aggiuntive del Curve Digitalizer.

La scheda Canonical Data compare quando il Preview riconosce una pubblicazione compatibile e il relativo contributo è disponibile.

7. La prima apertura non legge tutte le righe

Selezionare Canonical Data. Prima di richiedere i dati, le tabelle possono essere vuote. Il messaggio del pannello indica di caricare la prima pagina.

Figura 6. Scheda Canonical Data appena aperta, prima del caricamento della pagina numerica.

Il vuoto iniziale non equivale a un Dataset senza punti: l’utente deve ancora richiedere la pagina.

8. Load, Prev, Next e Precision

Nella barra superiore compaiono Load, Prev, Next e il selettore Precision. I primi tre controllano l’accesso alle pagine canoniche; Precision cambia il formato numerico visualizzato.

Figura 7. Barra originale dei comandi di Canonical Data e sottoschede Scientific values e Point traceability.

Nell’esempio, dopo Load, la prima pagina contiene fino a 50 righe. Il CORE prepara i dati attraverso i propri servizi, senza un lettore CSV indipendente del Preview.

9. Caricare la prima pagina con Load

Fare clic su Load. Si apre la prima pagina dei valori canonici, con un messaggio che specifica il numero di righe disponibili e lo stato della pagina successiva.

Figura 8. La vista Scientific values mostra le righe iniziali del Dataset da 66 punti.

L’esempio restituisce Canonical rows 1–50. I valori non sono ricalcolati durante la lettura della tabella.

10. Le colonne di Scientific values

La tabella Scientific values contiene Row, Curve, Point, X (physical), Y (physical), Axis, Calibration, Sigma X, Sigma Y e Cov XY.

Figura 9. Dettaglio delle intestazioni e dei primi valori numerici della tabella scientifica.

X e Y sono le coordinate espresse nelle unità pubblicate; nell’esempio, rispettivamente s e mV. Le altre colonne descrivono identità, ordinamento e campi di incertezza eventualmente disponibili.

11. Row e Point sono numerazioni differenti

Row identifica la posizione della riga nel Dataset, partendo da 1. Point rappresenta l’ordine del punto all’interno della curva, partendo da 0 nell’esempio.

Quando inizia una nuova curva, Point riparte da zero mentre Row continua ad aumentare. Non utilizzare uno di questi due numeri come sostituto dell’identificativo persistente del punto.

12. Passare da Scientific values a Point traceability

Selezionare la sottoscheda Point traceability. I valori mostrati sono collegati alle stesse righe canoniche, ma la tabella espone i riferimenti tecnici necessari a ricostruirne la provenienza.

Figura 10. Point traceability per la prima pagina, con identificativi e coordinate pixel.

È un cambio di vista dello stesso Dataset: non crea un’altra tabella scientifica indipendente e non modifica la calibrazione.

13. Curve ID, Point ID e Calibration ID

Le colonne Curve ID, Point ID e Calibration ID identificano rispettivamente la serie, il singolo punto e la calibrazione usata per la pubblicazione.

Figura 11. Dettaglio originale degli identificativi di tracciabilità pubblicati nel Dataset.

Questi identificativi vanno trattati come riferimenti, non come valori da convertire in ascisse o ordinate. L’eventuale somiglianza di due nomi leggibili non garantisce l’identità degli oggetti.

14. Pixel X e Pixel Y non sono le coordinate fisiche

Le colonne Pixel X e Pixel Y riportano le posizioni sul raster originale. Non devono essere confuse con X (physical) e Y (physical), ottenute dalla trasformazione di calibrazione.

Per esempio, una posizione orizzontale misurata in pixel non è automaticamente un tempo in secondi. Le coordinate pixel servono soprattutto per collegare ogni riga alla sorgente.

15. Come interpretare la tracciabilità

Usare il valore di Row per accostare, nella stessa pagina, una riga della vista Scientific values alla corrispondente riga di Point traceability. Il Point ID permette di identificare il punto anche quando il nome della curva non è sufficientemente specifico.

In questa pubblicazione in modalità separate, l’identità della calibrazione è unica per le tre curve. Una pubblicazione combinata può richiedere una differenziazione esplicita fra realizzazioni: non assumere che tutti i Datasets abbiano lo stesso schema.

16. La seconda pagina con Next

La vista iniziale contiene 50 righe. Premere Next per consultare le righe che rimangono, dalla 51 alla 66.

Figura 12. Scientific values dopo Next: la seconda pagina del Dataset contiene 16 righe.

La pagina successiva non inizia da 1: il numero di riga conserva la posizione originale nel Dataset.

17. Point traceability nella seconda pagina

Anche sulla pagina 51–66 è possibile passare a Point traceability per vedere le identità e le coordinate raster dei punti rimanenti.

Figura 13. Ultimi sedici punti nella vista di tracciabilità, con gli identificativi originali.

Il passaggio da una sottoscheda all’altra non deve alterare la pagina selezionata: si consultano le stesse righe sotto due rappresentazioni differenti.

18. Cosa succede premendo Next all’ultima pagina

Quando non esistono ulteriori righe, il messaggio di stato indica Next: end. Il comando Next può rimanere visivamente azionabile, ma nell’installazione mostrata un ulteriore clic non cambia la pagina.

Figura 14. Barra e stato sulla seconda pagina: non sono disponibili righe oltre la 66.

Verificare il numero di riga e il messaggio di fine pagina, non soltanto l’aspetto del pulsante.

19. Tornare con Prev

Premere Prev per tornare alle prime 50 righe. I valori numerici e gli identificativi della pagina già letta riappaiono senza una nuova pubblicazione.

Sulla prima pagina, premere ancora Prev non causa una pagina con numeri negativi. La navigazione resta dentro i limiti del Dataset corrente.

Il comando Prev permette di ritornare alla pagina con Canonical rows 1–50. La schermata recuperata è identica a quella della prima pagina di Point traceability già illustrata: non è necessario duplicarla per mostrare il ritorno.

Per controllare il risultato verificare l’intervallo di righe indicato dal pannello e la corrispondenza fra Row, Curve ID, Point ID e coordinate raster. Cambiare pagina non modifica gli identificativi persistenti né crea un nuovo Dataset.

20. Load riporta alla prima pagina

La voce Load richiede la prima pagina canonica. Serve sia alla prima apertura sia quando si desidera ricominciare la consultazione dall’inizio.

Non è equivalente a Publish. La lettura può beneficiare di una cache del CORE, mentre l’identità scientifica dei dati e il numero delle righe rimangono quelli registrati.

21. Le tre opzioni di Precision

Il selettore Precision propone 6 digits, 10 digits e Full precision. Le opzioni riguardano il modo in cui vengono stampati numeri già presenti nel Dataset.

La scelta non aumenta l’accuratezza della misura, non introduce nuovi decimali significativi nello strumento che ha generato i dati e non modifica i valori canonici memorizzati.

22. Il formato 6 digits

All’apertura viene utilizzato 6 digits. Nel caso illustrato la prima coordinata X è mostrata come 0.897959, con un numero limitato di cifre.

Questo formato è utile per leggere rapidamente molte righe. L’arrotondamento visualizzato non cancella le cifre aggiuntive eventualmente conservate nel Dataset.

23. Il formato 10 digits

Aprire Precision e selezionare 10 digits. La stessa prima X viene visualizzata come 0.8979591837: cambiano le cifre mostrate, non la posizione fisica del punto.

Figura 15. La tabella con la selezione 10 digits e il dettaglio numerico visualizzato.

È un compromesso fra leggibilità e riproduzione delle cifre disponibili.

24. Il formato Full precision

Selezionare Full precision per mostrare la rappresentazione numerica a piena precisione disponibile in questa vista. Nel caso illustrato la prima coordinata X è 0.89795918367347027.

Figura 16. Le coordinate a Full precision, senza limitazione a sei o dieci cifre.

Il valore può apparire con più cifre rispetto a quelle utili per un esperimento reale. Precisione della rappresentazione numerica e incertezza della misura sono proprietà differenti.

25. Le cifre mostrate non cambiano il dato originale

La scelta Full precision permette di evitare parte dell’arrotondamento della visualizzazione, ma non è una dichiarazione di accuratezza sperimentale. Le rappresentazioni testuali di numeri in virgola mobile possono differire nella forma pur esprimendo lo stesso valore numerico.

Figura 17. Dettaglio delle colonne scientifiche con la rappresentazione Full precision.

Per un controllo rigoroso, usare le API del Dataset e la tracciabilità, non il semplice conteggio dei decimali visibili in una cella.

26. Tornare alla visualizzazione 6 digits

Dopo avere esaminato i valori a precisione piena, selezionare nuovamente 6 digits. La tabella ritorna al formato iniziale.

Lo stesso principio vale per le coordinate pixel nella sottoscheda Point traceability.

Dopo aver selezionato 6 digits, la stessa pagina ritorna alla rappresentazione abbreviata, senza perdere le cifre numeriche eventualmente memorizzate nel Dataset. La schermata è identica a una vista già presentata e viene quindi sostituita qui da questa spiegazione.

Un confronto corretto fra 6 digits, 10 digits e Full precision deve riguardare la medesima riga e lo stesso identificativo di punto. Le differenze testuali dipendono dal formato di visualizzazione, non da una nuova trasformazione o da un aumento dell’accuratezza sperimentale.

27. Precisione e paginazione sono indipendenti

È possibile cambiare Precision anche dopo aver raggiunto la seconda pagina. La selezione del formato agisce sulle righe correntemente visualizzate, senza tornare necessariamente all’inizio.

Figura 18. Seconda pagina consultata con Full precision, mantenendo le righe dalla 51 alla 66.

Nel confronto fra due schermate, controllare quindi sia la pagina attiva sia l’opzione Precision selezionata.

28. Sigma X, Sigma Y e Cov XY

La tabella scientifica contiene anche le colonne Sigma X, Sigma Y e Cov XY. In questo esempio riportano Not published, perché la pubblicazione non include una dichiarazione numerica di incertezza fisica per i punti.

Un campo non pubblicato non deve essere letto come zero. Quando esistono incertezze correttamente dichiarate, le rispettive unità devono essere coerenti con gli assi scientifici.

29. Confronto con la scheda Curves e Plot Dataset v4

Passando alla scheda Curves dello stesso Preview e premendo Load curves si ottiene il grafico nativo delle tre serie, ora con 22 punti ciascuna.

Figura 19. Il medesimo Dataset da 66 righe visualizzato come tre curve tramite Plot Dataset API v4.

La tabella e il grafico non sono due pubblicazioni: rappresentano lo stesso Dataset con strumenti diversi.

30. Nascondere una curva nel Plot

Con la prima traccia selezionata, premere Hide nella scheda Curves. La prima linea scompare dal grafico, mentre le altre rimangono visibili.

Figura 20. Hide nasconde una linea nel Plot scientifico, ma non cancella i suoi 22 punti dal Dataset.

Questo comando modifica la presentazione. Non deve essere confuso con la cancellazione della curva all’interno del documento modificabile del Viewer.

31. Tornare a Canonical Data dopo Hide

Dopo avere nascosto una linea, tornare a Canonical Data. Le righe della curva nascosta risultano ancora presenti nella tabella, con gli stessi valori e identificativi.

È una verifica importante: un filtro di visibilità non deve modificare il Dataset su cui verranno eseguite analisi successive.

Per effettuare il controllo, tornare alla scheda Canonical Data, premere Load se la pagina non è già disponibile e verificare che le righe della curva nascosta siano ancora consultabili. I valori X (physical) e Y (physical) e gli identificativi devono corrispondere a quelli letti prima di Hide.

La stessa tabella di tracciabilità è già illustrata in precedenza: il punto essenziale non è riprodurre un’altra immagine, ma distinguere il filtro grafico Hide dalla cancellazione dei dati. La visibilità di una curva non determina il contenuto del Dataset canonico.

32. Ripristinare tutte le curve con Show all

Per tornare al grafico completo, nella scheda Curves premere Show all. Il renderer ripresenta le tre serie utilizzando i punti già pubblicati.

Figura 21. Show all ripristina il Plot completo senza una nuova pubblicazione.

Anche passando da Plot a Canonical Data e viceversa, la relazione fra immagine, punti e righe canoniche rimane la stessa.

33. Riscontri incrociati sulle due pagine

Nel caso illustrato la lettura delle due pagine ha restituito 50 + 16 = 66 righe. Le 66 righe sono state confrontate con il servizio pubblico di paginazione del CORE, verificando sia le coordinate scientifiche sia gli identificativi di tracciabilità.

Sono stati verificati anche i formati 6 digits, 10 digits e Full precision: la conversione del formato non altera il contenuto numerico memorizzato.

34. Gli identificativi permettono controlli migliori dei colori

La serie rappresentata in blu, rosso o verde può cambiare colore in un altro grafico. Gli identificativi Curve ID e Point ID consentono invece di riconoscere la provenienza del punto senza dipendere dalla tavolozza grafica.

Quando occorre documentare un’analisi scientifica, conservare il collegamento fra Dataset numerico, variabili, calibrazione e raster originale. Non ricostruire gli identificativi dai colori o dai nomi di visualizzazione.

35. Riepilogo del flusso di consultazione

Il flusso operativo è Dataset → Preview → selezionare il Dataset numerico → Canonical Data → Load. Consultare Scientific values, passare a Point traceability, utilizzare Next/Prev per le pagine e Precision per il formato dei numeri.

Nel nostro esercizio il Dataset contiene tre curve sintetiche per 66 punti, conserva la relazione fra coordinate fisiche e pixel originali e rimane invariato dopo la lettura delle pagine, i cambi di precisione e le operazioni Show/Hide nel Plot. Il contenuto canonico e la sua provenienza sono distinti dalla forma con cui vengono presentati.