dicom anonymizer pro - neologica...medico (radiologo, medico di base, tecnico radiologo, ecc.)....

DICOM Anonymizer Pro

Manuale Utente

DICOM Anonymizer Pro: Manuale Utente [DA-UMIT-2 – Rev C]

2

Indice

1 ABBREVIAZIONI ................................................................................................................................................... 3

2 INTRODUZIONE ..................................................................................................................................................... 4

3 INDICAZIONI PER L’USO .................................................................................................................................... 4

4 PRIMA ESECUZIONE E REGISTRAZIONE ..................................................................................................... 5

5 INTERFACCIA GRAFICA ..................................................................................................................................... 6

5.1 LA TOOLBAR ........................................................................................................................................................ 7

5.2 LA FINESTRA PRINCIPALE .................................................................................................................................... 8

5.3 IL PANNELLO DI NAVIGAZIONE DEL FILE SYSTEM .............................................................................................. 10

5.4 IL PANNELLO DI LOG .......................................................................................................................................... 10

6 IMPOSTAZIONI .................................................................................................................................................... 10

6.1 ANONIMIZZAZIONE DEI DATA ELEMENTS .......................................................................................................... 11

6.1.1 Aggiunta di un Data Element non standard .............................................................................................. 11

6.1.2 Valori personalizzati ................................................................................................................................. 12

6.2 ALTRE IMPOSTAZIONI ........................................................................................................................................ 12

6.2.1 Preferenze anonimizzazione ...................................................................................................................... 12

6.2.2 Preferenze esportazione ............................................................................................................................ 13

6.2.3 Impostazioni personali .............................................................................................................................. 15

7 ANONIMIZZAZIONE DEI FILE DICOM ......................................................................................................... 15

8 ESECUZIONE DA LINEA DI COMANDO ........................................................................................................ 15

8.1 ESEMPI DI UTILIZZO ........................................................................................................................................... 16


3

1 Abbreviazioni

Abbreviazione

Descrizione

AE Application Entity

BMP Bitmap

DICOM Digital Imaging and COmmunications in Medicine

DIMSE DICOM Message Service Element

DLL Dynamic Link Library

DPI Dots Per Inch

GUI Graphical User Interface

ICM Integrated Color Management

ID Identifier

JPEG Joint Picture Experts Group

LAN Local Area Network

PC Personal Computer

PDU Protocol Data Unit

PNG Portable Network Graphics

RAM Random Access Memory

SCP Service Class Provider

SCU Service Class User

SOP Service-Object Pair

TCP Transfer Control Protocol

TIFF Tagged Image File Format

UID Unique Identifier

USB Universal Serial Bus

VR Value Representation


4

2 Introduzione

DICOM Anonymier Pro è un’utility software sviluppata da NeoLogica che permette la rimozione dei

dati sensibili dai file DICOM 3.0. I file DICOM, infatti, oltre alle immagini medicali digitali, spesso

contengono informazioni sensibili, come il nome del paziente, data di nascita, indirizzo, il nome del medico,

e molti altri. In molti casi, come la pubblicazione o la distribuzione dei file DICOM, può essere necessario

“anonimizzare” questi file, ovvero rimuovere completamente tutte le informazioni sensibili contenute

all’interno dei file.

Il software DICOM Anonymier Pro consente di:

scegliere quali informazioni (Data Elements) anonimizzare, inclusi i Private Data Elements,

attraverso una semplice interfaccia grafica;

specificare valori personalizzati, comprensivi di campi dinamici, da utilizzare in sostituzione del

valore originale, agendo quindi da editor di Data Element;

anonimizzare singoli file o intere cartelle contenenti vari file DICOM, e le relative sottocartelle;

i file che si desidera anonimizzare verranno scansionati dal programma e organizzati in una vista

gerarchica (Studio-Serie-Immagine o Paziente-Studio-Serie-Immagine) degli studi rilevati;

scegliere vare politiche da adottare durante il processo di anonimizzazione dei file DICOM e sulla

possibilità di reidentificare parzialmente i file anonimizzati.

DICOM Anonymizer Pro può essere usato in due modalità:

Modalità interattiva: è la modalità di default. Il programma mostrerà in’interfaccia grafica che

permetterà all’utente di scegliere le opzioni e le varie azioni in maniera interattiva. L’interfaccia

grafica di DICOM Anonymizer Pro e le sue funzionalità sono dettagliatamente descritte nei capitoli

5 e 6.

Modalità da linea di comando: in questo caso il programma viene lanciato e gestito interamente da

linea di comando. Questa modalità supporta una serie di comandi testuali che permettono di

configurare le politiche da adottare duarante il processo di anonimizzazione, consentendo una

facile integrazione del software con altre applicazioni o programmi esterni. Questa modalità è

approfondita nel capito 8.

3 Indicazioni per l’uso

DICOM Anonymizer Pro è un modulo software concepito per essere utilizzato esclusivamente come utility di

anonimizzazione di file DICOM. L’utente tipico di DICOM Anonymizer Pro è un professionista del settore

medico (radiologo, medico di base, tecnico radiologo, ecc.).


5

4 Prima esecuzione e registrazione

La prima volta che si esegue DICOM Anonymizer Pro verrà richiesto di registrare il programma,

tramite la finestra di registrazione (v. immagine sotto).

I dati richiesti per completare la registrazione sono il Numero seriale e il Codice di registrazione. Questi dati

si ottengono sul sito loggandosi su http://www.neologica.it/ita/Login.php utilizzando come dati d’accesso lo

username e la password riportati nell’email ricevuta in seguito all’acquisto del software. Una volta effettuato

il login si verrà reindirizzati alla pagina di download del software, in fondo alla quale è presente un campo

in cui inserire il Codice d’attivazione, ovvero il codice generato automaticamente dal programma e mostrato

nella finestra di registrazione. Una volta inserito il Codice di attivazione e cliccato il pulsante, i dati di

registrazione richiesti verranno visualizzati. Per completare la registrazione sarà quindi sufficiente copiare i

dati ottenuti, nei rispettivi campi, cliccare il pulsante Registra e aspettare il messaggio di conferma.

IMPORTANTE: si prega di prestare particolare attenzione nell’inserire il Codice d’attivazione nell’interfaccia

web, accertandosi di inserire esattamente la stessa stringa alfa-numerica generata dall’applicazione,

mantenendo sia le maiuscole che le minuscole. Se il Codice d’attivazione inserito non equivale a quello

fornito dal software, i dati di registrazione generati saranno sbagliati e non consentiranno la corretta

registrazione dell’Anonymizer.

Nel caso non si disponga dei dati di registrazione, o si voglia valutare il software prima di procedere con

l’acquisto, è possibile avviare DICOM Anonymizer Pro in modalità DEMO. In questo caso si potranno

comunque sfruttare tutte le funzionalità del programma, la cui usabilità risulterà però limitata.

http://www.neologica.it/ita/Login.php


6

5 Interfaccia grafica

L’interfaccia grafica (v. immagine sottostante) di DICOM Anonymizer Pro è composta da:

La toolbar principale

La finestra principale

Il pannello di navigazione del File System

Il pannello di log

Navigazione

File System

Finestra principale

Pannello di log

Toolbar


7

5.1 La toolbar

La toolbar di DICOM Anonymizer Pro contiene vari pulsanti di configurazione del programma e altri

per la gestione del processo di anonimizzazione. È inoltre provvista di una progress bar che indica lo stato

di avanzamento dell’operazione in corso, la cui descrizione compare descritta nello spazio libero alla sua

destra.

I pulsanti che la compongono sono descritti nella tabella sottostante:

Preferenze: apre la finestra in cui è possibile specificare le impostazioni di

anonimizzazione e le preferenze generali del programma. Per approfondire si

veda il capitolo 6.

Mostra/Nascondi pannello di navigazione del File Ststem: mostra o nasconde il

pannello laterale in cui è rappresentata la struttura ad albero del File System del

computer. Per approfondire si veda il paragrafo 5.3.

Mostra/Nascondi pannello di log: mostra o nasconde il pannello che mostra i

messaggi ricevuti durante il processo di anonimizzazione. Per approfondire si

veda il paragrafo 5.4.

Anonimizza: avvia il processo di anonimizzazione.

Pausa: mette in pausa il processo di anonimizzazione o, nel caso questo sia già

in pausa, lo riavvia.

NOTA: è attivo solo in seguito all’avvio del processo di anonimizzazione.

Stop: interrompe il processo di anonimizzazione.

NOTA: è attivo solo in seguito all’avvio del processo di anonimizzazione.

Info: visualizza le informazioni generali sulla versione del software DICOM

Anonymier Pro attualmente installato sul sistema.

Esci: esce dal programma.


8

5.2 La finestra principale

La finestra principale è occupata dalla Tabella degli Studi, che mostra la struttura gerarchica degli

studi scansionati. Prima di poter avviare il processo di anonimizzazione, l’Anonymizer deve scansionare i

file DICOM importati, in modo da consentirne la visualizzazione e la gestione.

I file possono essere importati singolarmente, oppure si possono importare direttamente le cartelle

contententi i file DICOM da anonimizzare.

L’importazione dei singoli file DICOM può avvenire in due modi differenti:

Cliccando il pulsante Aggiungi file si aprirà la classica finestra di esplorazione dei file, permettendo

la selezione dei file desiderati.

Trascinando i file selezionati in una finestra esterna direttamente nell’area della tabella.

L’importazione delle cartelle può avvenire in tre modi differenti:

Cliccando il pulsante Aggiungi cartella si aprirà la classica finestra di esplorazione dei file,

permettendo la selezione delle cartelle desiderate.

Trascinando le cartelle selezionate nel Pannello di navigazione del File System direttamente

nell’area della tabella.

Trascinando le cartelle selezionate in una finestra esterna direttamente nell’area della tabella.

In seguito alla scansione di un file o di una cartella, la tabella mostrerà la struttura dei file DICOM analizzati,

dividendoli per Studio o per Paziente, a seconda della vista selezionata.

La Vista studio (impostata di default) visualizzerà gli studi secondo la gerarchia Studio – Serie – Immagine,

mentre la Vista paziente visualizzerà gli studi secondo la gerarchia Paziente – Studio – Serie – Immagine. I

pulsanti Vista paziente e Vista studio permettono di modificare la vista della tabella in tempo reale.

La Tabella degli Studi fornisce un alto grado di personalizzazione. Ogni colonna è infatti ridimensionabile

secondo le proprie esigenze; inoltre è possiblie cambiarne l’ordine smplicemente trascinandole nella

posizione desiderata. Cliccando su una colonna, gli studi verranno ordinati in maniera decresente, in base

al contenuto della colonna cliccata; cliccando nuovamente l’ordine viene invertito. È possibile scegliere più

criteri di ordinamento (es. per nome e per Study UID) cliccando sulle colonne desiderate mantenendo

premuto il tast CTRL.


9

Sulla destra della tabella sono presenti cinque pulsanti, la cui funzione è descritta nella tabella sottostante:

Seleziona (attiva la checkbox) tutti gli studi presenti nella tabella.

Deseleziona (disattiva la checkbox) tutti gli studi presenti nella tabella.

Rimuove dalla tabella tutti gli studi selezionati.

Nota: questa operazione agisce su entrambe le viste della tabella.

Rimuove tutti gli studi presenti in tabella.

Nota: questa operazione agisce su entrambe le viste della tabella.

Apre una finestra (v. Immagine sotto) in cui sono elencati tutti i path scansionati.

Il pulsante Apri cartella aprirà il path selezionato, mentre il pulsante Riscansiona

path avvierà una nuova scansione del path selezionato.

Avvia la re-identificazione dello studio evidenziato. Se i dati originali sono

disponibili, verranno mostrati in una finestra pop-up.

Nota: l’Anonymzer proverà a re-identificare lo studio evidenziato, ovvero lo studio

della riga selezionata, riconoscibile dallo sfondo blu. In questo caso la selezione

degli studi tramite la checkbox non viene considerata.


10

5.3 Il pannello di navigazione del File System

Questo pannello permette di esplorare tutte le cartelle del File System. Trascinando le cartelle

selezionate all’interno della Tabella degli studi, si avvierà automaticametne la scansione. La visualizzazione

di questo pannello è controllata dall’apposito pulsante della toolbar, descritto nel paragrafo 0.

Nota: questo pannello mostra solo le cartelle, i file non sono visualizzati.

5.4 Il pannello di log

Questo pannello riporta in tempo reale i messaggi creati automaticamente dall’applicazione

durante il processo di anonimizzazione. Pre ogni file anonimizzato verranno forniti i dettaggli di ogni Data

Element midificato. La visualizzazione di questo pannello è controllata dall’apposito pulsante della toolbar,

descritto nel paragrafo 0.

6 Impostazioni

Cliccando sul pulsante presente nella toolbar si aprirà la finestra delle impostazioni

dell’Anonymizer. Le impostazioni comprendono le preferenze di anonimizzazione dei Data Elements e i

settaggi globali del programma.


11

6.1 Anonimizzazione dei Data Elements

Nella schermata Data Elements è possibile configurare le impostazioni che verranno applicate

durante il processo di anonimizzazione scegliendo quali Data Element anonimizzare. Per semplificare la

selezione, i Data Element standard sono stati suddivisi in nove categorie distinte:

Patient

Visit

Study

Procedure Step

Series

Image

Results

Interpretation

Equipment

Per ogni Data Element è possibile:

scegliere se anonimizzarlo o meno, utilizzando la checkbox vicino al nome del Data Element

impostare un valore personalizzato, procedimento descritto nel paragfrafo 6.1.2.

Nella schermata dei Data Elements sono presenti 3 pulsanti che permetto di selezionare e deselezionare i

gli elementi e di rimuovere i valori personalizzati. Se la checkbox Applica a tutti i pannelli non è attiva, i

pulsanti agiranno solo sui Data Element della categoria visualizzata; nel caso in cui la checkbox sia

selezionata, invece, le azioni dei pulsanti si estenderanno a tutti i Data Elements standard.

6.1.1 Aggiunta di un Data Element non standard

Cliccando sul pulsante Altri Data Element verrà visualizzata una schermata che permetterà di

specificare ulteriori Data Element da anonimizzare, in aggiunta ai Data Element selezionati nella lista

standard. Cliccando il pulsante Aggiungi si aprirà questa schermata:


12

Per inserire un nuovo Data Element è necessario specificare il Group Number e l’Element Number relativi.

Selezionando l’opzione Anonimizza il valore di questo Data Element, in fase di anonimizzazione il valore

verrà anonimizzato in maniera automatica, mentre selezionando l’opzione Imposta un valore personalizzato

per questo Data Element si potrà definire un valore personalizzato, comprensivo di campi dinamici (v.

prossimo paragrafo).

6.1.2 Valori personalizzati

Per tutti i Data Elements che si sceglie di anonimizzare (sia quelli standard che quelli aggiunti) è

possibile specificare un valore personalizzato. Questo valore andrà a sostituire il valore originale di tutti i file

DICOM che si vuole anonimizzare.

Il valore personalizzato del Data Element può includere anche campi dinamici, ovvero dei tag che verranno

automaticamente valorizzati dall’Anonymizer durante il processo di anonimizzazione.

6.2 Altre impostazioni

Aprendo il pannello Altre Impostazioni si accederà alle opzioni globali dell’Anonymizer, divise in

Preferenze anonimizzazione, Preferenze esportazione e Impostazioni personali.

6.2.1 Preferenze anonimizzazione

La schermata Preferenze anonimizzazione (v. figura sottostante) permette di settare alcune

impostazioni globali da adottare durante il processo di anonimizzazione.


13

in questa schermata si potrà controllare:

l’anonimizzazione di tutti i Data Elements privati presenti nei file DICOM esportati;

la generazione automatica di nuovi ID univoci per i file DICOM anonimizzati (impostazione

raccomandata);

il salvataggio dei dati utili per la re-identificazione degli studi. Se questa opzione è attiva,

l’Anonymizer provvederà a salvare in un database interno i dati principali per ogni studio

anonimizzato (lo Study UID, data e ora dello studio, id, nome e data di nascita del paziente, la

modalità e il nome dell’istituto), rendendoli disponibili per un’eventuale re-identificazione futura.

Cliccando il pulsante Elimina tutti i dati, verranno eliminate tutte le informazioni per la re-

identificazione.

l’utilizzo di contatori numerici per i campi indice paziente, indice studio, indice file e sequenza

globale, potendo scegliere se utilizzare un contatore globale (mantenuto anche in seguito al riavvio

del programma) o se specificare un indice di partenza da utilizzare all’avvio di ogni

anonimizzazione.

6.2.2 Preferenze esportazione

La schermata Preferenze esportazione (v. figura sottostante) permette di settare le politiche da

adottare durante il processo di anonimizzazione.


14

Le politiche di esportazione dei file anonimizzati sono:

Crea un nuofo file anonimizzato con l’estensione ‘.anonym’: per ogni file DICOM da anonimizzare

l’Anonymizer creerà un nuovo file anonimizzato. Questo file verrà messo nella stessa cartella e avrà

lo stesso nome del file originale, ad eccezzione dell’estensione, che sarà .anonym.

Sovrascrivi i file originali con i file anonimizzati: ogni file DICOM da anonimizzare verrà sovrascritto

dal file anonimizzato. IMPORTANTE: tutti i file originali andranno persi.

Specificare una cartella in cui salvare i file: prima di iniziare il processo di anonimizzazione

l’Anonymizer chiederà all’utente la cartella in cui i file DICOM anonimizzati verranno esportati. Così

facendo i file originali non verranno modificati, mentre i file anonimizzati saranno creati nella cartella

specificata, mantenendo i nomi dei file originali. Eventuali sottocartelle verranno correttamente

ricreate, facendo in modo che il path relativo dei file anonimizzati rispetto alla cartella principale

(ovvero quella selezionata al momento dell’esportazione), sia lo stesso path relativo dei file DICOM

originali rispetto alla cartella scansionata.

Salvare i file scansionati nella seguente cartella: comportamento analogo a quanto descritto nel

punto precedente, con l’unica differenza che la cartella in cui salvare i file DICOM anonimizzati non

viene chiesta all’inizio del processo di anonimizzazione, ma è quella indicata nell’ area apposita.

In questa schermata si può, inoltre, gestire il file di log, ovvero un file di testo contenente i dettagli di tutte le

anonimizzazioni effettuate. Le operazioni possibili sono:

Abilitare o meno la scrittura del file;

Impostare la cartella in cui salvare il file di log;

Cancellare il contenuto del file

Archiviare il file di log, ovvero creare una copia del file di log (nominata con la data corrente),

resettandone il contenuto.


15

6.2.3 Impostazioni personali

Questa schermata consente di personalizzare il proprio Anonymizer, settando le impostazioni

grafiche di default.

IMPORTANTE: tutte le modifiche applicate in questa schermata avranno effetto solo in seguito al riavvio del

programma.

7 Anonimizzazione dei file DICOM

Il processo di anonimizzazione viene avviato cliccando il pulsante della toolbar.

Una volta avviato il processo, tutti gli studi selezionati (checkbox della colonna ‘Selezionato’ attivo) verranno

anonimizzati ed esportati secondo le preferenze impostate. La percentuale di completamento del processo

verrà riportata sulla toolbar principale.

8 Esecuzione da linea di comando

DICOM Anonymizer Pro può essere eseguito anche in modalità linea di comando. Per utilizzare

questa modalità è necessario eseguire il file DICOMAnonymizerProCmdLine.exe, al quale andranno passati

alcuni parametri che ne regoleranno l’esecuzione.

Il comando per lanciare il DICOM Anonymizer Pro è il seguente:

[Path cartella d’installazione]\DICOMAnonymizerProCmdLine

-inputPaths “[path di input]”

[outputMode] [outputRootDir]

-prefFile [path del file XML]

-appDataFolderPath [path della nuova app folder]

in cui i parametri specificati hanno il seguente significato:

-inputPaths: questo parametro precede la lista di tutti i pathname, sia di file che di cartelle, che si

desidera anonimizzare. Questo parametro è obbligatorio.

[path di input]: questo parametro dovrà essere sostituito con la lista dei vari pathname da

anonimizzare. I pathname dovranno separati da punto e virgola (;) e contenuti tra virgolette (“).

Questo parametro è obbligatorio.

[outputMode]: questo parametro dovrà essere sostiuito da uno dei seguenti comandi:


16

o –outAnonSuffix: per ogni file DICOM da anonimizzare l’Anonymizer creerà un nuovo file

anonimizzato. Questo file verrà messo nella stessa cartella e avrà lo stesso nome del file

originale, ad eccezzione dell’estensione, che sarà .anonym.

o –outOverwriteOrig: ogni file DICOM da anonimizzare verrà sovrascritto dal file anonimizzato.

IMPORTANTE: tutti i file originali andranno persi.

o –outRootDir: i file originali non verranno modificati, mentre i file anonimizzati saranno creati

in una nuova cartella, mantenendo i nomi dei file originali. Eventuali sottocartelle verranno

correttamente ricreate, facendo in modo che il path relativo dei file anonimizzati rispetto alla

cartella principale (ovvero quella selezionata al momento dell’esportazione), sia lo stesso

path relativo dei file DICOM originali rispetto alla cartella scansionata.

Questo parametro è obbligatorio.

[outputRootDir]: questo parametro dovrà essere sostituito con il path della cartella in cui si desidera

salvare i file anonimizzati.

Nota: Questo parametro è necessario solo se la modalità l’output mode è stato settato su -

outRootDir.

-prefFile: questo parametro permette di specificare quale file XML utilizzare durante

l’anonimizzazione da linea di comando. Questo parametro è facoltativo.

[path del file XML]: questo parametro dovrà contenere il path del file XML contenente le preferenze

di anonimizzazione.

-appDataFolderPath: questo parametro permette di specificare quale cartella utilizzare come

directory principale durante l’anonimizzazione da linea di comando. Questo parametro è facoltativo.

[path della nuova app folder]: questo parametro dovrà contenere il path della app folder

temporanea.

L’ordine dei parametri non è importante.

8.1 Esempi di utilizzo

In questo paragrafo vengono forniti alcuni esempi su come utilizzare da linea di comando DICOM

Anonymizer Pro.

Nota: la stringa [Path cartella d’installazione] dovrà essere sostituita con il path relativo alla

cartella in cui è installato DICOM Anonymizer Pro. Su un sistema windows7 a 64 bit, ad esempio, la stringa

andrà sostituita con “C:/Program Files/NeoLogica/DICOMAnonymizerPro”.


17

Esempio 1:

cd [Path cartella d’installazione]/DICOMAnonymizerProCmdLine

–inputPaths "C:\Dir_1\InputDICOMFiles\file_1.dcm:C:\Dir_2\InputDICOMFiles"

-outAnonSuffix

In questo esempio l’Anonymizer procederà con l’anonimizzazione del file file_1.dcm contenuto nella

directory C:\Dir_1\InputDICOMFiles e con l’anonimizzazione di tutta la directory C:\Dir_2\InputDICOMFiles.

Una volta completato il processo, all’interno della cartella C:\Dir_1\InputDICOMFiles verrà creato il file

DICOM anonimizzato file_1.anonym; mentre per ogni file DICOM contenuto nella cartella

C:\Dir_2\InputDICOMFiles verrà creato un file DICOM anonimizzato, con estensione .anonym.

Esempio 2:


–inputPaths "C:\Dir_1\InputDICOMFiles\file_1.dcm;C:\Dir_2\InputDICOMFiles"

-outRootDir “C:\Anonymized”

In questo esempio l’Anonymizer procederà con l’anonimizzazione del file file_1.dcm contenuto nella

directory C:\Dir_1\InputDICOMFiles e con l’anonimizzazione di tutta la directory C:\Dir_2\InputDICOMFiles.

Una volta completato il processo, i file anonimizzati saranno esportati all’interno della cartella

C:\Anonymized. Più precisamente, la cartella di destinazione conterrà due sottocartelle diverse: la prima,

chiamata C_Dir_1_InputDICOMFiles, conterrà il file DICOM anonimizzato file_1.dcm; la seconda, chiamata

C_Dir_2_InputDICOMFiles, conterrà tutti i file DICOM anonimizzati partendo dai file presenti nella directory

originale, mantenendo invariata l’eventuale organizzazione in sottocartelle.

Esempio 3:


–inputPaths "C:\Dir_2\InputDICOMFiles"

-outOverwriteOrig –prefFile “C:\Anon\MyPref.xml”

In questo esemprio l’Anonymizer procederà con l’anonimizzazione di tutti i file DICOM contenuti nella

cartella C.\Dir_2\InputDICOMFiles, che verranno sovrascritti da quelli anonimizzati. Le impostazioni di

anonimizzazione utilizzate saranno quelle specificate nel file XML C:\Anon\MyPref.xml.

dicom anonymizer pro - neologica...medico (radiologo, medico di base, tecnico radiologo, ecc.)....

Documents