Snapping, ordinamento scientifico e cronologia Undo/Redo

Questa guida spiega come utilizzare Snap to dark, Radius, Monotonicity, Point ordering source, Undo e Redo. Le procedure si svolgono su un raster sintetico con punti scuri di riferimento e due curve numeriche, per mostrare come vengono conservati pixel, coordinate scientifiche e ordine dei punti.

1. Un raster sintetico con due riferimenti scuri

La sorgente è un PNG scientifico sintetico di 1280 × 900 pixel, con cinque tracce colorate e due piccoli punti neri di riferimento denominati SNAP A e SNAP B.

Figura 1. Il raster sintetico contiene due pixel neri di riferimento, utilizzati per illustrare lo snapping locale.

I riferimenti sono stati aggiunti al raster di prova esclusivamente per distinguere il clic effettuato dall’operatore dal punto memorizzato dopo lo snapping. Non sono curve numeriche pubblicate e non rappresentano dati strumentali o standard di calibrazione.

2. Calibrazione scientifica prima della selezione dei pixel

L’immagine è stata importata come singolo Dataset canonico image.raster, in una Session di esempio. Il Curve Digitalizer ha usato una calibrazione a quattro punti accepted, con assi Elapsed time X = 0–10 s e Detector response Y = −20–80 mV, entrambi linear.

Figura 2. Tutte le operazioni di snapping e di ordinamento utilizzano la medesima omografia di calibrazione accettata.

I punti provvisori, quelli di prova e i punti ordinati sono sempre trasformati usando gli stessi quattro angoli. Questo evita che differenze di coordinate siano attribuite a un cambiamento non controllato di scala o di raster.

3. Dove si trovano i controlli

La scheda Curves contiene Display and snapping, con la casella Snap to dark e lo spinbox Radius. Gli stessi parametri sono disponibili anche da Configuration → Viewer settings… → Digitizing, dove le etichette diventano Snap to darkest pixel e Snap radius (pixels).

Figura 3. Le impostazioni di snapping, monotonicità e ordinamento si modificano attraverso i controlli del Viewer.

Nella stessa scheda Digitizing sono disponibili Monotonicity e Point ordering source. La finestra separa una bozza di impostazioni dal pulsante effettivo Apply.

4. Manual click non equivale sempre a Stored pixel

Il Viewer conserva due informazioni distinte: il pixel sorgente su cui è caduto il clic effettivo, cioè Manual click, e il pixel scelto dal criterio di snapping, cioè Stored pixel. Quest’ultimo viene trasformato nelle coordinate scientifiche X/Y.

Figura 4. Un raggio di ricerca positivo non sposta i punti se lo snapping è disabilitato.

Lo snapping non cambia i pixel originali del PNG, non riscrive i quattro angoli e non attribuisce automaticamente un significato fisico a una regione scura.

5. Snapping disabilitato, anche con raggio 10

La casella di snapping era disabilitata mentre Radius = 10. Un clic eseguito vicino a SNAP A ha mantenuto esattamente il pixel manuale.

Figura 5. Con lo snapping disattivato, le coordinate Manual click e Stored pixel coincidono.

Il Workspace ha registrato Manual click = Stored pixel = (506,475; 296,216) px. Il raggio è una preferenza memorizzata, ma resta inattivo finché il controllo Snap to dark non è abilitato.

6. Snapping abilitato con raggio zero

È stato quindi abilitato Snap to dark, ma con Radius = 0. Un clic vicino a SNAP B è rimasto ancora nel punto manuale.

Figura 6. Anche con la casella di snapping attiva, un raggio pari a zero non sposta il punto selezionato.
Figura 7. Vicino al riferimento nero B viene conservata l’esatta posizione del clic manuale.

Il valore memorizzato è risultato (692,489; 281,482) px, identico al clic. L’attivazione della casella senza un raggio positivo non determina uno spostamento.

7. Snapping con raggio 10: riferimento A

Con Snap to dark abilitato e Radius = 10, lo stesso clic vicino a SNAP A ha individuato il pixel nero originale al centro del riferimento.

Figura 8. Con questa configurazione viene attivata la ricerca locale del pixel più scuro per i successivi inserimenti.

La GUI ha mostrato:

Figura 9. Lo snapping verso il riferimento A modifica il pixel registrato e quindi le coordinate fisiche X e Y.
CampoValore
Manual click(506,475; 296,216) px
Stored pixel(500; 295) px
Spostamento nel rastercirca 6,588 px
X scientifica risultantecirca 3,622 s
Y scientifica risultantecirca 56,696 mV
Figura 10. Il riferimento nero appartiene al raster originale e non è un controllo grafico o un rilevatore di curve.

Il punto conserva la propria identità scientifica e due coordinate sorgente diverse. Il raster originale non viene modificato: cambia soltanto il pixel scientifico associato al punto aggiunto.

8. Snapping con raggio 10: riferimento B

È stato ripetuto il comando sul secondo riferimento. Il clic manuale vicino a B aveva coordinate circa (692,489; 281,482) px; il punto memorizzato è diventato (700; 280) px.

Figura 11. Il secondo punto viene spostato esattamente sul pixel scuro B dell’immagine sorgente.
Figura 12. Le posizioni dei riferimenti A e B possono essere individuate dai livelli di grigio del PNG originale.

Lo spostamento è pari a circa 7,656 pixel sorgente. Le nuove coordinate scientifiche sono circa X = 5,838 s e Y = 59,249 mV.

9. Verifica indipendente del pixel più scuro

Per controllare il risultato senza fidarsi soltanto dell’etichetta del Viewer, il PNG è stato convertito indipendentemente in intensità di grigio. Intorno al clic sono stati analizzati tutti i pixel compresi nel raggio impostato, riproducendo la finestra di ricerca del modello installato.

Per entrambi i riferimenti, nel rettangolo di ricerca era presente un unico pixel con intensità minima 0: rispettivamente (500,295) e (700,280). Questi erano esattamente i pixel scelti dal Viewer.

Non è una verifica di riconoscimento intelligente delle curve: è la dimostrazione di una ricerca locale del minimo di intensità, con scelta del candidato più vicino al clic quando esistono più pixel ugualmente scuri.

10. Il raggio è espresso in pixel della sorgente

Il programma analizza l’immagine in scala di grigi e calcola il rettangolo di ricerca intorno al pixel dell’immagine originale. Un raggio di 10 px corrisponde pertanto a pixel sorgente, non a dieci pixel di uno screenshot ridimensionato né a dieci unità di misura fisica.

Lo zoom del Viewer cambia il mapping del mouse verso il raster, ma non sostituisce la calibrazione scientifica. Lo snapping può attrarre il clic verso una scritta, una griglia o una traccia concorrente: è un aiuto locale, non un riconoscitore di curve e non una misura di incertezza.

11. Quattro punti di test, quattro condizioni documentate

La prima curva, Snapping test, contiene quattro punti: due inseriti senza correzione della posizione e due acquisiti con lo snapping verso il pixel più scuro attivato.

Gli ID dei quattro record sono distinti. Le coordinate manuali e quelle memorizzate coincidono solo nei casi senza snapping effettivo. Non è stata pubblicata alcuna tabella scientifica numerica; i punti risiedono nella Digitizer Configuration.

12. Edit → Undo: annullare l’ultimo inserimento

Il menu Edit contiene Undo (Ctrl+Z) e Redo (Ctrl+Y). Dopo aver creato il quarto punto, è stato eseguito il vero comando Edit → Undo.

Figura 13. Undo elimina l’ultimo punto inserito, lasciando invariati gli identificativi dei tre punti precedenti.

Il conteggio della curva è passato da quattro a tre, eliminando l’ultimo record dalla configurazione scientifica. Nessun altro punto è cambiato.

13. Edit → Redo: ripristinare lo stesso punto

Con Edit → Redo l’ultimo punto è ricomparso. Non è stata eseguita una nuova ricerca di pixel scuri.

Figura 14. Redo ripristina l’UUID originale del punto e i valori Manual click e Stored pixel.

Il workspace mantiene il medesimo UUID, il medesimo manual_click_pixel, il medesimo pixel e gli stessi valori X/Y che erano presenti prima di Undo.

14. Le scorciatoie da tastiera e il focus

Per annullare e ripristinare le modifiche si possono utilizzare anche le scorciatoie Ctrl+Z e Ctrl+Y, purché il Viewer abbia il focus.

Figura 15. La scorciatoia da tastiera con il focus corretto annulla l’ultimo punto come il comando Edit → Undo.
Figura 16. La scorciatoia Redo da tastiera ripristina il punto con il medesimo identificativo originale.

La sequenza passa da quattro a tre punti e nuovamente a quattro, ripristinando lo stesso record. Ctrl+Z e Ctrl+Y richiedono che il focus si trovi nella finestra corretta.

15. Una seconda curva per dimostrare l’ordine di inserimento

È stato creato un secondo oggetto Ordering demonstration, indipendente da Snapping test, lasciando disabilitato lo snapping.

Figura 17. Le operazioni di ordinamento vengono illustrate su una seconda curva, distinta da quella usata per lo snapping.

In modalità predefinita Monotonicity = None e Point ordering source = Insertion order, sono stati inseriti quattro punti con coordinate X nominali intenzionalmente non ordinate: 8, 2, 6, 4 s.

Figura 18. La sequenza originale dei clic corrisponde approssimativamente ai valori X di 8, 2, 6 e 4 secondi.
Figura 19. Insertion order conserva l’ordine dei clic, senza applicare automaticamente un ordinamento per X.

Il framework ha preservato esattamente questa sequenza di inserimento, senza riordinare automaticamente i punti per X o Y.

16. Perché la sequenza dei punti conta

In una curva con ripiegamenti, un percorso chiuso, una scansione temporale o un grafico parametrico, la sequenza dei punti può avere significato indipendente dalla loro posizione X. Ordinare automaticamente per X senza averlo richiesto altererebbe quella sequenza.

In GX-TXT l’operatore può mantenere Insertion order oppure scegliere esplicitamente Sort by X o Sort by Y. Il controllo riguarda la lista scientifica dei punti, non un nuovo rilevamento dei pixel.

17. Sort by X: prima la bozza, poi Apply

È stata aperta Configuration → Viewer settings… → Digitizing e selezionata l’opzione Sort by X. Prima di premere Apply, il Workspace conservava ancora la politica precedente.

Figura 20. La sola scelta di Sort by X non modifica la politica salvata finché non si preme Apply.

Solo dopo Apply è apparso lo stato Applied and saved to the selected configuration e la politica persistente è diventata source = x.

Figura 21. Apply conferma l’ordinamento per X e aggiorna le posizioni dei punti nella lista.

Questa differenza fra valori mostrati nel dialogo e impostazioni effettivamente salvate è importante: non basta selezionare una voce nella combobox e chiudere la finestra senza applicarla.

18. Sort by X conserva i dati ma cambia le posizioni nell’elenco

Dopo l’applicazione, i quattro punti della seconda curva risultavano ordinati per X scientifica crescente: approssimativamente 2, 4, 6, 8 s.

Figura 22. Gli identificativi e le coordinate dei punti rimangono invariati; la lista viene ordinata per X crescente.

Gli UUID, i pixel sorgente, l’origine manual e i valori calibrati dei quattro record erano esattamente gli stessi: è cambiata la posizione dei record nella sequenza. Le due curve della configurazione vengono ordinate ciascuna secondo la propria coordinata scientifica.

19. Monotonic in X forza Sort by X

Selezionando Monotonic in X, la voce Point ordering source si è impostata automaticamente a Sort by X, già durante la modifica della bozza.

Figura 23. Monotonic in X e Sort by X sono mantenuti coerenti dai controlli dell’interfaccia.

Il software impedisce così una combinazione contraddittoria tra asse dichiarato monotono e fonte di ordinamento incompatibile. Non è stato generato un nuovo dato né modificata la posizione dei punti.

20. Cambiare l’ordinamento può annullare la monotonicità

Mentre era selezionata la monotonicità X, è stata scelta Sort by Y nella seconda combobox. La GUI ha riportato automaticamente Monotonicity = None.

Figura 24. Cambiando l’ordinamento, la GUI riporta a None una monotonicità incompatibile.

Questo è un comportamento intenzionale del Viewer: una monotonicità dichiarata X non può restare attiva insieme a un ordinamento per Y. La cancellazione della dichiarazione incompatibile non è un errore né un cambiamento dei pixel.

21. Monotonic in Y forza Sort by Y

Selezionando Monotonic in Y, il Viewer ha automaticamente impostato Sort by Y.

Figura 25. La nuova politica di monotonicità su Y viene salvata soltanto dopo Apply.

Dopo Apply, il Workspace ha confermato monotonicity = y e source = y. Questo controllo esprime una politica di ordinamento e vincolo per gli strumenti che la utilizzano; non dimostra di per sé che la funzione sorgente sia matematicamente monotona.

22. Ordinamento Y senza monotonicità X

I quattro punti della seconda curva avevano Y crescente dopo il riordino, ma i loro X scientifici risultavano circa 4, 8, 2, 6 s.

Figura 26. I punti vengono ordinati per Y crescente, anche quando la sequenza X non è monotona.

Questa è una differenza osservabile fra ordinare per la grandezza Y e ordinare per X. L’interfaccia non deve presentare la nuova sequenza come se provenisse da nuovi clic o da uno spostamento dei marker.

23. Undo e Redo della modifica di ordinamento

Con Edit → Undo è stata ripristinata la precedente politica Sort by X, con gli stessi record nella sequenza X crescente. Con Edit → Redo sono tornati Monotonic in Y e la sequenza Y crescente.

L’operazione include il modello di configurazione e l’ordine dei punti, non soltanto il testo della combobox. Tutti gli identificativi scientifici e le coordinate sono rimasti identici.

24. Move riordina il punto secondo la politica attiva

Mentre era attiva Monotonic in Y, uno dei punti di Ordering demonstration è stato trascinato verso una posizione con Y più alta.

Figura 27. Dopo Move il punto conserva l’UUID, ma passa all’ultima posizione in base al nuovo valore Y.

Il punto ha conservato il proprio UUID, ma le coordinate X/Y sono state ricalcolate e il suo record si è spostato all’ultima posizione perché possedeva ora la Y più elevata. La sorgente raster e gli altri tre punti della curva non hanno subito modifiche.

25. Undo/Redo di uno spostamento riporta anche l’ordine

Undo ha ripristinato la posizione e l’ordine precedenti.

Figura 28. Undo dello spostamento ripristina sia la posizione sul raster sia l’ordinamento scientifico.

Redo ha nuovamente applicato lo spostamento e il relativo riordino.

26. Dopo Undo, un nuovo edit elimina il vecchio ramo Redo

È stato annullato lo spostamento di un punto e subito aggiunto un nuovo punto alla curva tramite Add.

Figura 30. Un nuovo inserimento dopo Undo sostituisce il precedente ramo Redo della cronologia.

Il successivo tentativo di Redo non ha più ripristinato il vecchio Move: il nuovo inserimento aveva interrotto il precedente ramo della cronologia.

Figura 31. Il precedente Redo non produce più effetti dopo la creazione del nuovo ramo.

Undo e Redo del nuovo punto, invece, sono rimasti disponibili e hanno conservato il nuovo UUID.

Figura 32. Il nuovo ramo possiede una propria sequenza Undo/Redo, che ripristina esattamente l’ID del punto.

In termini pratici, la cronologia è una sequenza di stati reversibili; una nuova modifica dopo Undo crea una continuazione differente, non conserva due rami concorrenti.

27. Il limite valido di Snap radius è 0–25

Nella scheda Digitizing è stato inserito Snap radius = 26 e premuto Apply. La GUI ha mostrato l’errore:

Snap radius must be between 0 and 25 pixels.

Figura 33. Il raggio di snapping ammesso è compreso tra 0 e 25 pixel sorgente, estremi inclusi.

Il Workspace non viene modificato da un valore non valido. Il raggio può essere riportato a 3 px e lo snapping disattivato tramite le impostazioni.

28. Ritornare a Insertion order non ricostruisce il passato

Dopo che l’elenco era stato ordinato per Y, l’operatore ha reimpostato Monotonicity = None e Point ordering source = Insertion order, salvando con Apply.

Figura 34. Ripristinare Insertion order non ricostruisce la cronologia originaria dopo un precedente ordinamento esplicito.

La politica futura è tornata a insertion, ma i punti non sono stati ripristinati nell’originaria sequenza di clic 8–2–6–4. La lista conteneva ancora l’ordine risultante dall’ordinamento già applicato.

Figura 35. Il ritorno a Insertion order evita nuovi riordinamenti, ma non recupera le vecchie posizioni storiche.

Questo è coerente con l’implementazione: in modalità insertion il software non esegue un nuovo sort, ma non conserva una seconda cronologia storica permanente dei vecchi indici. Per recuperare l’ordine precedente serve un Undo appropriato, finché la cronologia della stessa esecuzione è disponibile.

29. Save, Close, Reopen: dati persistenti, cronologia temporanea

La configurazione è stata salvata con Configuration → Save configuration, chiusa normalmente e riaperta dal catalogo Viewers → Digitalizer nella stessa Session.

Figura 36. La configurazione salvata conserva pixel sorgente, UUID, calibrazione accettata e scelte di ordinamento.
Figura 37. I nove punti scientifici rimangono nel Workspace, mentre lo stack Undo della precedente esecuzione non viene ripristinato.

Sono stati recuperati il Dataset sorgente originale, una calibrazione a quattro angoli accepted, due curve con rispettivamente quattro e cinque punti, tutti gli UUID e i pixel manuali/memorizzati, le coordinate X/Y, Snap to dark disabilitato, Radius 3 e la politica None / Insertion order.

Tentando Undo e Redo nella nuova esecuzione del Viewer, non è stata eseguita alcuna modifica.

Figura 38. Lo stack temporaneo Undo/Redo non è disponibile dopo la normale chiusura e riapertura del Viewer.

La cronologia Undo/Redo non viene salvata come parte dei Dataset o del Workspace canonico: è transiente e appartiene al processo corrente. Non va confusa con la normale persistenza dei punti scientifici.

30. Procedura operativa

Per utilizzare queste funzioni: selezionare una curva, calibrare il raster e impostare Snap to dark e Radius sulla base della risoluzione dell’immagine. Nel pannello Digitizing scegliere Monotonicity e Point ordering source secondo la natura scientifica della curva, premere Apply e leggere la conferma. Usare Undo/Redo prima di chiudere il Viewer per recuperare modifiche reversibili; salvare la configurazione per conservarne i dati, non per conservare lo stack della cronologia.