getscu: SCU de recuperação DICOM (C-GET)

SINOPSE

getscu [options] peer port [dcmfile-in...]

DESCRIÇÃO

O aplicativo getscu implementa um SCU para a Query/Retrieve Service Class. O getscu oferece suporte à funcionalidade de recuperação por meio da mensagem C-GET. Ele envia chaves de consulta a um SCP e aguarda respostas com imagens ou outros objetos DICOM enviados via C-STORE. Conforme exigido pelo serviço DICOM, o C-GET e as mensagens C-STORE associadas são tratados na mesma associação. Portanto, os objetos só podem ser recebidos pelo próprio getscu e não podem ser enviados a terceiros (o movescu seria a ferramenta adequada para essa tarefa).

PARÂMETROS

peer        hostname of DICOM peer

port        tcp/ip port number of peer

dcmfile-in  DICOM query file(s)

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
+v --verbose-pc: exibe os contextos de apresentação no modo detalhado

opções de rede

-k --key [k]ey: gggg,eeee="str", path or dictionary name="str": substitui a chave de correspondência. modelo de informação da consulta:
-P --patient: usa o modelo de informação patient root (padrão)
-S --study: usa o modelo de informação study root
-O --psonly: usa o modelo de informação patient/study only. versão do protocolo IP:
-i4 --ipv4: usa somente IPv4 (padrão)
-i6 --ipv6: usa somente IPv6
-i0 --ip-auto: usa consulta DNS para determinar o protocolo IP. títulos de entidade de aplicação:
-aet --aetitle [a]etitle: string: define meu AE Title de chamada (padrão: GETSCU)
-aec --call [a]etitle: string: define o AE Title chamado do par (padrão: ANY-SCP). sintaxes de transferência de armazenamento preferidas (associações de entrada):
+x= --prefer-uncompr: prefere o explicit VR com ordem de bytes local (padrão)
+xe --prefer-little: prefere a TS explicit VR little endian
+xb --prefer-big: prefere a TS explicit VR big endian
+xs --prefer-lossless: prefere a TS JPEG sem perdas padrão
+xy --prefer-jpeg8: prefere a TS JPEG lossy padrão para dados de 8 bits
+xx --prefer-jpeg12: prefere a TS JPEG lossy padrão para dados de 12 bits
+xv --prefer-j2k-lossless: prefere a TS JPEG 2000 lossless
+xw --prefer-j2k-lossy: prefere a TS JPEG 2000 lossy
+xt --prefer-jls-lossless: prefere a TS JPEG-LS lossless
+xu --prefer-jls-lossy: prefere a TS JPEG-LS lossy
+xm --prefer-mpeg2: prefere a TS MPEG2 Main Profile @ Main Level
+xh --prefer-mpeg2-high: prefere a TS MPEG2 Main Profile @ High Level
+xn --prefer-mpeg4: prefere a TS MPEG4 AVC/H.264 HP / Level 4.1
+xl --prefer-mpeg4-bd: prefere a TS MPEG4 AVC/H.264 BD-compatible HP / Level 4.1
+x2 --prefer-mpeg4-2-2d: prefere a TS MPEG4 AVC/H.264 HP / Level 4.2 para vídeos 2D
+x3 --prefer-mpeg4-2-3d: prefere a TS MPEG4 AVC/H.264 HP / Level 4.2 para vídeos 3D
+xo --prefer-mpeg4-2-st: prefere a TS MPEG4 AVC/H.264 Stereo HP / Level 4.2
+x4 --prefer-hevc: prefere a TS HEVC/H.265 Main Profile / Level 5.1
+x5 --prefer-hevc10: prefere a TS HEVC/H.265 Main 10 Profile / Level 5.1
+xr --prefer-rle: prefere a TS RLE lossless
+xd --prefer-deflated: prefere a TS deflated explicit VR little endian
+xi --implicit: aceita somente a TS implicit VR little endian. sintaxes de transferência de recuperação propostas (associações de saída):
-x= --propose-uncompr: propõe todas as TS não comprimidas, com o explicit VR e ordem de bytes local primeiro (padrão)
-xe --propose-little: propõe todas as TS não comprimidas, com o explicit VR little endian primeiro
-xb --propose-big: propõe todas as TS não comprimidas, com o explicit VR big endian primeiro
-xd --propose-deflated: propõe a TS deflated explicit VR little endian e todas as sintaxes de transferência não comprimidas
-xi --propose-implicit: propõe somente a TS implicit VR little endian. outras opções de rede:
-to --timeout [s]econds: integer (default: unlimited): tempo limite para solicitações de conexão
-ta --acse-timeout [s]econds: integer (default: 30): tempo limite para mensagens ACSE
-td --dimse-timeout [s]econds: integer (default: unlimited): tempo limite para mensagens DIMSE
-pdu --max-pdu [n]umber of bytes: integer (4096..131072): define a pdu máxima recebida em n bytes (padrão: 16384)
--repeat [n]umber: integer: repete n vezes
--abort: interrompe a associação em vez de liberá-la

opções de segurança da camada de transporte (TLS)

-tls --disable-tls: usa uma conexão TCP/IP normal (padrão)
+tls --enable-tls [p]rivate key file, [c]ertificate file: string: usa uma conexão TLS segura autenticada
+tla --anonymous-tls: usa uma conexão TLS segura sem certificado. senha da chave privada (somente com --enable-tls):
+ps --std-passwd: solicita que o usuário digite a senha na entrada padrão (padrão)
+pw --use-passwd [p]assword: string: usa a senha especificada
-pw --null-passwd: usa uma string vazia como senha. formato do arquivo de chave e certificado:
-pem --pem-keys: lê chaves e certificados como arquivo PEM (padrão)
-der --der-keys: lê chaves e certificados como arquivo DER. autoridade de certificação:
+cf --add-cert-file [f]ilename: string: adiciona um arquivo de certificado à lista de certificados
+cd --add-cert-dir [d]irectory: string: adiciona os certificados de d à lista de certificados
+crl --add-crl-file [f]ilename: string: adiciona um arquivo de lista de revogação de certificados (implica --enable-crl-vfy)
+crv --enable-crl-vfy: ativa a verificação de CRL do certificado folha
+cra --enable-crl-all: habilita a verificação de CRL de toda a cadeia perfil de segurança:
+ph --list-profiles: lista os perfis TLS com suporte e sai
+pg --profile-8996: Perfil TLS BCP 195 RFC 8996 (padrão)
+pm --profile-8996-mod: Perfil TLS BCP 195 RFC 8996 modificado # only available if underlying TLS library supports # all TLS features required for this profile
+py --profile-bcp195-nd: Perfil TLS BCP 195 sem downgrade (obsoleto)
+px --profile-bcp195: Perfil TLS BCP 195 (obsoleto)
+pz --profile-bcp195-ex: Perfil TLS BCP 195 estendido (obsoleto)
+pb --profile-basic: perfil básico de conexão de transporte seguro TLS (obsoleto) # disponível apenas se a biblioteca TLS subjacente oferecer suporte a 3DES
+pa --profile-aes: AES TLS Secure Transport Connection Profile (obsoleto)
+pn --profile-null: Comunicação autenticada não criptografada (retirada, era usada no IHE ATNA) conjunto de cifras:
+cc --list-ciphers: lista os conjuntos de cifras TLS com suporte e sai
+cs --cipher [c]iphersuite name: string: adiciona a conjunto de cifras à lista de suítes negociadas indicação de nome de servidor:
--no-sni: não usa SNI (padrão)
--request-sni [s]erver name: string: solicita o nome de servidor s. gerador pseudoaleatório:
+rs --seed [f]ilename: string: inicializa o gerador aleatório com o conteúdo de f
+ws --write-seed: grava novamente a semente modificada (somente com --seed)
+wf --write-seed-file [f]ilename: string (only with --seed): grava a semente modificada no arquivo f. autenticação do par:
-rc --require-peer-cert: verifica o certificado do par, falha se ausente (padrão)
-ic --ignore-peer-cert: não verifica o certificado do par

opções de saída

-od --output-directory [d]irectory: string (default: "."): grava os objetos recebidos no diretório existente d. modo de armazenamento:
-B --normal: recebe na memória e depois grava no disco (padrão)
+B --bit-preserving: recebe diretamente no disco
--ignore: ignora os dados de armazenamento, recebe mas não armazena

NOTAS

Cada arquivo informado na linha de comando é enviado ao SCP como parte de uma requisição C-GET. O arquivo de consulta deve ser um conjunto de dados DICOM válido contendo a parte do conjunto de dados de uma mensagem C-GET-RQ. O arquivo de consulta pode, por exemplo, ser criado com o utilitário dump2dcm a partir de um script como o exemplo a seguir:

# request all images for the patient with ID=PAT001
(0008,0052) CS [PATIENT]     # QueryRetrieveLevel
(0010,0020) LO [PAT001]      # PatientID

Outra possibilidade é usar a ferramenta dcmodify para criar um arquivo do zero usando a opção –create-file com chamadas sucessivas à opção –insert. Atributos individuais podem ser modificados ou complementados usando a opção -k (ou –key). Por exemplo, o comando:

getscu -k "0010,0020=PAT002" caesar 5678 patqry.dcm

ao ser enviado ao SCP caesar na porta TCP/IP 5678, faz com que qualquer atributo PatientID em patqry.dcm receba o valor 'PAT002'. Se esse atributo estiver presente, ele será substituído; se estiver ausente, será inserido. A opção -k pode aparecer mais de uma vez. A parte do valor (após o '=') pode ser omitida, fazendo com que o atributo seja enviado com comprimento zero. Também é possível especificar sequências, itens e atributos aninhados usando a opção -k. Nesses casos, é necessário usar uma notação especial de "caminho". Os detalhes podem ser encontrados na documentação do dcmodify.

Se nenhum arquivo for especificado na linha de comando, a consulta deve ser especificada completamente por meio de uma ou mais opções -k. Se vários arquivos de consulta forem fornecidos, o getscu enviará várias requisições C-GET ao SCP.

Problemas conhecidos

O getscu destina-se a ser usado como ferramenta de teste para desenvolvedores de software DICOM. O arquivo de chaves de consulta deve ser criado manualmente com base no conteúdo do SCP.

O C-GET não é compatível com todos os SCPs Query/Retrieve. O protocolo C-MOVE, implementado pela ferramenta movescu, é encontrado com mais frequência na prática.

O aplicativo getscu não tenta, de forma alguma, evitar consultas incorretas. Em particular, as chaves de consulta de uma requisição C-MOVE devem conter apenas o atributo QueryRetrieveLevel e um ou mais dos chamados "atributos de chave exclusiva" (PatientID, StudyInstanceUID, SeriesInstanceUID e SOPInstanceUID).

Conformidade DICOM

Conformidade SCU

O aplicativo getscu oferece suporte às seguintes classes SOP como SCU:

GETPatientRootQueryRetrieveInformationModel          1.2.840.10008.5.1.4.1.2.1.3
GETStudyRootQueryRetrieveInformationModel            1.2.840.10008.5.1.4.1.2.2.3
GETPatientStudyOnlyQueryRetrieveInformationModel     1.2.840.10008.5.1.4.1.2.3.3

O aplicativo getscu propõe contextos de apresentação para uma das classes SOP com suporte mencionadas acima, dependendo das opções de linha de comando (-P, -S ou -O). Para associações de saída, há suporte para as seguintes sintaxes de transferência:

LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
DeflatedExplicitVRLittleEndianTransferSyntax         1.2.840.10008.1.2.1.99 (*)
BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2

(*) se compilado com suporte a zlib habilitado (veja a saída de –version)

É possível especificar quais sintaxes de transferência são efetivamente propostas, e em que ordem, com as opções –propose.

Conformidade de armazenamento

O aplicativo getscu oferece suporte às seguintes classes SOP como SCP:

VerificationSOPClass                                 1.2.840.10008.1.1

RETIRED_StoredPrintStorage                           1.2.840.10008.5.1.1.27
RETIRED_HardcopyGrayscaleImageStorage                1.2.840.10008.5.1.1.29
RETIRED_HardcopyColorImageStorage                    1.2.840.10008.5.1.1.30
ComputedRadiographyImageStorage                      1.2.840.10008.5.1.4.1.1.1
DigitalXRayImageStorageForPresentation               1.2.840.10008.5.1.4.1.1.1.1
DigitalXRayImageStorageForProcessing                 1.2.840.10008.5.1.4.1.1.1.1.1
DigitalMammographyXRayImageStorageForPresentation    1.2.840.10008.5.1.4.1.1.1.2
DigitalMammographyXRayImageStorageForProcessing      1.2.840.10008.5.1.4.1.1.1.2.1
DigitalIntraOralXRayImageStorageForPresentation      1.2.840.10008.5.1.4.1.1.1.3
DigitalIntraOralXRayImageStorageForProcessing        1.2.840.10008.5.1.4.1.1.1.3.1
CTImageStorage                                       1.2.840.10008.5.1.4.1.1.2
EnhancedCTImageStorage                               1.2.840.10008.5.1.4.1.1.2.1
LegacyConvertedEnhancedCTImageStorage                1.2.840.10008.5.1.4.1.1.2.2
RETIRED_UltrasoundMultiframeImageStorage             1.2.840.10008.5.1.4.1.1.3
UltrasoundMultiframeImageStorage                     1.2.840.10008.5.1.4.1.1.3.1
MRImageStorage                                       1.2.840.10008.5.1.4.1.1.4
EnhancedMRImageStorage                               1.2.840.10008.5.1.4.1.1.4.1
MRSpectroscopyStorage                                1.2.840.10008.5.1.4.1.1.4.2
EnhancedMRColorImageStorage                          1.2.840.10008.5.1.4.1.1.4.3
LegacyConvertedEnhancedMRImageStorage                1.2.840.10008.5.1.4.1.1.4.4
RETIRED_NuclearMedicineImageStorage                  1.2.840.10008.5.1.4.1.1.5
RETIRED_UltrasoundImageStorage                       1.2.840.10008.5.1.4.1.1.6
UltrasoundImageStorage                               1.2.840.10008.5.1.4.1.1.6.1
EnhancedUSVolumeStorage                              1.2.840.10008.5.1.4.1.1.6.2
SecondaryCaptureImageStorage                         1.2.840.10008.5.1.4.1.1.7
MultiframeSingleBitSecondaryCaptureImageStorage      1.2.840.10008.5.1.4.1.1.7.1
MultiframeGrayscaleByteSecondaryCaptureImageStorage  1.2.840.10008.5.1.4.1.1.7.2
MultiframeGrayscaleWordSecondaryCaptureImageStorage  1.2.840.10008.5.1.4.1.1.7.3
MultiframeTrueColorSecondaryCaptureImageStorage      1.2.840.10008.5.1.4.1.1.7.4
RETIRED_StandaloneOverlayStorage                     1.2.840.10008.5.1.4.1.1.8
RETIRED_StandaloneCurveStorage                       1.2.840.10008.5.1.4.1.1.9
TwelveLeadECGWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.1.1
GeneralECGWaveformStorage                            1.2.840.10008.5.1.4.1.1.9.1.2
AmbulatoryECGWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.1.3
HemodynamicWaveformStorage                           1.2.840.10008.5.1.4.1.1.9.2.1
CardiacElectrophysiologyWaveformStorage              1.2.840.10008.5.1.4.1.1.9.3.1
BasicVoiceAudioWaveformStorage                       1.2.840.10008.5.1.4.1.1.9.4.1
GeneralAudioWaveformStorage                          1.2.840.10008.5.1.4.1.1.9.4.2
ArterialPulseWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.5.1
RespiratoryWaveformStorage                           1.2.840.10008.5.1.4.1.1.9.6.1
WaveformPresentationStateStorage                     1.2.840.10008.5.1.4.1.1.9.100.1
WaveformAcquisitionPresentationStateStorage          1.2.840.10008.5.1.4.1.1.9.100.2
RETIRED_StandaloneModalityLUTStorage                 1.2.840.10008.5.1.4.1.1.10
RETIRED_StandaloneVOILUTStorage                      1.2.840.10008.5.1.4.1.1.11
GrayscaleSoftcopyPresentationStateStorage            1.2.840.10008.5.1.4.1.1.11.1
ColorSoftcopyPresentationStateStorage                1.2.840.10008.5.1.4.1.1.11.2
PseudoColorSoftcopyPresentationStateStorage          1.2.840.10008.5.1.4.1.1.11.3
BlendingSoftcopyPresentationStateStorage             1.2.840.10008.5.1.4.1.1.11.4
XAXRFGrayscaleSoftcopyPresentationStateStorage       1.2.840.10008.5.1.4.1.1.11.5
XRayAngiographicImageStorage                         1.2.840.10008.5.1.4.1.1.12.1
EnhancedXAImageStorage                               1.2.840.10008.5.1.4.1.1.12.1.1
XRayRadiofluoroscopicImageStorage                    1.2.840.10008.5.1.4.1.1.12.2
EnhancedXRFImageStorage                              1.2.840.10008.5.1.4.1.1.12.2.1
RETIRED_XRayAngiographicBiPlaneImageStorage          1.2.840.10008.5.1.4.1.1.12.3
XRay3DAngiographicImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.1
XRay3DCraniofacialImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.2
BreastTomosynthesisImageStorage                      1.2.840.10008.5.1.4.1.1.13.1.3
IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
IntravascularOpt.Coh.Tom.ImageStorageForProcessing   1.2.840.10008.5.1.4.1.1.14.2
NuclearMedicineImageStorage                          1.2.840.10008.5.1.4.1.1.20
RawDataStorage                                       1.2.840.10008.5.1.4.1.1.66
SpatialRegistrationStorage                           1.2.840.10008.5.1.4.1.1.66.1
SpatialFiducialsStorage                              1.2.840.10008.5.1.4.1.1.66.2
DeformableSpatialRegistrationStorage                 1.2.840.10008.5.1.4.1.1.66.3
SegmentationStorage                                  1.2.840.10008.5.1.4.1.1.66.4
SurfaceSegmentationStorage                           1.2.840.10008.5.1.4.1.1.66.5
RealWorldValueMappingStorage                         1.2.840.10008.5.1.4.1.1.67
SurfaceScanMeshStorage                               1.2.840.10008.5.1.4.1.1.68.1
SurfaceScanPointCloudStorage                         1.2.840.10008.5.1.4.1.1.68.2
RETIRED_VLImageStorage                               1.2.840.10008.5.1.4.1.1.77.1
VLEndoscopicImageStorage                             1.2.840.10008.5.1.4.1.1.77.1.1
VideoEndoscopicImageStorage                          1.2.840.10008.5.1.4.1.1.77.1.1.1
VLMicroscopicImageStorage                            1.2.840.10008.5.1.4.1.1.77.1.2
VideoMicroscopicImageStorage                         1.2.840.10008.5.1.4.1.1.77.1.2.1
VLSlideCoordinatesMicroscopicImageStorage            1.2.840.10008.5.1.4.1.1.77.1.3
VLPhotographicImageStorage                           1.2.840.10008.5.1.4.1.1.77.1.4
VideoPhotographicImageStorage                        1.2.840.10008.5.1.4.1.1.77.1.4.1
OphthalmicPhotography8BitImageStorage                1.2.840.10008.5.1.4.1.1.77.1.5.1
OphthalmicPhotography16BitImageStorage               1.2.840.10008.5.1.4.1.1.77.1.5.2
StereometricRelationshipStorage                      1.2.840.10008.5.1.4.1.1.77.1.5.3
OphthalmicTomographyImageStorage                     1.2.840.10008.5.1.4.1.1.77.1.5.4
VLWholeSlideMicroscopyImageStorage                   1.2.840.10008.5.1.4.1.1.77.1.6
RETIRED_VLMultiframeImageStorage                     1.2.840.10008.5.1.4.1.1.77.2
LensometryMeasurementsStorage                        1.2.840.10008.5.1.4.1.1.78.1
AutorefractionMeasurementsStorage                    1.2.840.10008.5.1.4.1.1.78.2
KeratometryMeasurementsStorage                       1.2.840.10008.5.1.4.1.1.78.3
SubjectiveRefractionMeasurementsStorage              1.2.840.10008.5.1.4.1.1.78.4
VisualAcuityMeasurementsStorage                      1.2.840.10008.5.1.4.1.1.78.5
SpectaclePrescriptionReportStorage                   1.2.840.10008.5.1.4.1.1.78.6
OphthalmicAxialMeasurementsStorage                   1.2.840.10008.5.1.4.1.1.78.7
IntraocularLensCalculationsStorage                   1.2.840.10008.5.1.4.1.1.78.8
MacularGridThicknessAndVolumeReportStorage           1.2.840.10008.5.1.4.1.1.79.1
OphthalmicVisualFieldStaticPerimetryMeasurementsSt.  1.2.840.10008.5.1.4.1.1.80.1
OphthalmicThicknessMapStorage                        1.2.840.10008.5.1.4.1.1.81.1
BasicTextSRStorage                                   1.2.840.10008.5.1.4.1.1.88.11
EnhancedSRStorage                                    1.2.840.10008.5.1.4.1.1.88.22
ComprehensiveSRStorage                               1.2.840.10008.5.1.4.1.1.88.33
Comprehensive3DSRStorage                             1.2.840.10008.5.1.4.1.1.88.34
ProcedureLogStorage                                  1.2.840.10008.5.1.4.1.1.88.40
MammographyCADSRStorage                              1.2.840.10008.5.1.4.1.1.88.50
KeyObjectSelectionDocumentStorage                    1.2.840.10008.5.1.4.1.1.88.59
ChestCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.65
XRayRadiationDoseSRStorage                           1.2.840.10008.5.1.4.1.1.88.67
ColonCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.69
ImplantationPlanSRStorage                            1.2.840.10008.5.1.4.1.1.88.70
EncapsulatedPDFStorage                               1.2.840.10008.5.1.4.1.1.104.1
EncapsulatedCDAStorage                               1.2.840.10008.5.1.4.1.1.104.2
PositronEmissionTomographyImageStorage               1.2.840.10008.5.1.4.1.1.128
LegacyConvertedEnhancedPETImageStorage               1.2.840.10008.5.1.4.1.1.128.1
RETIRED_StandalonePETCurveStorage                    1.2.840.10008.5.1.4.1.1.129
EnhancedPETImageStorage                              1.2.840.10008.5.1.4.1.1.130
BasicStructuredDisplayStorage                        1.2.840.10008.5.1.4.1.1.131
RTImageStorage                                       1.2.840.10008.5.1.4.1.1.481.1
RTDoseStorage                                        1.2.840.10008.5.1.4.1.1.481.2
RTStructureSetStorage                                1.2.840.10008.5.1.4.1.1.481.3
RTBeamsTreatmentRecordStorage                        1.2.840.10008.5.1.4.1.1.481.4
RTPlanStorage                                        1.2.840.10008.5.1.4.1.1.481.5
RTBrachyTreatmentRecordStorage                       1.2.840.10008.5.1.4.1.1.481.6
RTTreatmentSummaryRecordStorage                      1.2.840.10008.5.1.4.1.1.481.7
RTIonPlanStorage                                     1.2.840.10008.5.1.4.1.1.481.8
RTIonBeamsTreatmentRecordStorage                     1.2.840.10008.5.1.4.1.1.481.9
RTBeamsDeliveryInstructionStorage                    1.2.840.10008.5.1.4.34.7

O aplicativo getscu geralmente aceita contextos de apresentação para todas as classes SOP com suporte mencionadas acima, usando qualquer uma das seguintes sintaxes de transferência:

LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2

Ao atuar como um SCP de armazenamento, o aplicativo getscu prefere sintaxes de transferência com codificação explícita em vez da sintaxe de transferência implícita padrão. Se o getscu estiver sendo executado em hardware big-endian, ele preferirá a sintaxe de transferência BigEndianExplicit em vez de LittleEndianExplicit (e vice-versa). Esse comportamento pode ser alterado com as opções –prefer (veja acima). Dependendo da opção –prefer efetivamente usada, há suporte a uma combinação das seguintes sintaxes de transferência:

LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
DeflatedExplicitVRLittleEndianTransferSyntax         1.2.840.10008.1.2.1.99 (*)
BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2
JPEGProcess1TransferSyntax                           1.2.840.10008.1.2.4.50
JPEGProcess2_4TransferSyntax                         1.2.840.10008.1.2.4.51
JPEGProcess14SV1TransferSyntax                       1.2.840.10008.1.2.4.70
JPEGLSLosslessTransferSyntax                         1.2.840.10008.1.2.4.80
JPEGLSLossyTransferSyntax                            1.2.840.10008.1.2.4.81
JPEG2000LosslessOnlyTransferSyntax                   1.2.840.10008.1.2.4.90
JPEG2000TransferSyntax                               1.2.840.10008.1.2.4.91
MPEG2MainProfileAtMainLevelTransferSyntax            1.2.840.10008.1.2.4.100
MPEG2MainProfileAtHighLevelTransferSyntax            1.2.840.10008.1.2.4.101
MPEG4HighProfileLevel4_1TransferSyntax               1.2.840.10008.1.2.4.102
MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax   1.2.840.10008.1.2.4.103
MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax    1.2.840.10008.1.2.4.104
MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax    1.2.840.10008.1.2.4.105
MPEG4StereoHighProfileLevel4_2TransferSyntax         1.2.840.10008.1.2.4.106
HEVCMainProfileLevel5_1TransferSyntax                1.2.840.10008.1.2.4.107
HEVCMain10ProfileLevel5_1TransferSyntax              1.2.840.10008.1.2.4.108
RLELosslessTransferSyntax                            1.2.840.10008.1.2.5

(*) se compilado com suporte a zlib habilitado (veja a saída de –version)

O aplicativo getscu não oferece suporte à negociação estendida.

EXEMPLOS

getscu --patient --call ARCHIVE caesar 104 q.dcm

envia os atributos contidos no arquivo DICOM "q.dcm" como parte de uma requisição C-GET para a entidade de aplicação ARCHIVE no host caesar na porta 104, usando o modelo de consulta Patient Root. O próprio getscu usa o AE Title padrão GETSCU.

Ao contrário das classes SOP Query/Retrieve baseadas em C-MOVE, as classes SOP baseadas em C-GET utilizadas pelo getscu só permitem recuperar os objetos desejados na mesma conexão, ou seja, o próprio getscu recebe os objetos. Portanto, não é possível instruir o SCP a transmitir os objetos a terceiros. Trata-se de uma limitação do protocolo DICOM, e não da ferramenta getscu.

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

VEJA TAMBÉM

findscu(1), movescu(1), dump2dcm(1), dcmodify(1)