gdcmscu - Online na nuvem

PROGRAMA:

NOME

gdcmscu - Ferramenta para executar uma operação de consulta / recuperação DICOM

SINOPSE

gdcmscu [OPÇÃO] ... [OPERAÇÃO] ... NOME DO HOST ... [PORTA] ...

Execute uma operação DICOM Q / R para HOSTNAME, usando a porta PORT (104 quando não especificada)

DESCRIÇÃO

O gdcmscu O programa de linha de comando é a ferramenta para executar a operação DICOM Query / Retrieve. Isto
apoia:

· C-ECO (SCU)

· C-FIND (SCU)

· C-STORE (SCU)

· C-MOVE (SCU / SCP) A operação C-MOVE é executada usando duas portas diferentes (uma para o
SCU e um para o SCP).

PARÂMETROS

OPÇÕES

aplicação opções
-H --hostname% s Nome do host.
-p --port% d Número da porta.
--aetitle% s Define o título AE de chamada.
--call% s Conjunto chamado Título AE.

modo opções
--echo C-ECHO (padrão quando nenhum).
--store C-STORE.
--encontrar C-FIND.
--move C-MOVER.

C-LOJA opções
-i --input% s nome do arquivo DICOM
-r --recursive processa recursivamente (sub-) diretórios
--store-query% s Armazenar consulta construída em arquivo

C-FIND / C-MOVE opções
-- Patientroot C-FIND Patient Root Model.
--studyroot C-FIND Study Model Root.

--patient C-FIND Query on Patient Info (não pode ser usado com --studyroot).
--study C-FIND Consulta nas informações do estudo.
--series C-FIND Query em Series Info.
--image C-FIND Query em Image Info.
--key% d,% d [=% s] 0123,4567 = VALUE para especificar os critérios de pesquisa (caractere curinga permitido)
Com --key, deixe em branco (ou seja, --key 10,20 = "" ou --key 10,20) para recuperar os valores

C-MOVE opções
-o --output% s nome do arquivo / diretório DICOM
--port-scp% d Porta para associações de entrada
--key% d,% d [=% s 0123,4567 = VALUE para especificar os critérios de pesquisa (curinga não permitido)
Observe que C-MOVE suporta as mesmas consultas que C-FIND, mas nenhum caractere curinga é permitido

geral opções
-h --ajuda
imprima este texto de ajuda e saia

-v --versão
imprimir informações da versão e sair

-V --verboso
modo detalhado (aviso + erro).

-W - advertência
modo de aviso, imprimir informações de aviso

-E --erro
modo de erro, imprimir informações de erro

-D --depurar
modo de depuração, imprimir informações de depuração

-L --arquivo de log
especifique um nome de arquivo onde escrever os logs

--queryhelp
imprimir ajuda da consulta

meio Ambiente variável
GDCM_ROOT_UID UID de raiz

C-ECO USO

gdcmscu é uma ótima ferramenta para testar se um servidor DICOM está ativo. Por exemplo, para enviar um C-ECHO para
servidor dicom.example.com usando a porta 104, use:

$ gdcmscu dicom.example.com

ou se preferir ser explícito:

$ gdcmscu --echo dicom.example.com 104

Usando a segurança básica, seu servidor DICOM pode exigir que você defina a chamada apropriada
TÍTULO AE

$ gdcmscu --echo dicom.example.com 11112 --call SERWSCP

Se você quiser especificar seu próprio AE-TITLE (o padrão é GDCMSCU), basta usar:

$ gdcmscu --echo dicom.example.com 11112 --chamar SERVSCP --aetitle MYSCU

Por exemplo, você pode testar no servidor DICOM fornecido pela equipe DICOMObject:

$ gdcmscu www.dicomserver.co.uk 11112

C-LOJA USO

C-STORE é a operação que permite enviar um arquivo DICOM a um servidor DICOM remoto. Para
instância para enviar um arquivo chamado myfile.dcm

$ gdcmscu --store dicom.example.com 104 meuarquivo.dcm

ou se preferir ser explícito:

$ gdcmscu --store dicom.example.com 104 -i meuarquivo.dcm

Você pode até enviar vários arquivos usando a mesma associação:

$ gdcmscu --store dicom.example.com 104 meuarquivo1.dcm meuarquivo2.dcm meuarquivo3.dcm ...

C-ENCONTRAR USO

gdcmscu também permite consultar um servidor DICOM. Esta é a operação C-FIND, por exemplo para
encontre todas as instâncias DICOM onde o Nome do Paciente corresponde a um padrão específico, o uso é simplesmente:

$ gdcmscu --find --patient dicom.example.com 11112 --patientroot --key 10,10, "A *"

Também oferecemos suporte a uma convenção compatível com DCMTK:

$ gdcmscu --find --patient dicom.example.com 11112 --patientroot --key 10,10 = "A *"

Quando um atributo é definido sem um valor, ele fará parte do resultado de saída:

$ gdcmscu --find --patient dicom.example.com 11112 --call MI2B2 --patientroot -k 10,10 = "A *" -k 10,20

C-MOVE USO

C-MOVE é a operação para recuperar uma instância DICOM de um servidor DICOM remoto. O máximo de
o tempo, é uma operação subsequente após uma consulta C-FIND. Para recuperar uma instância DICOM
onde PatientID é ABCD1234, basta executar:

$ gdcmscu --move --patient --aetitle ACME1 --call ACME_STORE dicom.example.com 5678 --patientroot -k 10,20 = "ABCD1234" --port-scp 1234

AVISO Para que esta operação funcione, você precisa de informações do servidor DICOM que você está
comunicar-se com. Apenas o servidor DICOM para o qual você está enviando uma consulta C-MOVE será
responsável por enviar de volta associações de entrada (o atual C-STORE SCP). Portanto você
precisa ter certeza de que seu mapeamento de (AE-TITLE, PortNumber) está configurado corretamente no DICOM
lado do servidor, bem como a porta para associação de entrada (–port-scp).

gdcmscu atualmente não suporta associação C-STORE externa (solicitação C-STORE enviada para
um aplicativo SCP externo).

PACIENTE RAIZ NOTAS

O sinalizador –patientroot é simplesmente um invólucro em torno da sintaxe –key 8,52 = PACIENTE Para
instância que um gravaria usando a sintaxe DCMTK:

$ findscu --patient dicom.example.com 11112 --key 8,52 = PACIENTE --key 10,10 = "F *"

Isso se tornaria usando a sintaxe GDCM:

$ gdcmscu --find --patient dicom.example.com 11112 --patientroot --key 10,10 = "F *"

DEPURAÇÃO

Às vezes é difícil investigar porque uma conexão com um servidor DICOM remoto não pode
ser feito. Seguem algumas recomendações:

Sempre tente fazer um C-ECHO simples no início. Se você não consegue fazer o C-ECHO funcionar, nenhum dos
as outras operações funcionarão

Antes de tentar uma operação C-MOVE, certifique-se de que você pode executar a consulta equivalente C-FIND
em primeiro lugar.

Ao fazer uma operação C-MOVE, você realmente precisa se comunicar com o administrador do PACS como o
A operação C-MOVE é diferente da outra operação de nível inferior, como HTTP / GET. Quando
fazendo um C-MOVE, o servidor irá se comunicar de volta usando outro canal (pode ser diferente
porta) usando seu banco de dados interno para mapear um AE-TITLE de volta ao IP de destino.

Na verdade, a operação C-MOVE projetada nem sempre usa seu endereço IP de entrada para enviar
de volta o conjunto de dados resultante. Em vez disso, ele usa um mapeamento de AE-TITLE para endereço IP para enviar
de volta todos os resultados. Portanto, preste atenção especial à grafia de seu AE-TITLE e de seu
porta de entrada (que pode ser diferente da porta para conectar ao servidor).

PORT ATENÇÃO

Observe que o intervalo de portas [1-1024] está reservado para admin e não é facilmente acessível
a menos que tenham privilégios especiais. Portanto, a porta DICOM 104 padrão pode não ser
acessível a todos os seus usuários.

C-LOJA AVISOS

Ao construir uma operação C-STORE, gdcmscu sempre usará a classe SOP de armazenamento de mídia
UID conforme encontrado no arquivo a ser enviado. Para arquivo DICOM encapsulado (por exemplo, RLE Lossless), o
O servidor SCP de recebimento pode não suportar esta compressão e recusará legitimamente o
Operação C-STORE. Neste caso, os usuários devem converter manualmente para um formato não compactado
este arquivo em particular:

$ gdcmconv --raw compact.dcm non_compressed.dcm

C-MOVE AVISOS

No momento gdcmscu suporta apenas sintaxe de transferência não compactada. Sempre solicitará
DataSet usando a sintaxe de transferência de Little Endian implícita de VR durante uma operação C-MOVE (ambos
associações de entrada e saída). Isso torna gdcmscu –move equivalente a DCMTK movescu
sintaxe:

$ movescu -xi + xi ...

C-ENCONTRAR IMAGEM NÍVEL (COMPOSTO OBJETO INSTÂNCIA)

Deve-se prestar atenção que gdcmscu –find e findscu não são completamente equivalentes.
Usando gdcmscu –find, todas as chaves exclusivas serão adicionadas automaticamente. Pode-se, portanto,
execute algo assim:

$ gdcmscu --find --patientroot --image --key 8,18 = 1.2.3.4.5.6 dicom.example.com 11112

em vez da forma mais explícita

$ gdcmscu --find --patientroot --image --key 8,18 = 1.2.3.4.5.6 dicom.example.com 11112 --key 10,20 --key 20, d --key 20, e

Isso também seria equivalente a:

$ findscu --patient --key 8,52 = IMAGEM --key 8,18 = 1.2.3.4.5.6 dicom.example.com 11112 --key 10,20 --key 20, d --key 20, e

ARMAZENAGEM A INQUERIR

Também é possível armazenar a consulta:

gdcmscu --find --patient --patientroot dicom.example.com 11112 --key 10,20 = "*" --key 10,10 --store-query query.dcm

Pode-se então verificar os valores do DataSet enviados para a consulta:

$ consulta gdcmdump.dcm
# Formato de arquivo Dicom

# Dicom-Meta-Information-Header
# TransferSyntax usado:

# Conjunto de dados Dicom
# Sintaxe de transferência usada: 1.2.840.10008.1.2
(0008,0005) ?? (CS) [ISO_IR 192] # 10,1-n ​​Conjunto de caracteres específicos
(0008,0052) ?? (CS) [PATIENT] # 8,1 Nível de consulta / recuperação
(0010,0010) ?? (PN) (sem valor) # 0,1 Nome do paciente
(0010,0020) ?? (LO) [*] # 2,1 ID do paciente

O conjunto de caracteres específicos foi definido como "ISO_IR 192" como a codificação local do sistema
foi encontrado automaticamente pelo gdcmscu como sendo UTF-8.

Isso significa que a seguinte linha de comando configurará corretamente a consulta com o
Charset apropriado para ser executado corretamente:

$ gdcmscu --find --patient --patientroot dicom.example.com 11112 --key 10,10 = "* Jérôme *"

A consulta é sempre executada no lado do servidor (SCP), algumas implementações não
suporte a correspondência de seqüência de caracteres com diferentes conjuntos de caracteres.

DICOM PÚBLICO SERVIDORES

Uma lista atualizada de servidores públicos DICOM pode ser encontrada em:

http://www.dclunie.com/medical-image-faq/html/part8.html#DICOMPublicServers

Use gdcmscu online usando serviços onworks.net