Step, monotonicità e ordine delle guide

Il tracciamento assistito del Curve Digitalizer di GX-TXT permette di seguire una linea visibile in un’immagine scientifica. Due scelte incidono sul risultato: il passo di campionamento Step (px) e il criterio con cui le guide vengono attraversate. Questa guida mostra i due controlli su una curva sintetica nota, per poter confrontare il risultato visibile con una traiettoria di riferimento.

1. Che cosa significa Step (px)

Step (px) controlla la distanza nominale fra i campioni che l’algoritmo valuta lungo il percorso indicato dalle guide. L’unità è il pixel dell’immagine sorgente originale, indipendente dallo zoom del Canvas e dalle unità fisiche definite dalla calibrazione.

Nella versione descritta il campo ammette valori da 0,5 a 20 pixel, con valore predefinito 2,0. Un passo minore offre più punti candidati e una ricerca più fitta; un passo maggiore ne offre meno e può saltare dettagli stretti. Non va confuso con Smoothness, con lo spessore del tratto e con il numero di punti numerici finali scelto per l’accettazione.

2. Preparare immagine, calibrazione e serie

Per confrontare diversi Step occorrono lo stesso Image Dataset, la stessa calibrazione e la stessa serie di destinazione. Nell’esempio si usa una immagine raster sintetica 1280 × 900 pixel con una linea blu ondulata e un secondo tratto rosa chiaro, spostato rispetto alla prima. Il sistema di assi è X da 0 a 10 s e Y da −20 a 80 mV.

Nella scheda Curves la serie è inizialmente vuota: i risultati dell’assistente sono ancora provvisori e non aggiungono punti scientifici finché l’operatore non usa un comando di accettazione.

Figura 1. La serie di destinazione ha zero punti; i parametri dell’assistente sono indipendenti dalla tabella dei dati.

3. Individuare i controlli del tracciamento

Aprire Curves, selezionare la serie e scorrere fino a Point interaction e Assisted tracing. Scegliere Add guide per indicare i vincoli sul raster. I campi Search corridor (px) e Step (px) agiscono sulla ricerca; il pulsante Propose genera un nuovo candidato, mentre Reject elimina la proposta corrente senza cancellare le guide.

Figura 2. Step e Search corridor sono impostazioni in pixel originali del raster, non unità degli assi scientifici.

4. Collocare le guide sul raster

Nell’esempio cinque clic lungo la linea blu creano G1–G5 in arancione. Le guide determinano quattro intervalli consecutivi. Con None / Insertion order l’ordine degli intervalli è quello dei clic; con un ordinamento scientifico attivo viene seguito l’asse selezionato.

Figura 3. Le cinque guide delimitano quattro intervalli; non rappresentano ancora punti numerici acquisiti.

Le guide non sono punti acquisiti nella serie. È utile aggiungerne una in corrispondenza di cambiamenti di pendenza, curve strette e incroci con elementi grafici non pertinenti.

5. Tenere fisse le condizioni del confronto

Per isolare l’effetto di Step, tutte le prove seguenti mantengono cinque guide identiche, Corridor = 18 px, Smoothness = Off, selezione Trace image = auto senza anteprima elaborata e stessa immagine di partenza. Cambia soltanto Step: 2, 20, 0,5 e 8 px.

Dopo ogni modifica premere nuovamente Propose e controllare il messaggio finale. Il cambiamento del numero scritto in Step, da solo, non ricalcola la linea precedentemente generata.

6. Proposta con Step = 2 px

Con il passo predefinito 2 px, il pannello restituisce 411 punti provvisori distribuiti in quattro segmenti. La linea candidata è disegnata sopra l’immagine originale, distinta dai cinque riferimenti arancioni e dalla curva blu sottostante.

Figura 4. La GUI propone 411 punti provvisori in quattro segmenti con Step di 2 pixel.

Il messaggio cita lo Step effettivamente utilizzato. È questo valore, non semplicemente quello ora presente nel campo, che deve essere associato a una proposta già visibile.

7. Proposta con Step = 20 px

Portando Step a 20 px e facendo una nuova Propose, si ottengono 44 punti, sempre su quattro segmenti.

Figura 5. Il limite superiore di Step produce 44 vertici candidati in quattro segmenti.
Figura 6. L’immagine mostra la geometria realmente calcolata con Step 20, senza interpolare graficamente punti aggiuntivi.

Il percorso è campionato molto più grossolanamente. Questo è il limite superiore consentito dalla GUI, non un’impostazione consigliabile per qualsiasi sorgente: forme locali rapide, picchi stretti e cambi di direzione possono richiedere un passo minore.

8. Proposta con Step = 0,5 px

Al limite inferiore 0,5 px, una nuova Propose genera 1.636 punti su quattro segmenti.

Figura 7. Il limite inferiore di Step produce 1.636 vertici candidati sulla stessa immagine.
Figura 8. L’aumento del numero di campioni non è automaticamente un miglioramento dell’accuratezza.

Il numero elevato descrive soltanto la densità del candidato. Non equivale a 1.636 misurazioni indipendenti e non certifica l’accuratezza della curva.

9. Un valore intermedio: Step = 8 px

Con Step 8 px il risultato contiene 105 punti provvisori in quattro segmenti.

Figura 9. Il confronto sul medesimo raster mostra 105 punti provvisori e quattro segmenti.

Il confronto a parametri fissi permette di decidere quale livello di campionamento rappresenti in modo adeguato la geometria realmente presente, senza confondere la differenza di densità con il cambiamento della calibrazione.

10. Quantità di punti e fedeltà al riferimento

La curva blu sintetica segue una funzione nota nelle coordinate dell’immagine originale:

y_px(x) = 440 + 58 sin[2π(x−200)/720] + 20 sin[2π(x−200)/305]

La differenza verticale fra le coordinate della proposta, lette dal Canvas e riportate ai pixel originali, e la funzione nota produce:

StepVertici candidatiScarto assoluto medioRMSE geometrico
0,5 px1.63614,40 px19,63 px
2 px41113,78 px18,85 px
8 px10512,81 px17,54 px
20 px4416,17 px21,74 px

In questo solo esempio Step 8 produce lo scarto medio più basso, mentre Step 0,5 genera molti più vertici senza ridurre lo scarto. Gli errori sono distanze geometriche da un riferimento sintetico: non sono incertezze metrologiche, probabilità di confidenza né validazioni su misure sperimentali. In generale bisogna sempre ispezionare il percorso proposto.

11. Valori di Step fuori intervallo

Inserendo 0,49 e premendo Propose, il Viewer mostra il messaggio Step must be 0.5..20 original-image pixels. Nessuna nuova proposta viene calcolata con quel valore.

Figura 10. La GUI indica che il valore deve essere compreso fra 0,5 e 20 pixel originali.
Figura 11. La schermata distingue il valore non valido dall’ultima proposta valida ancora sul Canvas.

Lo stesso avviene inserendo 21, oltre il limite superiore.

Figura 12. Anche il superamento del limite superiore blocca una nuova generazione.

Il limite è espresso nei pixel originali e non cambia variando la dimensione della finestra o lo zoom.

12. Distinguere il campo aggiornato dalla proposta già visibile

Se si modifica Step dopo una generazione valida, il precedente candidato può rimanere sul Canvas. Anche dopo il rifiuto di un valore fuori intervallo, la linea può rappresentare l’ultima proposta correttamente completata. Per attribuire un percorso a un certo parametro, leggere il riepilogo Proposal […] Step N source px e ripetere Propose dopo ogni modifica valida.

L’errore di Step segnala il rifiuto della nuova richiesta. Non bisogna trattare una linea rimasta visibile come se fosse stata calcolata con il nuovo valore errato.

13. Rifiutare il candidato senza perdere le guide

Usare Reject per eliminare la proposta corrente senza rimuovere i cinque riferimenti arancioni.

Figura 13. Reject elimina il candidato lasciando l’immagine, la calibrazione e i cinque vincoli G.

Clear guides è un comando differente: elimina i vincoli provvisori e la proposta. Nessuno dei due comandi equivale alla cancellazione di una serie di punti scientifici già acquisiti.

14. Due concetti distinti: monotonicità e ordinamento

Aprendo Configuration → Viewer settings → Digitizing si incontrano due campi distinti: Monotonicity e Point ordering source.

MonotonicityPoint ordering sourceSignificato
NoneInsertion orderPercorso libero; ordine dei clic
NoneSort by XOrdinamento scientifico per X senza dichiarare monotonicità
NoneSort by YOrdinamento scientifico per Y senza dichiarare monotonicità
Monotonic in XSort by XPolitica di guida e punti lungo X
Monotonic in YSort by YPolitica di guida e punti lungo Y

Un semplice ordinamento per X non dimostra che la grandezza Y sia monotona, e una curva con inversioni di direzione richiede particolare attenzione prima di imporre una politica monotona.

15. Guide in ordine di inserimento libero

Con None / Insertion order inseriamo cinque riferimenti in un ordine volutamente non crescente lungo X: prima una guida verso destra, poi una a sinistra, quindi altre posizioni alternate. G1, G2 e le successive seguono i clic e non vengono riordinate automaticamente.

Figura 14. Senza monotonicità e con Insertion order la sequenza segue esattamente l’ordine del tracciamento dell’operatore.
Figura 15. Le posizioni e i numeri G mostrano la differenza fra ordine di inserimento e ordinamento scientifico.

Questa modalità è adatta a contorni, percorsi che tornano indietro e altre geometrie non descrivibili con un solo ordinamento crescente. La responsabilità della sequenza degli intervalli resta all’operatore.

16. Proposta libera con le medesime guide

Con Step 8 px, Corridor 18 px e le cinque posizioni inserite in ordine libero, la GUI restituisce 287 punti su quattro segmenti.

Figura 16. Lo stesso insieme di cinque guide in ordine di inserimento genera 287 vertici provvisori.

Il risultato è diverso da quello con monotonicità X pur usando esattamente gli stessi punti di guida. La differenza nasce dall’ordine di percorrenza, non da uno spostamento del riferimento fisico.

17. Aprire Viewer settings e la scheda Digitizing

Aprire Configuration → Viewer settings… e selezionare Digitizing. La configurazione iniziale presenta Monotonicity = None e Point ordering source = Insertion order.

Figura 17. Monotonicity è None e Point ordering source è Insertion order prima di cambiare la politica.

Le modifiche restano nel dialogo finché non si preme Apply. Occorre leggere il messaggio di conferma prima di chiudere le impostazioni.

18. Attivare Monotonic in X

Selezionando Monotonic in X, il Viewer imposta automaticamente Sort by X.

Figura 18. Il Viewer abbina automaticamente la monotonicità scientifica X al criterio Sort by X.

Premere Apply per salvare la politica nella configurazione corrente. L’ordinamento si riferisce alla coordinata scientifica calibrata, non semplicemente alla colonna orizzontale dello schermo quando la trasformazione dell’immagine non è banale.

19. Le stesse guide ordinate per X

Dopo avere attivato la politica, aggiungiamo di nuovo le cinque guide nello stesso ordine di clic non crescente usato in precedenza. Le etichette G1–G5 vengono questa volta assegnate in ordine di X crescente.

Figura 19. Le stesse posizioni cliccate in disordine sono ora numerate per X crescente.
Figura 20. I numeri G1–G5 mostrano la progressione orizzontale della curva.

La nuova Propose con Step 8 restituisce 105 punti su quattro segmenti.

Figura 21. La topologia ordinata per X restituisce 105 punti provvisori su quattro segmenti.

La politica X è appropriata quando la curva deve essere percorsa da X minore a X maggiore. Non è un criterio universale per contorni chiusi o traiettorie con ritorni orizzontali.

20. Attivare Monotonic in Y

Selezionando Monotonic in Y, il campo dell’ordinamento passa a Sort by Y.

Figura 22. La GUI sincronizza la monotonicità Y con l’ordinamento per ordinata scientifica.

Ripetendo i cinque clic precedenti, la successione delle guide cambia: G1–G5 ora seguono l’ordinata scientifica crescente, non l’ascissa o l’ordine dei clic.

Figura 23. Con Y crescente le etichette G assumono una sequenza diversa dall’ordine X.
Figura 24. I punti sono gli stessi, ma il percorso di attraversamento dipende dalla politica scelta.

Con questa configurazione la proposta contiene 175 vertici su quattro segmenti.

Figura 25. La diversa topologia ha prodotto 175 punti provvisori su quattro segmenti.

La curva blu usata qui oscilla in Y: quindi il vincolo monotono Y non rappresenta fedelmente la sua struttura globale. È un esempio utile per capire che l’impostazione va scelta in funzione della geometria reale del dato, non per ottenere un numero desiderato di punti.

21. Ordinare per X senza dichiarare monotonicità

Mentre è selezionato Monotonic in Y, modificare Point ordering source in Sort by X fa tornare Monotonicity a None.

Figura 26. Modificare Point ordering source disattiva il precedente vincolo Monotonic in Y.

Dopo Apply, aggiungendo le guide in ordine sparso, queste vengono comunque disposte per X.

Figura 27. L’ordinamento per X resta attivo anche senza dichiarare la monotonicità.

La relazione è quindi asimmetrica: dichiarare una monotonicità imposta l’ordinamento coerente; cambiare manualmente ordinamento a un altro asse può rimuovere la dichiarazione monotona.

22. Tornare alla modalità libera

Per riprendere contorni o geometrie non ordinate impostare Monotonicity = None e Point ordering source = Insertion order, poi premere Apply. In questo modo l’operatore torna a stabilire la sequenza mediante i clic.

Figura 28. La configurazione torna al comportamento libero; le guide transitorie sono assenti.

Il comando Clear guides rimuove le guide temporanee; i punti scientifici e l’immagine sorgente non devono essere alterati da questa operazione.

23. Apply, Save e riapertura

Il criterio di monotonicità appartiene alla configurazione attuale, non a un’impostazione globale indifferenziata. Dopo Apply, salvare la configurazione con Configuration → Save configuration. Se si desidera verificare la persistenza, chiudere normalmente il Viewer e riaprirlo dalla Session corrente.

Figura 29. Apply salva le impostazioni nella configurazione scientifica selezionata.
Figura 30. Restano Image Dataset, calibrazione e serie, mentre Step torna al valore 2 e le guide non persistono.

Nel caso mostrato la riapertura conserva Monotonic in X / Sort by X, la calibrazione e la serie, mentre Step ritorna a 2,0 e le guide provvisorie non sono ripristinate.

Figura 31. La politica X e Sort by X sopravvivono alla normale chiusura e riapertura.
Figura 32. Il valore Monotonic in X conferma che la scelta è una proprietà della configurazione salvata.

Questo comportamento distingue i parametri salvati dell’Interactive Document dal pannello transitorio che guida una singola elaborazione assistita.

24. Proposta provvisoria e dato scientifico

La polilinea ciano è un candidato da verificare, non un nuovo Dataset. I valori numerici letti dal Canvas per le prove di questa guida sono serviti a confrontare la geometria proposta, ma non sono stati accettati in una curva né pubblicati.

L’eventuale parametro Assisted trace output points riguarda il numero di punti numerici desiderato in fase di accettazione, ed è distinto dal campionamento Step usato per la ricerca sul raster. Una interpolazione di un candidato rado non recupera dettagli sperimentali che non siano stati riconosciuti nella proposta originaria.

25. Procedura di lavoro consigliata

  1. Verificare immagine, calibrazione e serie destinazione.
  2. Scegliere il criterio di percorso coerente con la geometria: libero, X o Y.
  3. Posizionare almeno due guide, aggiungendone vicino alle regioni ambigue.
  4. Impostare Corridor e Step in pixel originali; iniziare dal valore predefinito se non esistono motivi per cambiarlo.
  5. Premere Propose e controllare numero di punti, segmenti, messaggio di Step e andamento sul raster.
  6. Confrontare altri Step quando occorre; non dedurre la qualità dal solo numero di punti.
  7. Usare Reject per una proposta inadeguata. La correzione puntuale e l’accettazione sono trattate nel capitolo successivo dedicato alla revisione della proposta.

26. Riepilogo e limiti da ricordare

Il parametro Step determina la densità del tracciamento ricercato, entro 0,5–20 px dell’immagine originale. La monotonicità determina come le guide vengono ordinate secondo un asse scientifico, mentre il semplice ordinamento può essere applicato anche senza dichiarare che la curva sia monotona.

Non esiste un valore Step universalmente ottimale: in questo esempio 8 px ha mostrato il minore scarto dalla linea sintetica, ma l’esito dipende da tratto, raster, guida, corridoio e prior. Gli effetti di Smoothness, delle regioni escluse e delle correzioni dei punti proposti saranno illustrati separatamente, senza confonderli con la funzione di Step.