dcmpsmk: Criar presentation state DICOM em escala de cinza (softcopy)

SINOPSE

dcmpsmk [options] dcmfile-in dcmfile-out

DESCRIÇÃO

O aplicativo dcmpsmk lê um arquivo de imagem DICOM e cria um objeto grayscale softcopy presentation state conforme o Supplement 33. O objeto presentation state é gravado novamente no arquivo. Diversas opções de linha de comando permitem especificar como certas estruturas que possam estar presentes no arquivo de imagem devem ser referenciadas ou ativadas no presentation state. O presentation state recém-criado referencia a imagem de origem e contém valores que devem permitir uma exibição "razoável" da imagem quando renderizada sob controle do presentation state.

PARÂMETROS

dcmfile-in   DICOM image file(s) to be read ("-" for stdin)

dcmfile-out  DICOM presentation state file to be created ("-" 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

+f --read-file: lê o formato de arquivo ou o conjunto de dados (padrão)
+fo --read-file-only: lê somente 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 a TS implicit VR little endian

opções de processamento

+Vl --voi-lut: usa a primeira VOI LUT se presente (padrão)
+Vw --voi-window: usa o primeiro window center/width se presente
-V --voi-ignore: ignora a VOI LUT e o window center/width tratamento de curva:
+c --curve-activate: ativa os dados de curva se presentes (padrão)
-c --curve-ignore: ignora os dados de curva tratamento de overlay:
+oc --overlay-copy: copia os overlays se não estiverem incorporados, caso contrário os ativa (padrão)
+oa --overlay-activate: ativa os overlays
-o --overlay-ignore: ignora os overlays tratamento de shutter:
+s --shutter-activate: usa o shutter se presente na imagem (padrão)
-s --shutter-ignore: ignora o shutter tratamento da forma da LUT de apresentação:
+p --plut-activate: usa a forma da LUT de apresentação se presente (padrão)
-p --plut-ignore: ignora a forma da LUT de apresentação camadas:
+l1 --layer-single: todas as curvas e overlays ficam em uma única camada
+l2 --layer-double: uma camada para as curvas, outra para os overlays (padrão)
+ls --layer-separate: camadas separadas para cada curva e overlay localização da imagem referenciada:
-lx --location-none: referência de imagem sem localização (padrão)
-ln --location-network [a]etitle: string: imagem localizada na entidade de aplicação a
-lm --location-media [f]ilesetID, fileset[UID]: string: imagem localizada em suporte de armazenamento

opções de validação

--validate-std: as imagens referenciadas pela GSPS devem pertencer à mesma classe SOP (padrão)
--validate-related: as imagens referenciadas pela GSPS podem pertencer às classes SOP relacionadas 'for presentation' e 'for processing'
--validate-relaxed: as imagens referenciadas pela GSPS podem ser de qualquer classe SOP

opções de saída

+t= --write-xfer-same: grava com a mesma TS do arquivo de imagem (padrão)
+te --write-xfer-little: grava com a TS explicit VR little endian
+tb --write-xfer-big: grava com a TS explicit VR big endian
+ti --write-xfer-implicit: grava com a TS implicit VR little endian

NOTAS

Se mais de um arquivo de entrada (dcmfile-in) for especificado, os arquivos de imagem adicionais são apenas referenciados a partir do arquivo de presentation state criado, mas nenhuma informação adicional (por exemplo, relacionada à exibição) é incorporada.

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 aplicativo dcmpsmk tenta 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 o 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.