dcmdspfn: exportar curvas de exibição padrão para um arquivo de texto

SINOPSE

dcmdspfn [options]

DESCRIÇÃO

O programa de linha de comando converte um arquivo de características de monitor / câmera / impressora / scanner do DCMTK em um arquivo de texto delimitado por tabulações que descreve a curva característica (CC), a função de exibição e a curva pós-padronizada (PSC) para uma exibição de 8 bits. Os 256 valores de cada curva podem ser visualizados em um programa de planilha eletrônica comum. Além disso, a curva de exibição (sem CC e PSC) também pode ser calculada para uma faixa de luminância/OD especificada (mín/máx) e um determinado número de Digital Driving Levels (DDL).

PARÂMETROS

dcmfile-in  DICOM input filename to be dumped

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 (mutuamente exclusivas)

+Im --monitor-file [f]ilename: string: arquivo de texto que descreve as características do monitor
+Ic --camera-file [f]ilename: string: arquivo de texto que descreve as características da câmera
+Ip --printer-file [f]ilename: string: arquivo de texto que descreve as características da impressora
+Is --scanner-file [f]ilename: string: arquivo de texto que descreve as características do scanner
+Il --lum-range [m]in max: float: luminância mínima e máxima (cd/m^2)
+Io --od-range [m]in max: float: densidade óptica (OD) mínima e máxima, convertidas automaticamente em luminância

opções de criação

+Ca --ambient-light [a]mbient light: float: valor de luz ambiente (cd/m^2, padrão: arquivo f)
+Ci --illumination [i]llumination: float: valor de iluminação (cd/m^2, padrão: arquivo f)
+Dn --min-density [m]inimum optical density: float: valor Dmin (padrão: off, somente com +Ip e +Io)
+Dx --max-density [m]aximum optical density: float: valor Dmax (padrão: off, somente com +Ip e +Io)
+Cd --ddl-count [n]umber of DDLs: integer: número de Digital Driving Levels (padrão: 256, somente com --lum/od-range)
+Cf --curve-fitting [n]umber: integer: usa um algoritmo de ajuste de curva polinomial de ordem n (0..99, padrão: configuração do arquivo ou spline cúbica)

opções de saída

+Og --gsdf [f]ilename: string: grava os dados da curva GSDF no arquivo f
+Oc --cielab [f]ilename: string: grava os dados da curva CIELAB no arquivo f

NOTAS

O arquivo de saída que descreve a CC, o GSDF ou o CIELAB e a PSC para um sistema de exibição de 8 bits (monitor, câmera, impressora ou scanner) é um arquivo de texto simples. Linhas iniciadas com '#' são tratadas como comentários e, portanto, ignoradas, assim como as linhas em branco. Um arquivo de entrada pode, por exemplo, ser criado com a ferramenta de linha de comando dconvlum.

O valor de luz ambiente, quando definido no arquivo de características, também é usado no cálculo. Nesse caso, o valor faz parte do cabeçalho de comentários do arquivo, assim como o número de valores DDL (digital driving level), a faixa de luminância absoluta (medida em candela por metro quadrado) e, no caso do GSDF, a faixa do índice JND (just noticeable difference, a menor diferença perceptível). Alternativamente, o valor de luz ambiente pode ser especificado como opção de linha de comando. Ao definir os dois valores de luminância em vez de ler um arquivo de características de monitor como entrada, a faixa de luminância é dividida linearmente pelo número de DDLs.

Para impressoras e scanners, a iluminação pode ser especificada além da luz ambiente refletida (tanto no arquivo de características quanto na linha de comando). O cabeçalho do arquivo de saída inclui a Densidade Óptica (OD) mínima e máxima em vez da faixa de luminância. Observe que os valores de OD no arquivo de entrada devem estar em ordem decrescente (ao contrário dos valores de luminância usados para monitores e câmeras). O valor DDL 0 sempre significa preto (o valor mais escuro) e o valor DDL máximo significa branco (o valor mais claro, filme transparente).

A pasta data contém arquivos de características de exemplo para monitores, câmeras, impressoras e scanners. Consulte a parte 14 do padrão DICOM para mais detalhes sobre a calibração de exibição e o modelo de Barten (incluindo o GSDF).

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

ARQUIVOS

< datadir>/camera.lut - exemplo de arquivo de características de uma câmera
< datadir>/monitor.lut - exemplo de arquivo de características de um monitor
< datadir>/printer.lut - exemplo de arquivo de características de uma impressora
< datadir>/scanner.lut - exemplo de arquivo de características de um scanner

VEJA TAMBÉM

dconvlum(1), dcod2lum(1)