gdcmscu - Daring di Awan

PROGRAM:

NAMA

gdcmscu - Alat untuk menjalankan operasi Permintaan/Pengambilan DICOM

RINGKASAN

gdcmscu [OPSI]...[OPERASI]...HOSTNAME...[PORT]...

Jalankan operasi Q/R DICOM ke HOSTNAME, menggunakan port PORT (104 bila tidak ditentukan)

DESKRIPSI

The gdcmscu program baris perintah adalah alat untuk menjalankan operasi Query/Retrieve DICOM. Dia
mendukung:

· C-ECHO (SCU)

· C-TEMUKAN (SCU)

· C-TOKO (SCU)

· C-MOVE (SCU/SCP) Operasi C-MOVE dijalankan menggunakan dua port yang berbeda (satu untuk
SCU dan satu untuk SCP).

PARAMETER

PILIHAN

tertentu Pilihan
-H --nama host %s Nama host.
-p --port %d Nomor port.
--aetitle %s Setel pemanggilan Judul AE.
--call %s Setel yang disebut Judul AE.

mode Pilihan
--echo C-ECHO (default jika tidak ada).
--toko C-STORE.
--menemukan C-MENEMUKAN.
--pindah C-MOVE.

C-TOKO Pilihan
-i --input %s nama file DICOM
-r --rekursif proses rekursif (sub-)direktori
--store-query %s Simpan kueri yang dibuat dalam file

C-CARI/C-PINDAHKAN Pilihan
--patientroot C-FIND Model Root Pasien.
--studyroot C-FIND Model Akar Studi.

--patient C-FIND Query pada Info Pasien (tidak dapat digunakan dengan --studyroot).
--study C-FIND Query pada Info Studi.
--series C-FIND Query pada Info Seri.
--image C-FIND Query pada Info Gambar.
--key %d,%d[=%s] 0123,4567=VALUE untuk menentukan kriteria pencarian (wildcard diizinkan)
Dengan --key, biarkan kosong (yaitu, --key 10,20="" atau --key 10,20) untuk mengambil nilai

C-PINDAHKAN Pilihan
-o --output %s nama file / direktori DICOM
--port-scp %d Port untuk asosiasi yang masuk
--key %d,%d[=%s 0123,4567=VALUE untuk menentukan kriteria pencarian (karakter pengganti tidak diizinkan)
Perhatikan bahwa C-MOVE mendukung kueri yang sama dengan C-FIND, tetapi tidak ada wildcard yang diizinkan

umum Pilihan
-h --bantuan
cetak teks bantuan ini dan keluar

-v --versi
informasi versi cetak dan keluar

-V --verbose
mode verbose (peringatan + kesalahan).

-W --peringatan
mode peringatan, cetak informasi peringatan

-E --kesalahan
mode kesalahan, informasi kesalahan cetak

-D --debug
mode debug, cetak informasi debug

-L --file-log
tentukan nama file tempat menulis log

--membantu permintaan
bantuan kueri cetak

lingkungan Hidup variabel
GDCM_ROOT_UID UID Akar

C-GEMA PENGGUNAAN

gdcmscu adalah alat yang hebat untuk menguji apakah server DICOM aktif. Misalnya untuk mengirim C-ECHO ke
server dicom.example.com menggunakan port 104, gunakan:

$gdcmscu dicom.example.com

atau jika Anda lebih suka eksplisit:

$ gdcmscu --echo dicom.example.com 104

Menggunakan keamanan dasar, server DICOM Anda mungkin mengharuskan Anda mengatur yang sesuai yang disebut
JUDUL AE

$ gdcmscu --echo dicom.example.com 11112 --panggil SERVSCP

Jika Anda ingin menentukan AE-TITLE Anda sendiri (defaultnya adalah GDCMSCU), cukup gunakan:

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

Misalnya Anda dapat menguji di server DICOM yang disediakan oleh tim DICOMObject:

$gdcmscu www.dicomserver.co.uk 11112

C-TOKO PENGGUNAAN

C-STORE adalah operasi yang memungkinkan pengiriman file DICOM ke server DICOM jarak jauh. Untuk
contoh untuk mengirim file bernama myfile.dcm

$ gdcmscu --store dicom.example.com 104 file saya.dcm

atau jika Anda lebih suka eksplisit:

$ gdcmscu --store dicom.example.com 104 -i file saya.dcm

Anda bahkan dapat mengirim banyak file menggunakan asosiasi yang sama:

$ gdcmscu --store dicom.example.com 104 filesaya1.dcm filesaya2.dcm filesaya3.dcm ...

C-MENEMUKAN PENGGUNAAN

gdcmscu juga memungkinkan permintaan server DICOM. Ini adalah operasi C-FIND, misalnya untuk
temukan semua Instance DICOM di mana PatientName cocok dengan pola tertentu, penggunaannya sederhana:

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

Kami juga mendukung konvensi yang kompatibel dengan DCMTK:

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

Ketika sebuah atribut disetel tanpa nilai, itu akan menjadi bagian dari hasil keluaran:

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

C-PINDAHKAN PENGGUNAAN

C-MOVE adalah operasi untuk mengambil instans DICOM dari server DICOM jarak jauh. Kebanyakan
waktu, itu adalah operasi berikutnya setelah permintaan C-FIND. Untuk mengambil instans DICOM
di mana PatientID adalah ABCD1234, cukup jalankan:

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

PERINGATAN Agar operasi ini berfungsi, Anda memerlukan informasi dari server DICOM Anda
berkomunikasi dengan. Hanya server DICOM yang Anda kirimi permintaan C-MOVE yang akan
bertanggung jawab untuk mengirim kembali asosiasi yang masuk (C-STORE SCP yang sebenarnya). Oleh karena itu kamu
perlu memastikan bahwa pemetaan Anda (AE-TITLE,PortNumber) diatur dengan benar pada DICOM
sisi server serta port untuk asosiasi masuk (–port-scp).

gdcmscu saat ini tidak mendukung asosiasi C-STORE eksternal (permintaan C-STORE dikirim ke
aplikasi SCP eksternal).

AKAR PASIEN CATATAN

Bendera –patientroot hanyalah pembungkus sintaks –key 8,52=PATIENT For
misalnya seseorang akan menulis menggunakan sintaks DCMTK:

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

Ini akan menjadi menggunakan sintaks GDCM:

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

DEBUGING

Terkadang sulit untuk menyelidiki mengapa koneksi ke server DICOM jarak jauh tidak dapat
dilakukan. Beberapa rekomendasi berikut:

Selalu mencoba untuk melakukan C-ECHO sederhana pada awalnya. Jika Anda tidak dapat membuat C-ECHO berfungsi, tidak ada satu pun dari
operasi lainnya akan berhasil

Sebelum mencoba operasi C-MOVE, pastikan Anda dapat menjalankan kueri yang setara dengan C-FIND
pertama.

Saat melakukan operasi C-MOVE Anda benar-benar perlu berkomunikasi dengan admin PACS sebagai
Operasi C-MOVE berbeda dari operasi level bawah lainnya seperti HTTP/GET. Kapan
melakukan C-MOVE, server akan berkomunikasi kembali menggunakan saluran lain (bisa berbeda
port) menggunakan database internalnya untuk memetakan AE-TITLE kembali ke IP tujuan.

Memang operasi C-MOVE dengan desain tidak selalu menggunakan alamat IP masuk Anda untuk mengirim
kembali dataset yang dihasilkan. Alih-alih menggunakan pemetaan AE-TITLE ke alamat IP untuk mengirim
kembali hasil apa pun. Jadi, berikan perhatian khusus pada ejaan AE-TITLE Anda dan
port masuk (yang mungkin berbeda dari port untuk terhubung ke server).

PORT PERINGATAN

Hati-hati bahwa rentang port [1-1024] dicadangkan untuk admin dan tidak mudah diakses
kecuali diberikan hak istimewa. Oleh karena itu port DICOM 104 default mungkin tidak
dapat diakses oleh semua pengguna Anda.

C-TOKO PERINGATAN

Saat membuat operasi C-STORE, gdcmscu akan selalu menggunakan Kelas SOP Penyimpanan Media
UID seperti yang terdapat pada file yang akan dikirim. Untuk file DICOM yang dienkapsulasi (mis. RLE Lossless)
menerima server SCP mungkin tidak mendukung kompresi ini dan akan secara sah menolak
Operasi C-STORE. Dalam hal ini pengguna harus secara manual mengonversi ke formulir yang tidak terkompresi
file khusus ini:

$ gdcmconv --raw compress.dcm non_compressed.dcm

C-PINDAHKAN PERINGATAN

Saat ini gdcmscu hanya mendukung sintaks transfer yang tidak terkompresi. Itu akan selalu meminta
DataSet menggunakan Sintaks Transfer Little Endian VR Implicit selama operasi C-MOVE (keduanya
asosiasi masuk dan keluar). Ini membuat gdcmscu –move setara dengan DCMTK movecu
sintaksis:

$ movecu -xi +xi ...

C-MENEMUKAN IMAGE TINGKAT (GABUNGAN OBYEK CONTOH)

Kita harus memperhatikan bahwa gdcmscu –find dan findscu tidak sepenuhnya setara.
Menggunakan gdcmscu –find, semua Unique Keys akan ditambahkan secara otomatis. Oleh karena itu, seseorang dapat
jalankan sesuatu seperti ini:

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

alih-alih bentuk yang lebih eksplisit

$ 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

Ini juga akan setara dengan:

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

MENYIMPAN THE PERTANYAAN

Dimungkinkan juga untuk menyimpan kueri:

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

Seseorang kemudian dapat memeriksa nilai DataSet yang dikirim untuk kueri:

$ gdcmdump kueri.dcm
# Format File Dicom

# Dicom-Meta-Informasi-Header
# Digunakan TransferSyntax:

# Kumpulan Data-Dicom
# Sintaks Transfer yang Digunakan: 1.2.840.10008.1.2
(0008,0005) ?? (CS) [ISO_IR 192] # 10,1-n ​​Kumpulan Karakter Khusus
(0008,0052) ?? (CS) [PASIEN ] #8,1 Query/Retrieve Level
(0010,0010) ?? (PN) (tidak ada nilai) #0,1 Nama Pasien
(0010,0020) ?? (LO) [* ] # 2,1 ID Pasien

Kumpulan Karakter Khusus diatur ke "ISO_IR 192" sebagai pengkodean lokal sistem
ditemukan secara otomatis oleh gdcmscu sebagai UTF-8.

Ini berarti bahwa baris perintah berikut akan mengatur Query dengan benar dengan
Charset yang sesuai untuk dieksekusi dengan benar:

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

Kueri selalu dieksekusi di sisi server (SCP), beberapa implementasi tidak
mendukung pencocokan string dengan Set Karakter yang berbeda.

DIKOM PUBLIK SERVER

Daftar terbaru dari Server Publik DICOM dapat ditemukan di:

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

Gunakan gdcmscu online menggunakan layanan onworks.net