Digitizer Configurations: creare, salvare e gestire il lavoro

Capitolo V02 · guida illustrata

La gestione delle configurazioni scientifiche del Curve Digitalizer, dal menu Configuration alla persistenza nel Workspace nativo GX-TXT.

1. A che cosa serve una Digitizer Configuration

Una Digitizer Configuration è lo stato di lavoro scientifico in cui Curve Digitalizer conserva la sorgente immagine, la calibrazione, le curve e i punti digitalizzati, le impostazioni di visualizzazione, le note e i parametri di pubblicazione. Non è un file immagine separato e non coincide con un Dataset scientifico già pubblicato.

La configurazione è visibile nel selettore Configuration nella parte superiore del Viewer. Ogni oggetto ha un nome leggibile e un’identità stabile. Viene chiamata Interactive Document; il suo salvataggio viene effettivamente gestito dal Workspace nativo del Framework, attraverso le API pubbliche sessionWorkspaceCreate, sessionWorkspaceUpdate, sessionWorkspaceRename e sessionWorkspaceDelete. Il Viewer non deve costruire né mantenere un archivio alternativo.

2. Prerequisiti, menu e significato dei comandi

Per riprodurre le operazioni occorre aver aperto una Session GX-TXT e aver avviato Viewers → Digitalizer. Per associare un’immagine occorre inoltre un Image Dataset canonico compatibile. L’esempio usa un PNG sintetico 1280 × 900, registrato tramite acq.image_binary con contract image.raster.

Nel menu Configuration sono presenti i comandi seguenti:

Comando effettivoEffetto previsto
New configuration...Richiede un nome e crea un nuovo Workspace di digitalizzazione.
Rename configuration...Cambia il nome del Workspace selezionato.
Save configurationScrive nello stato persistente le modifiche correnti.
Duplicate configurationCrea una copia indipendente dello stato salvato o accettato.
Delete configuration...Chiede conferma per eliminare una configurazione della Session.
Viewer settings...Apre preferenze del Viewer (descritte in un altro capitolo).
GX-TXT module configuration...Accede alla configurazione del modulo, distinta dal Workspace corrente.

La differenza fra Dataset e Configuration è essenziale: un Dataset può essere riutilizzato da più configurazioni, ciascuna con propri identificativi e misure. Se manca una configurazione, il selettore Image Dataset non crea automaticamente un Workspace.

3. Creare e associare la prima configurazione

Aprire Configuration → New configuration…. Compare il dialogo Configuration name:, con campo di testo e pulsanti OK e Cancel. Inserire un nome significativo, per esempio V02 Calibration A.

Premere OK. La voce compare immediatamente nel selettore Configuration, ma Image Dataset non è ancora associato. Selezionare dal campo Image Dataset una sorgente compatibile, verificare il dialogo Preview source image e scegliere Use this image soltanto se la figura è corretta.

Il Workspace conserva quindi l’identità della sorgente e il suo SHA-256. L’associazione fra una configurazione e la sorgente va considerata un’operazione esplicita, non un effetto implicito del comando New.

Figura 1. Il comando Configuration → New configuration… richiede un nome prima di creare il Workspace.

Figura 2. La prima configurazione è collegata al Dataset immagine: la sorgente viene visualizzata, non è stata digitalizzata una curva.

4. Save configuration e persistenza delle note

La scheda Notes contiene un editor di testo UTF-8 collegato alla configurazione. E’ stata inserita una breve annotazione in inglese con il simbolo µm.

Il comando Configuration → Save configuration ha registrato la nota nel Workspace della Session. Si distinguono dunque due situazioni:

  • il testo esiste nel campo della GUI ma è ancora una modifica in sospeso
  • il testo è presente anche nel Workspace del CORE ed è perciò persistente

Salvataggio e pubblicazione di un Dataset sono attività diverse: Save configuration non pubblica automaticamente curve.

Figura 3. Il comando Save configuration salva i metadati della configurazione nel Workspace della Session.

5. Modifiche non salvate: Yes, No e Cancel

Prima di azioni che cambiano il contesto, il Viewer confronta il lavoro corrente con l’ultima versione salvata. Nel test, con una nota modificata e non salvata, Rename configuration… apre il messaggio Save changes before Rename configuration?.

Il dialogo presenta tre scelte:

  • Yes: accettare il salvataggio prima di continuare.
  • No: proseguire scartando le modifiche in sospeso.
  • Cancel: annullare l’azione richiesta, lasciando la modifica in lavorazione.

Premendo Cancel: il nome non cambia e la nota resta ancora visibile ma non presente nello stato persistente. Premendo Save configuration la nota entra nel Workspace.

Non si deve interpretare la presenza di testo nella GUI come conferma di un salvataggio riuscito.

Figura 4. Una modifica di Notes non salvata provoca il controllo Save / Discard / Cancel prima di Rename.

6. Rename configuration: il nome cambia, l’identità no

Selezionare la configurazione e scegliere Configuration → Rename configuration…. Il dialogo Configuration name: propone il nome corrente. Sostituirlo con un’etichetta più precisa e premere OK. Nel test V02 Calibration A è stata rinominata V02 Calibration A renamed.

L‘identificativo del documento e quello della configurazione non cambiano. Restano invariati anche l’Image Dataset sorgente, lo SHA-256, le note e il gruppo di misure. Viene invece stato aggiornato il nome del Workspace e quello nella configurazione.

Il framework conserva una revisione del record. Nell’esempio utilizzato per la guida la revisione è passata da 4 a 6, includendo rinomina e aggiornamento del payload. La modifica è persistente.

Figura 5. La rinomina apre lo stesso dialogo e propone il nome corrente come valore iniziale.

7. Duplicate configuration: una copia indipendente

Con una configurazione selezionata, scegliere Configuration → Duplicate configuration. Il Viewer genera una seconda voce con il suffisso copy e la seleziona. La copia iniziale riprende sorgente, note salvate e contenuto utile; tuttavia non è lo stesso Workspace.

ProprietàOriginale e copia
Workspace IDDiverso
Configuration IDDiverso
Calibration group IDDiverso
ID della misura di calibrazione inizialeDiverso
Source Dataset IDUguale
SHA-256 del rasterUguale
Note precedentemente salvateUguali

Se prima della duplicazione è stata inserita una nota provvisoria diversa e non salvata compare il dialogo Save changes before Duplicate configuration? scegliendo No la nuova copia eredita soltanto le note già salvate, non il testo provvisorio.

La duplicazione azzera inoltre l’identificativo di pubblicazione nella nuova configurazione. I dettagli sulla creazione e accettazione di nuove misure di calibrazione verranno affrontati in capitoli specifici.

Figura 6. Anche Duplicate configuration gestisce le modifiche in sospeso: qui No ha escluso una nota non salvata.
Figura 7. La configurazione duplicata compare con suffisso copy e si collega allo stesso Image Dataset.

8. Passare fra più configurazioni sulla stessa immagine

Il selettore Configuration permette di alternare i Workspace presenti nella Session.

Entrambi i Workspace mostrano lo stesso Dataset immagine, ma il framework mantiene due identità indipendenti, con due gruppi di calibrazione distinti. Le note salvate vengono conservate. Questo è il modello corretto per estrarre, ad esempio, curve differenti da una stessa immagine scientifica mantenendo separati i rispettivi contesti di lavoro.

Cambiare configurazione non equivale a spostare, rinominare o duplicare il Dataset sorgente. Una configurazione già associata a un raster non deve essere ricollegata silenziosamente a pixel differenti; il controllo di protezione è stabilito dal sorgente, mentre i casi di sorgente modificata sono riservati ai capitoli V04 e V27.

9. Delete configuration: controllo e risultato

Selezionare la configurazione da eliminare e aprire Configuration → Delete configuration…. Si presenta una finestra di conferma con Yes e No. L’azione rimuove lo stato persistente della configurazione nella Session ma i Dataset già pubblicati non sono eliminati.

Figura 8. La cancellazione richiede una conferma esplicita e dichiara che riguarda lo stato persistente della configurazione.
Figura 9. Con Yes è stata cancellata soltanto la copia; il Dataset sorgente e la prima configurazione restano disponibili.

10. Errori, limiti e casi da distinguere

Nessuna configurazione selezionata. L’interfaccia si apre anche senza configurazioni e lascia vuoti i selettori. Il comando New ne crea una nuova; senza oggetto corrente il codice non esegue le azioni che richiedono current_doc_id.

Modifiche non salvate. Prima di rinominare, duplicare o cambiare Workspace può comparire il dialogo Save / Discard / Cancel.

Duplicazione. Non usare la copia come sinonimo di identità condivisa: Source Dataset e note salvate possono essere uguali, ma Workspace, Configuration e gruppo di calibrazione sono nuovi.

Cancellazione. avviene la rimozione dello stato del Workspace. il Dataset sorgente; i Dataset numerici già pubblicati non vengono modificati.

Un impiego prudente della gestione configurazioni segue questa sequenza: New configuration… → Image Dataset → Use this image → lavoro scientifico → Save configuration. Quando servono copie di lavoro indipendenti, usare Duplicate configuration; per correggere il nome usare Rename configuration…. Prima di cancellare, selezionare la voce corretta e leggere il messaggio di conferma.