dcmdump: exibir arquivo DICOM e conjunto de dados

SINOPSE

dcmdump [options] dcmfile-in...

DESCRIÇÃO

O utilitário dcmdump exibe o conteúdo de um arquivo DICOM (formato de arquivo ou conjunto de dados bruto) para o stdout, em formato textual. Atributos com campos de valor muito grandes (por exemplo, dados de pixel) podem ser descritos como "(not loaded)". Os campos de valor do tipo string são delimitados por colchetes ([]). UIDs conhecidos são exibidos pelo seu nome, precedido de um sinal de igual (por exemplo, "=MRImageStorage"), a menos que esse mapeamento seja explicitamente desativado. Campos de valor vazios são descritos como "(no value available)".

Se o dcmdump ler um conjunto de dados bruto (dados DICOM sem cabeçalho meta de formato de arquivo), ele tentará adivinhar a sintaxe de transferência examinando os primeiros bytes do arquivo. Nem sempre é possível adivinhar corretamente a sintaxe de transferência, e é preferível converter um conjunto de dados para um formato de arquivo sempre que possível (usando o utilitário dcmconv). Também é possível usar as opções -f e -t[ieb] para forçar o dcmdump a ler um conjunto de dados com uma sintaxe de transferência específica.

PARÂMETROS

dcmfile-in  DICOM input file or directory to be dumped ("-" for stdin)

OPÇÕES

opções gerais

-h --help: exibe este texto de ajuda e sai
--version: exibe as informações de versão e sai
--arguments: exibe os argumentos de linha de comando expandidos
-q --quiet: modo silencioso, não exibe avisos nem erros
-v --verbose: modo detalhado, exibe os detalhes do processamento
-d --debug: modo de depuração, exibe informações de depuração
-ll --log-level [l]evel: string constant: (fatal, error, warn, info, debug, trace) usa o nível l para o logger
-lc --log-config [f]ilename: string: usa o arquivo de configuração f para o logger

opções de entrada

+f --read-file: lê o formato de arquivo ou o conjunto de dados (padrão)
+fo --read-file-only: lê apenas o formato de arquivo
-f --read-dataset: lê o conjunto de dados sem as informações meta do arquivo. sintaxe de transferência de entrada:
-t= --read-xfer-auto: usa o reconhecimento de TS (padrão)
-td --read-xfer-detect: ignora a TS especificada no cabeçalho meta do arquivo
-te --read-xfer-little: lê com a TS explicit VR little endian
-tb --read-xfer-big: lê com a TS explicit VR big endian
-ti --read-xfer-implicit: lê com TS implicit VR little endian. arquivos de entrada:
+sd --scan-directories: varre diretórios em busca de arquivos de entrada (dcmfile-in)
+sp --scan-pattern [p]attern: string (only with --scan-directories): padrão para correspondência de nomes de arquivo (curingas) # possivelmente não disponível em todos os sistemas
-r --no-recurse: não percorre os diretórios recursivamente (padrão)
+r --recurse: percorre recursivamente os diretórios especificados. valores de tag longos:
+M --load-all: carrega valores de tag muito longos (padrão)
-M --load-short: não carrega valores muito longos (por exemplo, dados de pixel)
+R --max-read-length [k]bytes: integer (4..4194302, default: 4): define o limite para valores longos em k kilobytes. análise das informações meta do arquivo:
+ml --use-meta-length: usa o comprimento de grupo das informações meta do arquivo (padrão)
-ml --ignore-meta-length: ignora o comprimento de grupo das informações meta do arquivo. análise de atributos de comprimento ímpar:
+ao --accept-odd-length: aceita atributos de comprimento ímpar (padrão)
+ae --assume-even-length: assume que o comprimento real é um byte maior. tratamento do explicit VR:
+ev --use-explicit-vr: usa o explicit VR do conjunto de dados (padrão)
-ev --ignore-explicit-vr: ignora o explicit VR (prioriza o dicionário de dados). tratamento de VR não padrão:
+vr --treat-as-unknown: trata VR não padrão como unknown (padrão)
-vr --assume-implicit: tenta ler com a TS implicit VR little endian. tratamento de elementos UN de comprimento indefinido:
+ui --enable-cp246: lê UN de comprimento indefinido como implicit VR (padrão)
-ui --disable-cp246: lê UN de comprimento indefinido como explicit VR. tratamento de elementos UN de comprimento definido:
-uc --retain-un: mantém os elementos como UN (padrão)
+uc --convert-un: converte para a VR real, se conhecida. tratamento de elementos privados de comprimento máximo (implicit VR):
-sq --maxlength-dict: lê conforme definido no dicionário (padrão)
+sq --maxlength-seq: lê como sequência de comprimento indefinido. tratamento de itens de delimitação incorretos:
-rd --use-delim-items: usa os itens de delimitação do conjunto de dados (padrão)
+rd --replace-wrong-delim: substitui itens de delimitação de sequência/item incorretos. tratamento de elementos OB/OW ilegais de comprimento indefinido:
-oi --illegal-obow-rej: rejeita o conjunto de dados com elemento ilegal (padrão)
+oi --illegal-obow-conv: converte elemento OB/OW de comprimento indefinido para SQ. tratamento de VOI LUT Sequence com VR OW e comprimento explícito:
-vi --illegal-voi-rej: rejeita o conjunto de dados com VOI LUT ilegal (padrão)
+vi --illegal-voi-conv: converte VOI LUT ilegal para SQ. tratamento de dados de pixel de comprimento explícito para sintaxes de transferência encapsuladas:
-pe --abort-expl-pixdata: aborta em caso de dados de pixel de comprimento explícito (padrão)
+pe --use-expl-pixdata: usa dados de pixel de comprimento explícito. tratamento geral de erros de análise:
+Ep --ignore-parse-errors: tenta se recuperar de erros de análise
-Ep --handle-parse-errors: trata erros de análise e interrompe a análise (padrão). outras opções de análise:
+st --stop-after-elem [t]ag: "gggg,eeee" or dictionary name: interrompe a análise após o elemento especificado por t
+sb --stop-before-elem [t]ag: "gggg,eeee" or dictionary name: interrompe a análise antes do elemento especificado por t # considera apenas elementos no nível principal do conjunto de dados e também # funciona se a tag informada não estiver presente no arquivo. correção automática de dados:
+dc --enable-correction: habilita a correção automática de dados (padrão)
-dc --disable-correction: desabilita a correção automática de dados. formato de bitstream da entrada deflate:
+bd --bitstream-deflated: espera um bitstream deflate (padrão)
+bz --bitstream-zlib: espera um bitstream deflate no formato zlib

opções de processamento

specific character set:

  +U8  --convert-to-utf8
         convert all element values that are affected
         by Specific Character Set (0008,0005) to UTF-8

         # requires support from an underlying character encoding library
         # (see output of --version on which one is available)

opções de saída

+L --print-all: exibe valores de tag longos por completo
-L --print-short: exibe valores de tag longos de forma abreviada (padrão)
+T --print-tree: exibe a estrutura hierárquica como uma árvore simples
-T --print-indented: exibe a estrutura hierárquica com indentação (padrão)
+F --print-filename: exibe um cabeçalho com o nome do arquivo para cada arquivo de entrada
+Fs --print-file-search: exibe um cabeçalho com o nome do arquivo apenas para os arquivos de entrada que contêm uma das tags pesquisadas. mapeamento:
+Un --map-uid-names: mapeia números de UID conhecidos para nomes (padrão)
-Un --no-uid-names: não mapeia números de UID conhecidos para nomes. citação:
+Qn --quote-nonascii: representa caracteres não ASCII e de controle como marcação XML
+Qo --quote-as-octal: representa caracteres não ASCII e de controle como números octais
-Qn --print-nonascii: exibe caracteres não ASCII e de controle tal como estão (padrão). cor:
+C --print-color: usa códigos de escape ANSI para saída colorida
-C --no-color: não usa nenhum código de escape ANSI (padrão). tratamento de erros:
-E --stop-on-error: não exibe nada se o arquivo estiver danificado (padrão)
+E --ignore-errors: tenta exibir mesmo que o arquivo esteja danificado. pesquisa:
+P --search [t]ag: "gggg,eeee" or dictionary name: exibe o dump textual da tag t. esta opção pode ser especificada várias vezes (padrão: o arquivo completo é exibido)
+s --search-all: exibe todas as ocorrências das tags pesquisadas (padrão)
-s --search-first: exibe apenas a primeira ocorrência das tags pesquisadas
+p --prepend: antepõe a hierarquia de sequência à tag exibida, denotada por: (gggg,eeee).(gggg,eeee).* (somente quando usado com --search)
-p --no-prepend: não antepõe a hierarquia à tag (padrão). gravação:
+W --write-pixel [d]irectory: string: grava os dados de pixel em um arquivo .raw armazenado em d (little endian, nome de arquivo gerado automaticamente)

NOTAS

Informar diretórios como parâmetro na linha de comando só faz sentido se a opção –scan-directories também for especificada. Caso os arquivos nos diretórios informados precisem ser selecionados de acordo com um padrão de nome específico (por exemplo, usando correspondência por curingas), a opção –scan-pattern deve ser usada. Observe que esse padrão de arquivo se aplica apenas aos arquivos dentro dos diretórios varridos e que, se outros padrões forem especificados na linha de comando fora da opção –scan-pattern (por exemplo, para selecionar outros arquivos), eles não se aplicam aos diretórios especificados.

REGISTRO DE LOG

O nível de detalhamento do log das diversas ferramentas de linha de comando e das bibliotecas subjacentes pode ser especificado pelo usuário. Por padrão, apenas erros e avisos são gravados no fluxo de erro padrão. Ao usar a opção –verbose, mensagens informativas, como detalhes do processamento, também são relatadas. A opção –debug pode ser usada para obter mais detalhes sobre a atividade interna, por exemplo, para fins de depuração. Outros níveis de log podem ser selecionados com a opção –log-level. No modo –quiet, apenas erros fatais são relatados. Nesses casos de erro muito graves, o aplicativo normalmente é encerrado. Para mais detalhes sobre os diferentes níveis de log, consulte a documentação do módulo "oflog".

Caso a saída do log deva ser gravada em arquivo (opcionalmente com rotação de arquivo de log), no syslog (Unix) ou no log de eventos (Windows), pode-se usar a opção –log-config. Esse arquivo de configuração também permite direcionar apenas determinadas mensagens para um fluxo de saída específico e filtrar certas mensagens com base no módulo ou aplicativo em que são geradas. Um arquivo de configuração de exemplo é fornecido em < etcdir>/logger.cfg.

LINHA DE COMANDO

Todas as ferramentas de linha de comando usam a seguinte notação para os parâmetros: colchetes delimitam valores opcionais (0-1), reticências no final indicam que múltiplos valores são permitidos (1-n), e a combinação dos dois significa de 0 a n valores.

As opções de linha de comando se distinguem dos parâmetros por um sinal '+' ou '-' à frente. Normalmente, a ordem e a posição das opções de linha de comando são arbitrárias (ou seja, podem aparecer em qualquer lugar). No entanto, se as opções forem mutuamente exclusivas, é usada a ocorrência mais à direita. Esse comportamento está em conformidade com as regras de avaliação padrão dos shells Unix comuns.

Além disso, um ou mais arquivos de comando podem ser especificados usando um sinal '@' como prefixo do nome do arquivo (por exemplo, @command.txt). Esse argumento de comando é substituído pelo conteúdo do arquivo de texto correspondente (múltiplos espaços em branco são tratados como um único separador, a menos que apareçam entre duas aspas) antes de qualquer avaliação posterior. Observe que um arquivo de comando não pode conter outro arquivo de comando. Essa abordagem simples, mas eficaz, permite agrupar combinações comuns de opções/parâmetros e evita linhas de comando longas e confusas (um exemplo é fornecido no arquivo < datadir>/dumppat.txt).

AMBIENTE

O utilitário dcmdump tentará carregar os dicionários de dados DICOM especificados na variável de ambiente DCMDICTPATH. Por padrão, ou seja, se a variável de ambiente DCMDICTPATH não estiver definida, o arquivo < datadir>/dicom.dic será carregado, a menos que o dicionário esteja embutido no aplicativo (padrão para Windows).

É preferível manter o comportamento padrão e usar a variável de ambiente DCMDICTPATH apenas quando dicionários de dados alternativos forem necessários. A variável de ambiente DCMDICTPATH tem o mesmo formato da variável PATH dos shells Unix, em que dois-pontos (":") separam as entradas. Em sistemas Windows, um ponto e vírgula (";") é usado como separador. O código do dicionário de dados tenta carregar cada arquivo especificado na variável de ambiente DCMDICTPATH. Ocorre um erro se nenhum dicionário de dados puder ser carregado.

Dependendo das opções de linha de comando especificadas, o utilitário dcmdump tentará carregar tabelas de mapeamento de conjunto de caracteres. Isso ocorre quando o DCMTK foi compilado com a biblioteca oficonv (que é o padrão) e as tabelas de mapeamento não estão embutidas na biblioteca (padrão quando o DCMTK usa bibliotecas compartilhadas).

Os arquivos de tabela de mapeamento são esperados em < datadir> do DCMTK. A variável de ambiente DCMICONVPATH pode ser usada para especificar um local diferente. Se um local diferente for especificado, essas tabelas de mapeamento também substituem quaisquer tabelas integradas.

VEJA TAMBÉM

dump2dcm(1), dcmconv(1)