dcmencap: encapsular documento em formato DICOM

SINOPSE

dcmencap [options] docfile-in dcmfile-out

DESCRIÇÃO

O utilitário dcmencap lê um arquivo de documento em um dos formatos de arquivo compatíveis, converte-o na instância SOP correspondente da classe SOP DICOM Encapsulated Storage e armazena os dados convertidos em um arquivo de saída (dcmfile-out).

PARÂMETROS

docfile-in   input filename to be converted

dcmfile-out  DICOM output filename ("-" for stdout)

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

+fa --filetype-auto: determina automaticamente o tipo de arquivo (padrão)
+fp --filetype-pdf: espera um arquivo PDF
+fc --filetype-cda: espera um arquivo CDA
+fs --filetype-stl: espera um arquivo STL
+fm --filetype-mtl: espera um arquivo MTL
+fo --filetype-obj: espera um arquivo OBJ

opções do documento DICOM

+t --title [t]itle: string (default: empty): título do documento
+cn --concept-name [CSD] [CV] [CM]: string (default: empty): representação codificada do título do documento definida pelo coding scheme designator CSD, code value CV e code meaning CM patient data:
+pn --patient-name [n]ame: string: nome do paciente na sintaxe DICOM PN
+pi --patient-id [i]d: string: identificador do paciente
+pb --patient-birthdate [d]ate: string (YYYYMMDD): data de nascimento do paciente
+ps --patient-sex [s]ex: string (M, F or O): sexo do paciente device data:
+mn --manufacturer [n]ame: string: nome do fabricante
+mm --manufacturer-model [n]ame: string: nome do modelo do fabricante
+ds --device-serial [n]umber: string: número de série do dispositivo
+sv --software-versions [v]ersions: string: versões do software manufacturing 3d model data (STL/MTL/OBJ only):
+mu --measurement-units [CSD] [CV] [CM]: string: unidades de medida com coding scheme designator CSD, code value CV e code meaning CM (padrão: UCUM, um, um) study and series:
+sg --generate: gera novos UIDs de study e de series (padrão)
+st --study-from [f]ilename: string: lê dados de paciente/study a partir de um arquivo DICOM
+se --series-from [f]ilename: string: lê dados de paciente/study/series a partir de um arquivo DICOM instance number:
+i1 --instance-one: usa o número de instância 1 (padrão, não pode ser usado com +se)
+ii --instance-inc: incrementa o número de instância (somente com +se)
+is --instance-set [i]nstance number: integer: usa o número de instância i burned-in annotation:
+an --annotation-yes: o documento contém dados que identificam o paciente (padrão)
-an --annotation-no: o documento não contém dados que identificam o paciente

opções de processamento

-ov --no-override: os dados de paciente e de documento da CDA devem corresponder às informações de study, series ou inseridas manualmente (padrão)
+ov --override: os dados da CDA serão sobrescritos pelas informações de study, series ou inseridas manualmente other processing options:
-k --key [k]ey: gggg,eeee="str", path or dictionary name="str": adiciona mais um atributo

opções de saída

+te --write-xfer-little: grava em explicit VR little endian (padrão)
+tb --write-xfer-big: grava com a TS explicit VR big endian
+ti --write-xfer-implicit: grava com implicit VR little endian TS group length encoding:
-g --group-length-remove: grava sem elementos group length (padrão)
+g --group-length-create: grava com elementos group length length encoding in sequences and items:
+e --length-explicit: grava com comprimentos explícitos (padrão)
-e --length-undefined: grava com comprimentos indefinidos preenchimento final do conjunto de dados (não com --write-dataset):
-p --padding-off: sem preenchimento (implícito com --write-dataset)
+p --padding-create [f]ile-pad [i]tem-pad: integer: alinha o arquivo em um múltiplo de f bytes e os itens em um múltiplo de i bytes

NOTAS

Fontes de atributos

O aplicativo pode receber informações adicionais para preencher os atributos obrigatórios (e opcionais) do novo arquivo DICOM, como as informações de paciente, study e series:

A opção –key pode ser usada para adicionar mais atributos ao arquivo DICOM de saída.
Também é possível especificar sequences, items e atributos aninhados usando a opção –key. Nesses casos, deve-se usar uma notação especial de "caminho". Os detalhes dessa notação de caminho podem ser encontrados na documentação do dcmodify.
A opção –key pode aparecer mais de uma vez.
A parte do valor (após o '=') pode estar ausente, fazendo com que o atributo seja definido com comprimento zero.
Observe que a opção –key é aplicada bem no final, logo antes de salvar o arquivo DICOM, de modo que nenhuma verificação de valor é realizada.

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).

CÓDIGOS DE SAÍDA

O utilitário dcmencap usa os seguintes códigos de saída ao terminar. Isso permite que o usuário verifique o motivo pelo qual o aplicativo foi encerrado.

geral

EXITCODE_NO_ERROR                 0

erros de arquivo de entrada

EXITCODE_INVALID_INPUT_FILE       22

erros de arquivo de saída

EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40

AMBIENTE

O utilitário dcmencap 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 no 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.