dcmdump - Online nel cloud

PROGRAMMA:

NOME

dcmdump - Scarica file DICOM e set di dati

SINOSSI

dcmdump [opzioni] dcmfile-in...

DESCRIZIONE

. dcmdump l'utilità scarica il contenuto di un file DICOM (formato file o set di dati non elaborati) in
stdout in forma testuale. Gli attributi con campi di valori molto grandi (ad es. dati pixel) possono essere
descritto come '(non caricato)'. I campi dei valori stringa saranno delimitati da parentesi quadre
([]). Gli UID conosciuti verranno visualizzati con i loro nomi preceduti da un segno di uguale (es
'=MRImageStorage') a meno che questa mappatura non venga esplicitamente disattivata. Valore vuoto
i campi sono descritti come '(nessun valore disponibile)'.

If dcmdump legge un set di dati non elaborati (dati DICOM senza un meta-header in formato file) lo farà
tentare di indovinare la sintassi del trasferimento esaminando i primi byte del file. è
non sempre è possibile indovinare correttamente la sintassi di trasferimento ed è meglio convertire a
set di dati in un formato di file quando possibile (usando il dcmconv utilità). È altresì
possibile utilizzare il -f e -t[ieb] opzioni per forzare dcmdump leggere un set di dati con a
particolare sintassi di trasferimento.

PARAMETRI

dcmfile-in File di input DICOM o directory da scaricare

VERSIONI

generale Opzioni
-h --aiuto
stampa questo testo di aiuto ed esci

--versione
stampa le informazioni sulla versione ed esci

--argomenti
stampa gli argomenti della riga di comando espansi

-q --silenzioso
modalità silenziosa, non stampa avvisi ed errori

-v --verboso
modalità dettagliata, stampa dei dettagli di elaborazione

-d --debug
modalità di debug, stampa informazioni di debug

-ll --log-level [l]evel: costante di stringa
(fatale, errore, avviso, informazioni, debug, traccia)
usa il livello l per il logger

-lc --log-config [f]nomeile: stringa
usa il file di configurazione f per il logger

ingresso Opzioni
formato del file di input:

+f --file di lettura
leggi il formato del file o il set di dati (predefinito)

+fo --sola-lettura-file
leggi solo il formato file

-f --leggi-dataset
leggere il set di dati senza meta informazioni sul file

sintassi di trasferimento in ingresso:

-t= --read-xfer-auto
usa il riconoscimento TS (predefinito)

-td --read-xfer-detect
ignora TS specificato nella meta intestazione del file

-te --read-xfer-piccolo
leggi con VR little endian TS esplicito

-tb --read-xfer-big
leggere con TS big endian VR esplicito

-ti --read-xfer-implicito
leggere con VR implicita little endian TS

file di input:

+sd --scansione-directory
scansiona le directory per i file di input (dcmfile-in)

+sp --scan-pattern [p]attern: stringa (solo con --scan-directory)
modello per la corrispondenza dei nomi dei file (caratteri jolly)

# forse non disponibile su tutti i sistemi

-r --nessuna ricorrenza
non ricorrere all'interno delle directory (impostazione predefinita)

+r --ricorrenza
ricorsivo all'interno di directory specificate

valori del tag lungo:

+M --carica-tutto
carica valori di tag molto lunghi (impostazione predefinita)

-M --carico-corto
non caricare valori molto lunghi (es. dati pixel)

+R --max-read-length [k]bytes: intero (4..4194302, default: 4)
imposta la soglia per i valori lunghi a k ​​kbyte

analisi delle meta informazioni del file:

+ml --use-meta-lunghezza
usa la lunghezza del gruppo di meta informazioni sul file (impostazione predefinita)

-ml --ignore-meta-lunghezza
ignora la lunghezza del gruppo di meta informazioni sul file

analisi di attributi di lunghezza dispari:

+ao --accetta-lunghezza-dispari
accetta attributi di lunghezza dispari (predefinito)

+ae --assume-uguale-lunghezza
supponiamo che la lunghezza reale sia maggiore di un byte

gestione della realtà virtuale esplicita:

+ev --use-explicit-vr
usa la realtà virtuale esplicita dal set di dati (impostazione predefinita)

-ev --ignore-explicit-vr
ignora la realtà virtuale esplicita (preferisci il dizionario dei dati)

gestione di realtà virtuale non standard:

+vr --tratta-come-sconosciuto
considera la realtà virtuale non standard come sconosciuta (impostazione predefinita)

-vr --assume-implicito
prova a leggere con implicito VR little endian TS

gestione di elementi UN di lunghezza indefinita:

+ui --enable-cp246
leggi undefined len UN come VR implicito (predefinito)

-ui --disable-cp246
leggi undefined len UN come VR esplicito

gestione di elementi UN di lunghezza definita:

-uc --retain-un
conserva gli elementi come UN (predefinito)

+uc --convert-un
converti in realtà virtuale se noto

gestione di elementi privati ​​di lunghezza massima (VR implicito):

-sq --maxlength-dict
leggi come definito nel dizionario (predefinito)

+sq --maxlunghezza-seq
leggi come sequenza con lunghezza indefinita

manipolazione di elementi di delimitazione errati:

-rd --use-delim-items
usa elementi di delimitazione dal set di dati (impostazione predefinita)

+rd --replace-sbagliato-delim
sostituire gli elementi di delimitazione della sequenza/elemento errati

gestione generale degli errori del parser:

+Ep --ignore-analisi-errori
prova a recuperare da errori di analisi

-Ep --handle-parse-errori
gestire gli errori di analisi e interrompere l'analisi (impostazione predefinita)

altre opzioni di analisi:

+st --stop-after-elem [t]ag: "gggg,eeee" o nome del dizionario
interrompe l'analisi dopo l'elemento specificato da t

correzione automatica dei dati:

+dc --abilita-correzione
abilitare la correzione automatica dei dati (impostazione predefinita)

-dc --disabilita-correzione
disabilitare la correzione automatica dei dati

formato bitstream dell'input sgonfio:

+bd --bitstream-sgonfiato
aspetta un bitstream sgonfio (predefinito)

+bz --bitstream-zlib
aspettati un flusso di bit zlib sgonfio

lavorazione Opzioni
set di caratteri specifico:

+U8 --converti-in-utf8
convertire tutti i valori degli elementi interessati
dal set di caratteri specifico (0008,0005) a UTF-8

# richiede il supporto del toolkit libiconv

produzione Opzioni
stampa:

+L --stampa-tutto
stampa completamente i valori dei tag lunghi

-L --print-breve
stampa i valori dei tag lunghi abbreviati (impostazione predefinita)

+T --stampa-albero
stampa la struttura gerarchica come un semplice albero

-T --stampa-indentata
stampa la struttura gerarchica rientrata (impostazione predefinita)

+F --print-nomefile
stampa l'intestazione con il nome del file per ogni file di input

+Fs --stampa-ricerca-file
stampa intestazione con nome file solo per quei file di input
che contengono uno dei tag cercati

Mappatura:

+Un --map-uid-nomi
mappare i numeri UID noti ai nomi (impostazione predefinita)

-Un --no-uid-nomi
non mappare i numeri UID noti ai nomi

citando:

+Qn --quote-nonascii
citare caratteri non ASCII e controllare i caratteri come markup XML

+Qo --quote-as-ottale
citare caratteri non ASCII e controllare i caratteri come numeri ottali

-Qn --print-nonascii
stampa caratteri non ASCII e di controllo (impostazione predefinita)

colore:

+C --stampa-colore
usa i codici di escape ANSI per l'output colorato

# non disponibile su sistemi Windows

-C --no-colore
non utilizzare codici di escape ANSI (impostazione predefinita)

# non disponibile su sistemi Windows

gestione degli errori:

-E --stop-on-errore
non stampare se il file è danneggiato (impostazione predefinita)

+E --ignora-errori
tentare di stampare anche se il file è danneggiato

ricerca:

+P --search [t]ag: "gggg,eeee" o nome del dizionario
stampa il dump testuale del tag t
questa opzione può essere specificata più volte
(predefinito: viene stampato il file completo)

+s --cerca-tutto
stampa tutte le istanze dei tag cercati (impostazione predefinita)

-s --cerca prima
stampa solo la prima istanza dei tag cercati

+p --anteponi
anteporre la gerarchia della sequenza al tag stampato,
indicato da: (gggg,eeee).(gggg,eeee).*
(solo se usato con --search)

-p --senza anteporre
non anteporre la gerarchia al tag (impostazione predefinita)

di scrittura:

+W --write-pixel [d]directory: stringa
scrivi i dati dei pixel in un file .raw archiviato in d
(little endian, nome file creato automaticamente)

NOTE

L'aggiunta di directory come parametro alla riga di comando ha senso solo se option --scansione-
directory è anche dato. Se i file nelle directory fornite devono essere selezionati
secondo un modello di nome specifico (ad esempio utilizzando la corrispondenza con caratteri jolly), opzione --modello-scansione
deve essere utilizzato. Si prega di notare che questo modello di file si applica solo ai file all'interno del
directory scansionate e, se sono specificati altri modelli sulla riga di comando all'esterno
, il --modello-scansione opzione (ad es. per selezionare ulteriori file), questi non si applicano a
le directory specificate.

REGISTRAZIONE

Il livello di registrazione dell'output dei vari strumenti della riga di comando e delle librerie sottostanti può
essere specificato dall'utente. Per impostazione predefinita, nello standard vengono scritti solo gli errori e gli avvisi
flusso di errore. Usando l'opzione --verboso anche messaggi informativi come i dettagli di elaborazione
sono segnalati. Opzione - debug può essere utilizzato per ottenere maggiori dettagli sull'attività interna,
ad esempio per scopi di debug. Altri livelli di registrazione possono essere selezionati utilizzando l'opzione --tronco d'albero-
livello. in --silenzioso vengono segnalati solo errori fatali. In tali eventi di errore molto gravi,
l'applicazione di solito termina. Per maggiori dettagli sui diversi livelli di registrazione,
vedere la documentazione del modulo 'oflog'.

Nel caso in cui l'output di registrazione debba essere scritto su file (facoltativamente con la rotazione del file di registro),
a syslog (Unix) o all'opzione registro eventi (Windows) --log-config può essere utilizzato. Questo
il file di configurazione consente anche di indirizzare solo determinati messaggi a un particolare output
stream e per filtrare determinati messaggi in base al modulo o all'applicazione in cui si trovano
sono generati. Un file di configurazione di esempio è fornito in /logger.cfg.

COMANDO LINE

Tutti gli strumenti della riga di comando utilizzano la seguente notazione per i parametri: parentesi quadre racchiudono
valori facoltativi (0-1), tre punti finali indicano che sono consentiti più valori
(1-n), una combinazione di entrambi significa valori da 0 a n.

Le opzioni della riga di comando si distinguono dai parametri da un segno '+' o '-' iniziale,
rispettivamente. Di solito, l'ordine e la posizione delle opzioni della riga di comando sono arbitrari (cioè
può apparire ovunque). Tuttavia, se le opzioni si escludono a vicenda, l'aspetto più a destra
viene utilizzato. Questo comportamento è conforme alle regole di valutazione standard delle comuni shell Unix.

Inoltre, è possibile specificare uno o più file di comando utilizzando un segno '@' come prefisso per
il nome del file (es @comando.txt). Tale argomento di comando è sostituito dal contenuto di
il file di testo corrispondente (più spazi bianchi sono trattati come un singolo separatore a meno che
compaiono tra due virgolette) prima di ogni ulteriore valutazione. Si prega di notare che
un file di comandi non può contenere un altro file di comandi. Questo approccio semplice ma efficace
permette di riassumere combinazioni comuni di opzioni/parametri ed evita lunghe e
righe di comando confuse (un esempio è fornito in file /dumppat.txt).

AMBIENTE

. dcmdump l'utility tenterà di caricare i dizionari di dati DICOM specificati nel
DCMDICPATH variabile d'ambiente. Per impostazione predefinita, cioè se il DCMDICPATH variabile d'ambiente
non è impostato, il file /dicom.dic verrà caricato a meno che non venga creato il dizionario
nell'applicazione (impostazione predefinita per Windows).

Il comportamento predefinito dovrebbe essere preferito e il DCMDICPATH solo variabile d'ambiente
utilizzato quando sono richiesti dizionari di dati alternativi. Il DCMDICPATH variabile d'ambiente
ha lo stesso formato della shell Unix PERCORSO variabile in quanto i due punti (':') separa
inserimenti. Sui sistemi Windows, viene utilizzato un punto e virgola (';') come separatore. Il dizionario dei dati
il codice tenterà di caricare ogni file specificato nel DCMDICPATH variabile d'ambiente. Esso
è un errore se non è possibile caricare alcun dizionario dati.

Utilizzare dcmdump online utilizzando i servizi onworks.net