Calibrazione logaritmica, assi misti e direzione Y

Questa guida (V08) documenta tre aspetti del Curve Digitalizer: assi X-log/Y-lineare, assi X-log/Y-log e direzione verticale della calibrazione dell’intera immagine.

1. Tre immagini canoniche e tre configurazioni

Sono state create tre immagini sintetiche riproducibili, importate tramite l’Acquisition Handler GX-TXT come veri Image Dataset con contratto image.raster. Non sono fotografie sperimentali, né screenshot dell’interfaccia.

Configurazione di provaSorgente e obiettivo
V08 Mixed LogX LinearYGrafico X logaritmica, Y lineare
V08 Both Axes LogGrafico X/Y entrambi logaritmici
V08 Pixel Y DirectionRighe pixel per confrontare Upward e Downward

2. Il primo grafico: X logaritmica e Y lineare

Il primo esempio rappresenta Frequency, da 1 a 1000 Hz su scala logaritmica, e Linear response, da 0 a 100 mV su scala lineare. Il quadrilatero con quattro bersagli è deliberatamente leggermente prospettico.

Dopo aver creato la Digitizer Configuration, la sorgente è stata confermata con Preview source image → Use this image. Il punto giallo di verifica corrisponde nominalmente a circa 31,622777 Hz e 45 mV.

Figura 1. Il raster misto viene verificato prima di collegarlo alla nuova Digitizer Configuration.

3. Vincolo: i limiti di un asse log non possono essere zero o negativi

Selezionando X Scale = log e Minimum = 0, il comando Apply axis settings ha rifiutato l’input con:

Invalid axis configuration: Logarithmic axes require positive limits.

Figura 3. La configurazione logaritmica non ammette limiti nulli.

Lo stesso controllo è stato esercitato con Minimum = −1, ancora rifiutato.

Figura 4. Un minimo negativo non può essere memorizzato come asse logaritmico valido.

Gli assi del Workspace precedente sono rimasti invariati. Entrambi i limiti di ogni asse logaritmico devono essere strettamente positivi e differenti. Nell’esempio misto, invece, il limite Y=0 mV è valido, perché Y rimane linear.

4. Impostare e applicare la calibrazione mista

Nel pannello X axis, inserire Label = Frequency, Unit = Hz, Minimum = 1, Maximum = 1000, Scale = log. Nel pannello Y axis, usare Label = Linear response, Unit = mV, Minimum = 0, Maximum = 100, Scale = linear.

Figura 5. Una calibrazione mista ammette zero sull’asse lineare Y ma non sull’asse logaritmico X.

Premere Apply axis settings. Il framework conferma che X e Y hanno scale scientifiche distinte. Questi campi non stabiliscono ancora dove siano gli angoli fisici del grafico nel raster.

5. Quattro angoli della sorgente mista

Premere nell’ordine i pulsanti Set BL, Set BR, Set TL, Set TR, cliccando i bersagli originali dell’area grafica.

Figura 6. Il pulsante Set BL crea un riferimento geometrico reale e incrementa il conteggio degli angoli.
Figura 7. Il quadrilatero non affine viene calibrato con quattro clic senza pubblicare curve numeriche.

Dopo il quarto clic, la GUI ha mostrato Calibration ready, con quattro marker ciano. Il modello ha determinato una omografia proiettiva non affine, valida anche con assi numerici misti.

Figura 8. L’interfaccia mostra condizione dell’omografia, RMS geometrico e quattro marker sui punti sorgente.

Il valore corner RMS ≈ 2,3×10⁻¹⁶ descrive il residuo dei quattro punti utilizzati per determinare la matrice; non misura l’incertezza reale dell’esperimento.

6. Formula X logaritmica, Y lineare

Dopo la proiezione dei pixel in coordinate normalizzate (u,v), GX-TXT applica una trasformazione per ciascun asse.

Per X logaritmica: X = 10^(log10(Xmin) + u × [log10(Xmax) − log10(Xmin)]).

Con Xmin=1 e Xmax=1000: X = 10^(3u) Hz.

Per Y lineare: Y = Ymin + v × (Ymax − Ymin) = 100v mV.

Il punto di controllo sintetico è stato disegnato a (u,v)=(0,5; 0,45), perciò ha coordinate nominali √1000 ≈ 31,622777 Hz e 45 mV. La trasformazione logaritmica non è uno zoom del canvas: modifica la mappatura scientifica delle coordinate.

7. Verifica indipendente del grafico misto

Con Verify calibration… aperto, è stato cliccato il marker giallo nella GUI e inserito Expected X = 31.622776601683793, Expected Y = 45. Il vero evento Tk (366,394) corrispondeva a circa (674,0719; 473,0216) pixel sorgente.

QuantitàExpectedCalculatedΔ physical
Frequency X31,622777 Hz31,31893 Hz−0,3038503 Hz
Linear response Y45 mV45,18386 mV+0,1838589 mV
Figura 9. Il pannello inline distingue residuo logaritmico in decadi per X e residuo percentuale per Y.

Una seconda soluzione numerica della matrice, eseguita sui quattro angoli salvati, ha restituito 31,3189263 Hz e 45,1838589 mV, coerenti con le cifre mostrati nell’interfaccia.

8. Decadi e percentuali sono confronti differenti

Nella colonna Relative / log, il Viewer ha mostrato per X logaritmica:

−0,004193135 decades (×0.9903914)

Per Y lineare:

+0,4085754 %

Figura 10. I residui della stessa verifica usano unità diverse secondo la scala di ciascun asse.

Il confronto logaritmico utilizza log10(Calculated / Expected), mentre un confronto relativo lineare utilizza (Calculated − Expected) / Expected × 100%, quando il riferimento lo permette.

Questi numeri sono residui di un punto verificato, non incertezze statistiche o stime di accuratezza generale.

9. Aprire un Dataset log-log senza ricollegare la prima configurazione

Il secondo esempio utilizza una nuova Digitizer Configuration e un’altra sorgente: v08.loglog_positive. La prima configurazione rimane collegata al proprio Image Dataset.

Figura 11. Una seconda Digitizer Configuration mantiene una sorgente canonica distinta dalla prima.

La figura log-log dichiara Frequency X = 1–1000 Hz e Intensity Y = 1–1000 a.u., entrambe logaritmiche. Il punto giallo centrale rappresenta nominalmente √1000 su ciascun asse.

10. Rifiuto di zero e negatività su Y logaritmica

Con Y Scale = log, è stato provato Y Minimum uguale a 0.

Figura 12. Il vincolo di positività è controllato indipendentemente anche sull’asse Y.

È stato poi provato Y Minimum uguale a −1.

Figura 13. Nessun asse logaritmico con valori non positivi viene salvato nella Session.

Entrambi i tentativi sono stati rifiutati con Logarithmic axes require positive limits.

11. Applicare due assi logaritmici

Compilare X Frequency / Hz, Minimum 1, Maximum 1000, Scale log, e Y Intensity / a.u., Minimum 1, Maximum 1000, Scale log. Applicare tramite Apply axis settings.

Acquisire quindi i quattro angoli con Set BL / BR / TL / TR. Il risultato è un quadrilatero valido con una sola omografia a quattro angoli: i due assi scientifici trasformano indipendentemente le coordinate normalizzate.

Figura 15. La stessa omografia geometrica supporta la conversione logaritmica di entrambe le coordinate.

12. Matematica e verifica del grafico log-log

Con entrambi gli assi compresi fra 1 e 1000 in scala logaritmica:

X = 10^(3u) Hz e Y = 10^(3v) a.u..

Nel punto normalizzato (0,5;0,5), entrambi valgono √1000 ≈ 31,6227766. Il clic reale del controllo giallo è avvenuto sul canvas a (367,379), equivalente a circa (675,9137;445,3957) pixel sorgente.

La GUI ha mostrato:

AsseExpectedCalculatedResiduo logaritmico
X · Frequency31,622777 Hz31,44566 Hz−0,002439231 decadi
Y · Intensity31,622777 a.u.31,85506 a.u.+0,003178412 decadi
Figura 16. Entrambi gli scarti sono resi in decadi e rapporti moltiplicativi.
Figura 17. La trasformazione logaritmica non deve essere interpretata come variazione di zoom.

13. Anche il riferimento Expected logaritmico deve essere positivo

È stato inserito deliberatamente Expected Y = 0 durante la verifica log-log. Il risultato Y già calcolato è rimasto visibile, ma il confronto ha mostrato:

Y1: A logarithmic axis requires a strictly positive physical reference.

La colonna di confronto ha indicato Invalid reference.

Figura 18. La coordinata fisica calcolata rimane visibile, mentre il confronto con un Expected log negativo o nullo è invalido.

Ristabilendo un valore Expected positivo, il confronto torna disponibile. Non vengono rimossi né il Dataset originale né gli angoli di calibrazione.

14. Una terza sorgente per separare la direzione Y dagli assi log

La scheda Calibration include un controllo Y direction con due voci:

  • Upward (Cartesian)
  • Downward (image pixels)

Questo selettore è usato nella procedura A · Full image → Auto-calibrate full image. Non modifica da solo una precedente calibrazione manuale log-log.

Per evitare confusione tra il senso di Y e la sua scala logaritmica è stato creato un terzo Dataset neutro, con righe orizzontali etichettate in pixel sorgente.

Figura 19. Il test della direzione verticale usa un raster separato dai due grafici scientifici.

15. Downward (image pixels): Y cresce verso il basso

Nella terza configurazione è stato selezionato Downward (image pixels) e premuto Auto-calibrate full image.

Per il PNG 1280×900, il CORE ha salvato gli assi X 0–1279 px, Y Minimum 899 px / Maximum 0 px e quattro angoli che coincidono con i confini originali del raster.

Figura 20. Nella modalità Downward, Y calibrata cresce scendendo verso il basso dell’immagine.

La scala rimane linear e l’unità px. Con questa scelta la Y di un pixel originale è direttamente la sua riga: per esempio, il pixel 180 ha Y calibrata 180 e il pixel 700 ha Y calibrata 700.

16. Il passaggio a Upward (Cartesian) richiede conferma

Selezionare Upward (Cartesian) non sostituisce automaticamente la calibrazione già valida. Premendo di nuovo Auto-calibrate full image, il Viewer ha mostrato:

Replace the existing calibration and axis limits with full-image pixel coordinates? Existing digitized points will be recalculated, not deleted.

Figura 21. Il menu Y direction da solo non sostituisce silenziosamente una calibrazione precedente.

17. Upward (Cartesian): stessa geometria, numeri Y invertiti

Dopo la nuova calibrazione, l’asse Y è diventato Minimum 0 px / Maximum 899 px, mantenendo gli stessi quattro angoli pixel e lo stesso SHA-256 della sorgente.

Figura 22. Il modello mantiene i quattro stessi angoli sorgente ma interpreta Y in senso cartesiano.

Il confronto matematico sullo stesso raster è:

Pixel Y originaleDownwardUpward
180180 px719 px
700700 px199 px

Per Upward la trasformazione è Y = (H − 1) − pixel_y, con H=900. La differenza riguarda l’interpretazione delle coordinate, non un capovolgimento dei pixel del PNG.

18. Verifica reale di un pixel in modalità cartesiana

Il pannello Verify calibration… è stato utilizzato anche per la terza configurazione. Il clic originale vicino a (500,180) è diventato, dopo arrotondamento nel canvas, (499,1079;180,1871) pixel sorgente.

Con Expected X = 500 ed Expected Y = 719, il Viewer ha calcolato:

Calculated X = 499,1079 px
Calculated Y = 718,8129 px

Figura 23. I valori calcolati dall’interfaccia concordano con la trasformazione Y = 899 meno pixel_y.

Il piccolo scarto è compatibile con la discretizzazione del clic. La ricostruzione indipendente ha confermato il valore. La direzione Y della full-image calibration resta distinta dall’impostazione Scale = log dei grafici scientifici.

19. Non confondere direzione, scala e geometria

La scala log cambia il rapporto fra coordinate normalizzate e valori scientifici. Y direction determina invece il verso degli assi pixel quando si usa Auto-calibrate full image.

Una nuova full-image calibration reimposta assi in px, linear: non bisogna applicarla a un grafico logaritmico già calibrato pensando che cambi soltanto il verso di Y. Per un grafico manuale, occorre leggere gli estremi fisici effettivi, scegliere il mapping appropriato e verificare punti noti.

Il modello può produrre RMS degli angoli vicini allo zero anche su un grafico scientificamente male interpretato. Verificare sempre la semantica delle etichette dell’immagine e non soltanto la matrice geometrica.

20. Salvataggio e riapertura delle tre configurazioni

Le configurazioni sono state salvate e riaperte attraverso i normali comandi del Viewer, nella medesima Session. Il CORE ha restituito tre Workspace separati, ciascuno collegato all’Image Dataset originale.

Figura 24. La sorgente e il verso Y restano collegati allo stesso Workspace canonico.
Figura 25. La chiusura dell’interfaccia non ha scambiato la prima immagine con gli altri due Dataset.
Figura 26. I quattro angoli e gli assi positivi doppio log sono persistiti nella Session.

21. Procedura operativa essenziale

Per un grafico X-log/Y-linear, impostare Scale = log soltanto su X, usando limiti positivi per X; Y resta lineare anche se comprende zero. Per un grafico log-log, entrambi gli estremi di entrambi gli assi devono essere strettamente positivi.

Dopo Apply axis settings, cliccare Set BL / Set BR / Set TL / Set TR, controllare Calibration ready e verificare almeno un punto noto con Verify calibration…, distinguendo scarti fisici, percentuali e decadi.

Per la direzione verticale dell’intero raster, selezionare Y direction → Upward/Downward e applicare realmente Auto-calibrate full image, verificando gli assi e l’eventuale conferma di sostituzione.