Calibrazione a quattro punti con assi lineari

In questa capitolo (V07) viene costruita e verificata una calibrazione scientifica a quattro punti.

1. Un grafico scientifico lineare come sorgente

Per rendere riproducibile la prova è stato creato un PNG interamente sintetico, 1280 × 900 pixel, con una griglia scientifica quadrilatera leggermente prospettica e due tracce colorate. La figura non è un’osservazione sperimentale e non rappresenta dati numerici già pubblicati.

L’asse orizzontale è Elapsed time, da 0 a 10 s; l’asse verticale è Signal, da −20 a 80 mV. Quattro piccoli bersagli identificano gli angoli fisici del rettangolo scientifico; un quinto bersaglio giallo indica un punto di controllo noto, 5 s, 30 mV.

L’immagine è stata importata come Dataset canonico image.raster in una Session indipendente, utilizzando l’Acquisition Handler pubblico, quindi associata a una Digitizer Configuration tramite il reale dialogo Preview source image → Use this image.

Figura 1. La sorgente scientifica viene verificata e collegata al Workspace prima di acquisire i quattro angoli.

La finestra iniziale mostra l’immagine e i suoi metadati. Le tracce visibili appartengono ancora ai pixel del raster: in V07 non vengono digitalizzate né pubblicate come curve scientifiche.

Figura 2. Le linee e la griglia visibili sono ancora pixel grafici, non curve scientifiche pubblicate.

2. La scheda Calibration e le sue funzioni

Selezionare la scheda Calibration nella parte sinistra del Viewer. In alto sono mostrati X axis e Y axis, ciascuno con Label, Unit, Semantic role, Minimum, Maximum e Scale, seguiti da Apply axis settings.

Più sotto si trovano le opzioni A · Full image e B · Scale bar. Queste appartengono ad altre modalità di calibrazione, non costituiscono la procedura a quattro punti di questo capitolo.

Il pannello Projective calibration and verification contiene invece i pulsanti Set BL, Set BR, Set TL, Set TR e Clear corners, lo stato geometrico della calibrazione e il comando Verify calibration….

Figura 3. Le sezioni Axis settings e Projective calibration sono visibili con Calibration points 0/4.

L’ordine BL/BR/TL/TR indica rispettivamente bottom-left, bottom-right, top-left e top-right del grafico fisico. Non bisogna confonderli con gli angoli dell’intera immagine quando il grafico occupa soltanto una sua porzione.

3. La calibrazione deve essere completa prima della verifica

Una Digitizer Configuration nuova non contiene i quattro angoli scientifici. Se si preme Verify calibration… prima di completare la calibrazione e definire assi validi, la GUI mostra:

Complete the four-corner calibration and valid scientific axes before verifying a known point.

Figura 4. Il messaggio impedisce di verificare una trasformazione non ancora definita.

Il rifiuto è stato osservato direttamente; non ha creato una calibrazione fittizia né modificato il Dataset. È una protezione utile per impedire la verifica di coordinate che non hanno ancora un significato fisico stabilito.

4. Impostare gli assi X/Y lineari e validare i limiti

Inserire Elapsed time nel campo Label dell’asse X, s come Unit, Minimum 0, Maximum 10 e Scale linear. Per Y inserire Signal, mV, Minimum −20, Maximum 80, Scale linear. Le voci Semantic role sono rispettivamente independent e measured.

Prima di accettare la configurazione corretta è stata eseguita una prova negativa: impostando Y Minimum e Maximum entrambi a −20, Apply axis settings ha mostrato Axis minimum and maximum must be different.

Figura 5. Il programma segnala esplicitamente Axis minimum and maximum must be different.

Ristabilito il limite superiore Y a 80, Apply axis settings ha salvato nel Workspace entrambe le definizioni lineari. I quattro angoli erano ancora assenti: i limiti degli assi e la calibrazione geometrica sono oggetti distinti.

Figura 6. Le due definizioni sono state inserite e persistite dal pulsante Apply axis settings.

Questo capitolo considera solo Scale = linear per entrambi gli assi. Gli assi logaritmici o misti, con condizioni di positività e trasformazioni diverse, saranno oggetto della guida V08.

5. I quattro clic: BL, BR, TL e TR

La procedura è guidata da un pulsante per volta. Premere Set BL, poi cliccare il bersaglio in basso a sinistra dell’area grafica. Ripetere con Set BR in basso a destra, Set TL in alto a sinistra e infine Set TR in alto a destra.

Il Viewer mostra i marker azzurri/ciano e un contatore Calibration points: 1/4, poi 2/4, 3/4, fino al completamento.

Figura 7. Il Viewer mostra il primo marker e lo stato Calibration points 1/4.
Figura 8. La GUI presenta tre marker ciano e il contatore Calibration points 3/4.

Lo stato autorevole ha memorizzato le coordinate nei pixel sorgente, che non sono necessariamente numeri interi anche quando il puntatore produce eventi su pixel interi della finestra: la trasformazione inversa del viewport conserva i valori risultanti.

6. Un errore controllato: quattro punti degeneri

Per documentare un errore recuperabile, il quarto punto TR è stato inizialmente posizionato deliberatamente nella stessa posizione di TL. Formalmente erano presenti quattro voci nel documento, ma non quattro angoli geometricamente indipendenti.

Il viewer ha mostrato Calibration invalid: Degenerate calibration points.

Figura 9. La configurazione ha quattro punti registrati ma la matrice non può essere calcolata per la degenerazione.
Figura 10. Il messaggio della GUI distingue quattro record da una vera trasformazione valida.

Questo risultato dimostra che 4/4 punti memorizzati non equivale sempre a una calibrazione valida. Il controllo numerico della matrice riconosce la degenerazione.

Ripetendo Set TR e cliccando il corretto bersaglio in alto a destra, lo stato è diventato Calibration ready e i quattro marker hanno delimitato il quadrilatero originale.

Figura 11. Dopo la correzione di TR la trasformazione proiettiva è calcolabile con assi X/Y lineari.

7. Come nasce la trasformazione proiettiva

Il modello GX-TXT determina un’omografia da quattro coppie di coordinate. Gli angoli del raster sono associati alle coordinate normalizzate:

AngoloX normalizzataY normalizzata
BL00
BR10
TL01
TR11

Una matrice 3×3 trasforma i pixel originali (p_x,p_y) in coordinate normalizzate (u,v), effettuando la divisione per la terza componente omogenea. Gli assi scientifici lineari sono applicati successivamente:

X = Xmin + u × (Xmax − Xmin)

Y = Ymin + v × (Ymax − Ymin)

Questo distingue due concetti: assi numerici lineari e geometria prospettica della figura. Una carta o una stampa inclinata può richiedere una trasformazione proiettiva anche quando le grandezze X/Y sono lineari.

Figura 12. Il RMS dei soli quattro angoli è quasi zero perché quei punti determinano l’omografia.

Il quadrilatero della fixture non è un parallelogramma perfetto. La matrice del CORE ha termini proiettivi non nulli; non è stata sostituita arbitrariamente con una trasformazione affine.

Figura 13. L’area quadrilatera è proiettiva mentre i valori scientifici X/Y rimangono lineari.

8. Condizione della matrice e RMS degli angoli

Nell’esecuzione, la scheda mostra Calibration ready · homography condition 5.62e+03 · corner RMS 2.3e−16.

Questi numeri descrivono la soluzione geometrica calcolata a partire dai quattro punti effettivamente cliccati:

  • homography condition: indicatore numerico di condizionamento della matrice utilizzata;
  • corner RMS: errore di riproiezione dei quattro angoli nelle coordinate normalizzate.

Un RMS quasi zero è atteso quando una omografia attraversa esattamente i quattro punti utilizzati per determinarla. Non dimostra la precisione sperimentale della lettura del grafico, né quantifica l’incertezza nel posizionamento del mouse o nella produzione dell’immagine.

Per verificare se la calibrazione rappresenta correttamente altre posizioni, bisogna usare punti noti indipendenti dagli angoli. È ciò che viene eseguito nel passo successivo.

9. Aprire la verifica scientifica integrata

Con quattro angoli validi, premere Verify calibration…. Il Viewer espande una sezione Calibration verification direttamente nella stessa scheda, senza aprire un’applicazione di verifica separata.

I due blocchi mostrano i nomi e le unità effettive X · Elapsed time [s, linear] e Y · Signal [mV, linear]; ciascuno contiene Expected, Calculated, Δ physical e Relative / log.

Figura 14. La verifica non apre una finestra autonoma: si espande sotto i pulsanti di calibrazione.

Nel test questa procedura usa la calibrazione della Measurement 1 attiva, che risulta ancora in stato draft. La calibrazione geometrica può essere valida senza che la realizzazione sia stata formalmente accettata nel gestore delle misure. Il ciclo di vita dei gruppi e delle misure viene documentato in V09.

10. Il punto noto: 5 s e 30 mV

La fixture contiene un marker giallo di controllo, predisposto geometricamente a 5 s, 30 mV e non utilizzato per costruire l’omografia.

Si è cliccato quel marker sul canvas reale. Il viewer ha risolto il clic nella posizione sorgente approssimativa (675,9137; 445,3957) px, quindi ha mostrato i valori calcolati anche prima di inserire gli Expected.

Figura 15. Il programma può calcolare il riferimento fisico anche quando i campi di confronto sono vuoti.

Inserendo Expected X = 5 s ed Expected Y = 30 mV, l’interfaccia ha restituito:

GrandezzaValore calcolatoRiferimentoΔ fisica
X · Elapsed time4,991869 s5 s−0,008130769 s
Y · Signal30,10595 mV30 mV+0,1059471 mV

Le deviazioni relative visualizzate erano circa −0,1626154% per X e +0,3531569% per Y.

Figura 16. La sezione inline mostra Calulated, Δ physical e percentuali relative sulla misura da pixel realmente cliccati.
Figura 17. Per il punto indipendente si leggono circa −0.00813 s e +0.10595 mV, non un’incertezza statistica.

Si tratta del residuo di un punto di controllo, non di una stima generale della dispersione, dell’incertezza o della qualità di tutte le future curve digitalizzate.

11. Riferimenti attesi non validi e loro azzeramento

Il campo Expected non viene confuso con il valore calcolato. Inserendo intenzionalmente un testo non numerico per X, l’interfaccia ha mostrato Invalid reference, lasciando comunque visibile il risultato geometrico calcolato.

Figura 18. Il dato calcolato resta visibile mentre il riferimento scorretto è riconosciuto come invalido.

Il pulsante Clear expected values ha svuotato i campi di confronto, riportando i residui allo stato di riferimento assente. Non ha cancellato i quattro angoli o modificato l’immagine.

Figura 19. I risultati geometrici rimangono calcolati e i residui non sono più associati a un valore atteso.

Successivamente sono stati reinseriti i riferimenti 5 s e 30 mV: il pannello ha riprodotto gli stessi valori. Close verification ha infine chiuso il pannello per proseguire con le normali operazioni di calibrazione.

12. Correggere un angolo già acquisito

Per modificare uno specifico angolo, premere nuovamente il suo pulsante, per esempio Set BL, e cliccare un’altra posizione del raster. Non è necessario cancellare tutti gli altri tre marker.

Nell’esempio il punto BL è stato temporaneamente spostato, mentre BR, TL, TR e gli intervalli X/Y rimanevano invariati. La GUI ha ricalcolato la matrice e mantenuto lo stato Calibration ready.

Figura 20. Solo il marker BL cambia posizione, con BR TL TR e limiti fisici invariati.

Una modifica di questo tipo cambia la trasformazione di tutti i pixel e può modificare i valori fisici attribuiti a punti di curve già digitalizzate: non è un semplice cambiamento del colore o della posizione del marker.

13. Undo e Redo sulle modifiche ai quattro punti

Il menu Edit → Undo ha riportato l’angolo BL esattamente alla posizione precedente, Edit → Redo ha riapplicato lo spostamento.

Figura 21. L’Undo inverte la correzione geometrica conservando i riferimenti di origine.
Figura 22. Redo ripristina lo stato modificato del Workspace senza toccare l’immagine originale.

Un ulteriore Undo ha ripristinato la calibrazione iniziale. Il confronto ha dimostrato la conservazione dell’intero dizionario dei quattro angoli e degli assi scientifici, con l’immagine canonica invariata.

Questo verifica la cronologia di una modifica di calibrazione nella Session di prova, non le operazioni di Undo/Redo su curve e proposte, che saranno trattate nei capitoli specifici.

14. Clear corners e ripristino

Il pulsante Clear corners rimuove i quattro punti geometrici e fa tornare il contatore a Calibration points: 0/4. Nell’esempio gli assi lineari X/Y restano definiti, ma senza angoli non costituiscono una trasformazione utilizzabile.

Figura 23. I marker ciano spariscono e lo stato torna a Calibration points 0/4.

È stato esercitato immediatamente Edit → Undo: tutti e quattro gli angoli e lo stato Calibration ready sono stati ripristinati.

Figura 24. La cronologia permette di recuperare i quattro punti geometrici cancellati.

Non bisogna confondere Clear corners con Reset physical scale… (V06), né con l’eliminazione della configurazione scientifica: sono operazioni distinte e con implicazioni diverse.

15. Cambiare limiti scientifici senza ricliccare gli angoli

Gli estremi degli assi possono essere modificati tramite Apply axis settings anche quando il quadrilatero è già definito. È stato temporaneamente impostato X Maximum da 10 a 20 s, lasciando X Minimum = 0, Y da −20 a 80 mV e gli angoli esattamente invariati.

Figura 25. La scala dei valori scientifici cambia senza spostare la geometria dell’omografia.

La trasformazione geometrica dei pixel in u,v rimane la stessa, ma la mappatura lineare u→X raddoppia: il punto di controllo centrale, che prima rappresentava circa 5 s, viene ora interpretato come circa 10 s.

È stata poi riapplicata la configurazione iniziale X Maximum = 10, e il CORE ha confermato angoli, assi e Dataset identici alla configurazione di riferimento.

Questo è un cambiamento scientifico, non una forma di zoom del canvas.

16. Visibilità dei marker di calibrazione

Dal menu View è possibile controllare Show calibration corners. Con una calibrazione completa i marker ciano BL · M1, BR · M1, TL · M1 e TR · M1 sono effettivamente disegnati intorno al quadrilatero.

Disattivando la voce, i marker scompaiono dall’immagine:

Figura 26. Show calibration corners disattivato modifica soltanto la presentazione.

Riattivandola, ritornano nella stessa posizione:

Figura 27. Riattivare Show calibration corners non crea nuovi punti di calibrazione.

Nascondere i marker è un’operazione di presentazione; Clear corners è una modifica scientifica.

17. Salvataggio e riapertura nella stessa Session

La configurazione finale, con assi Elapsed time (s) da 0 a 10 e Signal (mV) da −20 a 80, è stata salvata dal reale comando Configuration → Save configuration. Il Viewer è stato chiuso normalmente e riaperto dal riquadro Digitalizer del framework nella stessa Session.

Figura 28. Il CORE e il rendering reale ripristinano i quattro angoli e la sorgente dopo Close/Reopen nella stessa Session.

Sono stati ritrovati i quattro punti, gli assi, il Workspace ID, la sorgente canonica, il gruppo di misura e lo stato Calibration ready. Anche i marker ciano sono stati nuovamente dipinti nella GUI. L’immagine non ha cambiato SHA-256.

Questa verifica dimostra persistenza e ripristino nella stessa Session, non una prova di recupero dopo crash, modifica esterna della sorgente o trasferimento tra Session diverse.

18. Limiti scientifici e condizioni non verificate

La calibrazione proiettiva ricostruisce matematicamente la trasformazione a partire dai quattro angoli individuati. Non può determinare da sola quanto siano accurati i bersagli stampati, le coordinate di riferimento o il puntamento dell’operatore.

Il valore corner RMS ≈ 0 non prova un’incertezza nulla. La misura su un solo punto indipendente è un riscontro puntuale, non una caratterizzazione statistica. In presenza di dati scientifici reali sarebbe opportuno verificare più punti distribuiti nell’area, la qualità del raster e la provenienza dei limiti fisici degli assi.

20. Procedura operativa sintetica

Per calibrare un grafico lineare: importare l’immagine come Image Dataset, creare una Digitizer Configuration, compilare Label / Unit / Minimum / Maximum / Scale=linear di entrambi gli assi e premere Apply axis settings. Poi selezionare uno per volta Set BL, Set BR, Set TL e Set TR, cliccando i veri angoli dell’area grafica. Controllare Calibration ready e non interpretare l’RMS degli angoli come prova di precisione assoluta.

Usare Verify calibration… su un punto fisico noto indipendente dagli angoli, inserire gli Expected, leggere i residui e valutare se sono compatibili con le esigenze dell’esperimento. Correggere gli angoli con i rispettivi pulsanti, usare Undo/Redo quando appropriato, e salvare il Workspace.