dcmsend - Dalam talian dalam Awan

JADUAL:

NAMA

dcmsend - SCU storan DICOM ringkas (penghantar)

SINOPSIS

dcmsend [pilihan] peer port dcmfile-in...

DESCRIPTION

. dcmsend aplikasi melaksanakan Pengguna Kelas Perkhidmatan (SCU) untuk Perkhidmatan Storan
Kelas. Berbeza dengan yang terkenal storescu utiliti, dcmsend mempunyai kurang pilihan dan adalah,
oleh itu, lebih mudah untuk digunakan - ini juga menerangkan istilah 'mudah' dalam tajuk. Yang utama
tujuan aplikasi ini adalah untuk menghantar sejumlah besar fail DICOM ke Perkhidmatan Storan
Pembekal Kelas (SCP). dcmsend menyokong kedua-dua persatuan berbilang (satu demi satu)
dan penyahmampatan kejadian DICOM SOP jika perlu untuk memindahkannya.

PARAMETER

nama hos rakan sebaya bagi rakan sebaya DICOM

port tcp/ip nombor port rakan sebaya

dcmfile-in fail DICOM atau direktori untuk dihantar

PILIHAN

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

--versi
maklumat versi cetakan dan keluar

--senarai-penyahkod
senaraikan sintaks pemindahan penyahkod dan keluar

--hujah
cetak argumen baris perintah yang dikembangkan

-q --senyap
mod senyap, tiada cetak amaran dan ralat

-v --verbose
mod verbose, butiran pemprosesan cetakan

-d --debug
mod nyahpepijat, cetak maklumat nyahpepijat

-ll --log-level [l]evel: pemalar rentetan
(maut, ralat, amaran, maklumat, nyahpepijat, jejak)
gunakan tahap l untuk pembalak

-lc --log-config [f]ilename: string
gunakan fail konfigurasi f untuk pembalak

+v --verbose-pc
tunjukkan konteks persembahan dalam mod verbose

input pilihan
format fail input:

+f --read-file
baca format fail atau set data

+fo --baca-fail-sahaja
baca format fail sahaja (lalai)

-f --baca-set data
baca set data tanpa maklumat meta fail

fail input:

+rd --read-from-dicomdir
baca maklumat pada fail input daripada DICOMDIR

+sd --scan-direktori
imbas direktori untuk fail input (dcmfile-in)

+sp --scan-pattern [p]attern: rentetan (hanya dengan --scan-directories)
corak untuk padanan nama fail (kad liar)

# mungkin tidak tersedia pada semua sistem

-r --tidak-berulang
jangan berulang dalam direktori (lalai)

+r --recurse
berulang dalam direktori tertentu

pemprosesan pilihan
pemindahan penukaran sintaks:

-dn --nyahmampat-tidak pernah
jangan sekali-kali menyahmampat set data termampat

+dls --nyahmampat-tak rugi
hanya nyahmampatkan pemampatan tanpa kehilangan (lalai)

+dly --decompress-lossy
nyahmampat kedua-dua mampatan lossy dan lossless

mengempiskan tahap mampatan:

+cl --compression-level [l]evel: integer (lalai: 6)
0=tidak dimampatkan, 1=terpantas, 9=mampatan terbaik

pilihan pemprosesan lain:

-nh --tidak berhenti
jangan berhenti pada fail input tidak sah pertama
atau jika kedai tidak berjaya ditemui

-nip --tiada-cadangan-haram
jangan cadangkan sebarang konteks pembentangan yang demikian
tidak mengandungi sintaks pemindahan lalai (jika perlu)

-nuc --tiada-uid-checks
jangan semak nilai UID fail input

rangkaian pilihan
tajuk entiti permohonan:

-aet --aetitle [a]etitle: rentetan
tetapkan tajuk AE panggilan saya (lalai: DCMSEND)

-aec --call [a]etitle: string
set dipanggil tajuk AE rakan sebaya (lalai: ANY-SCP)

pengendalian persatuan:

+ma --berbilang persatuan
gunakan berbilang persatuan (satu demi satu)
jika perlu untuk memindahkan kejadian (lalai)

-ma --persatuan-tunggal
sentiasa menggunakan persatuan tunggal

pilihan rangkaian lain:

-ke --masa tamat [s]ekon: integer (lalai: tidak terhad)
tamat masa untuk permintaan sambungan

-ta --acse-timeout [s]ekon: integer (lalai: 30)
tamat masa untuk mesej ACSE

-td --dimse-timeout [s]ekon: integer (lalai: tidak terhad)
tamat masa untuk mesej DIMSE

-pdu --max-pdu [n]bilangan bait: integer (4096..131072)
tetapkan maks terima pdu kepada n bait (lalai: 16384)

--max-send-pdu [n]bilangan bait: integer (4096..131072)
hadkan maks hantar pdu kepada n bait

output pilihan
umum:

+crf --create-report-file [f]ilename: string
buat laporan terperinci mengenai pemindahan
(jika berjaya) dan tulis pada fail teks f

NOTA

Tipikal Penggunaan
Kes penggunaan biasa bagi dcmsend adalah untuk menghantar contoh SOP sewenang-wenangnya yang disimpan sebagai DICOM
fail ke SCP storan. Perintah berikut melakukan ini dengan tepat:

dcmsend --verbose *.dcm

Jika fail DICOM disimpan dalam hierarki direktori di bawah direktori 'IMAGES',
arahan berikut boleh digunakan:

dcmsend -v --scan-directories --recurse IMAGES

Ia juga mungkin untuk menentukan berbilang direktori dan untuk menggabungkan yang disebutkan di atas
pendekatan (menggunakan kedua-dua nama fail dan direktori):

dcmsend -v +sd +r IMAGES_1 IMAGES_2 ujian.img *.dcm

Jika kejadian SOP dirujuk daripada fail DICOMDIR, pilihan --baca-dari-dicomdir (Atau
+rd) boleh digunakan untuk menghantar semua fail DICOM yang dirujuk tanpa memuatkannya untuk
rundingan persatuan:

dcmsend -v --baca-dari-dicomdir DICOMDIR

Dan sekali lagi, semua pendekatan di atas boleh digabungkan seperti ini:

dcmsend -v +sd +r +rd IMAGES_1 IMAGES_2 ujian.img DICOMDIR *.dcm

Pilihan lalai --baca-fail-sahaja memastikan bahawa hanya fail DICOM (iaitu fail dengan
pengepala meta dan kata ajaib 'DICM' selepas mukadimah) diproses. Biasanya, jika
memproses sejumlah besar fail, ia juga merupakan idea yang baik untuk tidak berhenti pada yang pertama tidak sah
fail input atau jika kedai yang tidak berjaya ditemui. Ini boleh dicapai dengan menggunakan
pilihan --tidak-berhenti. Walau bagaimanapun, sila ambil perhatian bahawa 'kedai yang tidak berjaya' tidak bermakna bahawa
Status DIMSE bagi respons C-STORE menunjukkan ralat. Ini bermakna permintaan C-STORE
tidak dapat dihantar ke SCP storan.

Jika lebih daripada 128 konteks pembentangan diperlukan, iaitu bilangan maksimum yang dibenarkan
mengikut piawaian DICOM, persatuan baru dimulakan selepas yang sebelumnya telah
telah selesai. Dalam kes di mana tingkah laku ini tidak diingini, ia boleh dilumpuhkan menggunakan pilihan
--persatuan-tunggal. Di samping itu, sama ada set data mampat tanpa kerugian sahaja
dinyahmampat (jika perlu), yang merupakan lalai, atau juga set data mampat lossy boleh
ditentukan menggunakan --nyahmampat-xxx pilihan.

Untuk mendapatkan kedua-dua gambaran keseluruhan dan maklumat terperinci mengenai pemindahan SOP DICOM
contoh, pilihan --buat-laporan-fail boleh digunakan untuk mencipta fail teks yang sepadan.
Walau bagaimanapun, fail ini hanya dibuat sebagai langkah terakhir jika permohonan tidak ditamatkan
sebelumnya (dengan ralat).

Mengimbas Direktori
Menambah direktori sebagai parameter pada baris arahan hanya masuk akal jika pilihan --imbas-
direktori juga diberikan. Jika fail dalam direktori yang disediakan harus dipilih
mengikut corak nama tertentu (cth menggunakan padanan kad bebas), pilihan --imbasan-corak
terpaksa digunakan. Sila ambil perhatian bahawa corak fail ini hanya digunakan pada fail dalam
direktori yang diimbas, dan, jika mana-mana corak lain dinyatakan pada baris arahan di luar
yang --imbasan-corak pilihan (cth untuk memilih fail selanjutnya), ini tidak terpakai untuk
direktori yang ditentukan.

Oleh itu, contoh ketiga di atas akan berulang ke atas direktori IMAGES_1 dan IMAGES_2
dan menghantar fail yang terkandung dalam kedua-dua folder ini dan semua subfoldernya (kerana
kepada pilihan +r). Selain itu, dcmsend akan memindahkan 'test.img' dan semua fail dengan sambungan
'dcm' daripada folder kerja semasa. Ambil perhatian bahawa menyediakan nama direktori tanpa
pilihan yang membolehkan +sd tak masuk akal.

DICOM Kesesuaian
Pada asasnya, dcmsend aplikasi menyokong semua Kelas SOP Storan sebagai SCU, termasuk
yang persendirian. Secara lalai, aplikasi menyemak UID Kelas SOP bagi fail DICOM masuk
untuk memastikan bahawa hanya contoh SOP yang sah dihantar. Dengan pilihan --tiada-uid-cek
semakan ini boleh dilumpuhkan.

. dcmsend aplikasi juga menyokong semua Sintaks Pemindahan yang ditakrifkan dalam DICOM
standard. Sintaks pemindahan peribadi hanya boleh digunakan jika semakan UID dilumpuhkan dengan
pilihan --tiada-uid-cek. Sila ambil perhatian, bagaimanapun, bahawa hanya bilangan pemindahan yang terhad
sintaks disokong untuk menukarnya kepada sintaks pemindahan lalai (VR Tersirat
Endian kecil). Dengan pilihan --senarai-penyahkod sintaks pemindahan yang disokong secara asli atau oleh
dekoder disenaraikan. Output biasanya kelihatan seperti berikut:

Pindahkan sintaks disokong secara asli:
- Endian Kecil Tersirat
- Eksplisit Endian Kecil
- Eksplisit Endian Besar

Pindahkan sintaks yang disokong oleh penyahkod:
- Kempis Eksplisit VR Little Endian
- Garis Dasar JPEG
- JPEG Dilanjutkan, Proses 2+4
- Pemilihan Spektrum JPEG, Bukan hierarki, Proses 6+8
- JPEG Kemajuan Penuh, Bukan hierarki, Proses 10+12
- JPEG Lossless, Bukan hierarki, Proses 14
- JPEG Lossless, Bukan hierarki, Ramalan Pesanan Pertama
- JPEG-LS Tanpa Rugi
- JPEG-LS Lossy (Hampir-rugi)
- RLE Tanpa Rugi

Sejak dcmsend cuba semudah mungkin untuk pengguna, secara persembahan lalai
konteks mungkin dicadangkan kepada SCP yang secara tegas bercakap 'haram'. Ini adalah
kerana, mengikut piawaian DICOM, SCU sentiasa perlu mencadangkan lalai
pindahkan sintaks dalam sekurang-kurangnya satu konteks pembentangan yang dikaitkan dengan setiap sintaks abstrak
(iaitu kelas SOP). Keperluan ini diketepikan apabila SCU hanya mempunyai akses kepada SOP
contoh dalam bentuk mampat lossy. Dengan pilihan --tiada-cadangan-haram DICOM yang ketat-
tingkah laku konforman boleh dikuatkuasakan, iaitu tiada kemungkinan konteks persembahan yang menyalahi undang-undang
dicadangkan tetapi contoh SOP yang sepadan akan ditolak (jika perlu).

Sila ambil perhatian, bagaimanapun, bahawa sintaks pemindahan lalai untuk 'Mampatan JPEG Tanpa Kehilangan',
'Lossy JPEG Compression' dan sebagainya tidak selalu dicadangkan seperti yang dikehendaki oleh DICOM
standard. Had yang sama digunakan untuk skim mampatan lain. Lihat DICOM PS 3.5
seksyen 10 untuk butiran.

MASUK

Tahap output pengelogan pelbagai alatan baris arahan dan perpustakaan asas boleh
ditentukan oleh pengguna. Secara lalai, hanya ralat dan amaran ditulis kepada standard
aliran ralat. Menggunakan pilihan --verbose juga mesej maklumat seperti butiran pemprosesan
dilaporkan. Pilihan --nyahpepijat boleh digunakan untuk mendapatkan butiran lanjut tentang aktiviti dalaman,
cth untuk tujuan penyahpepijatan. Tahap pembalakan lain boleh dipilih menggunakan pilihan --log-
tahap. dalam --senyap mod hanya ralat maut dilaporkan. Dalam kejadian ralat yang sangat teruk,
permohonan biasanya akan ditamatkan. Untuk butiran lanjut tentang tahap pembalakan yang berbeza,
lihat dokumentasi modul 'oflog'.

Sekiranya output pembalakan harus ditulis ke fail (sebagai pilihan dengan putaran fail log),
kepada syslog (Unix) atau pilihan log peristiwa (Windows). --log-config boleh digunakan. ini
fail konfigurasi juga membenarkan untuk mengarahkan hanya mesej tertentu ke output tertentu
strim dan untuk menapis mesej tertentu berdasarkan modul atau aplikasi di mana ia
dijana. Contoh fail konfigurasi disediakan dalam /logger.cfg.

COMMAND LINE

Semua alatan baris arahan menggunakan tatatanda berikut untuk parameter: kurungan segi empat sama sertakan
nilai pilihan (0-1), tiga titik mengekor menunjukkan bahawa berbilang nilai dibenarkan
(1-n), gabungan kedua-duanya bermakna 0 hingga n nilai.

Pilihan baris arahan dibezakan daripada parameter dengan tanda '+' atau '-' terkemuka,
masing-masing. Biasanya, susunan dan kedudukan pilihan baris arahan adalah sewenang-wenangnya (iaitu mereka
boleh muncul di mana-mana). Walau bagaimanapun, jika pilihan adalah saling eksklusif penampilan paling kanan
digunakan. Tingkah laku ini mematuhi peraturan penilaian standard cengkerang Unix biasa.

Selain itu, satu atau lebih fail arahan boleh ditentukan menggunakan tanda '@' sebagai awalan kepada
nama fail (cth @command.txt). Hujah arahan sedemikian digantikan dengan kandungan
fail teks yang sepadan (berbilang ruang putih dianggap sebagai pemisah tunggal melainkan
ia muncul di antara dua tanda petikan) sebelum sebarang penilaian selanjutnya. Sila ambil perhatian bahawa
fail arahan tidak boleh mengandungi fail arahan lain. Pendekatan yang mudah tetapi berkesan ini
membolehkan seseorang meringkaskan gabungan biasa pilihan/parameter dan mengelakkan longish dan
baris arahan yang mengelirukan (contoh disediakan dalam fail /dumppat.txt).

EXIT KOD

. dcmsend utiliti menggunakan kod keluar berikut apabila menamatkan. Ini membolehkan pengguna
untuk menyemak sebab permohonan ditamatkan.

umum
EXITCODE_NO_ERROR 0
EXITCODE_COMMANDLINE_SYNTAX_ERROR 1

input fail kesilapan
EXITCODE_NOT_READ_INPUT_FILE 20 (*)
EXITCODE_NO_INPUT_FILES 21
EXITCODE_INVALID_INPUT_FILE 22
EXITCODE_NO_VALID_INPUT_FILES 23

output fail kesilapan
EXITCODE_NOT_WRITE_OUTPUT_FILE 40 (*)
EXITCODE_NOT_WRITE_REPORT_FILE 43

rangkaian kesilapan
EXITCODE_NOT_INITIALIZE_NETWORK 60
EXITCODE_NOT_NEGOTIATE_ASSOCIATION 61
EXITCODE_NOT_SEND_REQUEST 62
EXITCODE_CANNOT_ADD_PRESENTATION_CONTEXT 65

(*) Sebenarnya, kod ini pada masa ini tidak digunakan oleh dcmsend tetapi berfungsi sebagai pemegang tempat untuk
kumpulan kod keluar yang sepadan.

PERSEKITARAN

. dcmsend utiliti akan cuba memuatkan kamus data DICOM yang dinyatakan dalam
DCMDICTPATH pembolehubah persekitaran. Secara lalai, iaitu jika DCMDICTPATH pembolehubah persekitaran
tidak ditetapkan, fail /dicom.dic akan dimuatkan melainkan kamus dibina
ke dalam aplikasi (lalai untuk Windows).

Tingkah laku lalai harus diutamakan dan DCMDICTPATH pembolehubah persekitaran sahaja
digunakan apabila kamus data alternatif diperlukan. The DCMDICTPATH pembolehubah persekitaran
mempunyai format yang sama seperti cangkerang Unix PATH pembolehubah dalam itu titik bertindih (':') memisahkan
entri. Pada sistem Windows, koma bertitik (';') digunakan sebagai pemisah. Kamus data
kod akan cuba memuatkan setiap fail yang dinyatakan dalam DCMDICTPATH pembolehubah persekitaran. Ia
adalah ralat jika tiada kamus data boleh dimuatkan.

Gunakan dcmsend dalam talian menggunakan perkhidmatan onworks.net