img2dcm - Daring di Awan

PROGRAM:

NAMA

img2dcm - Ubah format gambar standar menjadi format DICOM

RINGKASAN

img2dcm [opsi] imgfile-in dcmfile-out

DESKRIPSI

Grafik img2dcm alat berfungsi sebagai alat konversi dari format gambar standar seperti JPEG atau BMP
ke DICOM. Kelas SOP keluaran yang berbeda dapat dipilih. Informasi tambahan
(tentang pasien, seri, dll.) yang disimpan dalam file keluaran DICOM dapat diekstraksi dari
file DICOM lain yang berfungsi sebagai 'templat' untuk objek DICOM yang dihasilkan. img2dcm bisa
juga dapat dikonfigurasi untuk menemukan atribut DICOM tipe 1 dan tipe 2 yang hilang agar berfungsi dengan baik
tanpa set data template apa pun.

PARAMETER

imgfile-in file gambar yang akan diimpor

dcmfile-out file keluaran DICOM

PILIHAN

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

--Versi: kapan
informasi versi cetak dan keluar

--argumen
cetak argumen baris perintah yang diperluas

-q --tenang
mode senyap, tidak mencetak peringatan dan kesalahan

-v --bertele-tele
mode verbose, detail pemrosesan cetak

-d --debug
mode debug, cetak informasi debug

-ll --log-level [l]evel: konstanta string
(fatal, error, warning, info, debug, trace)
gunakan level l untuk logger

-lc --log-config [f]nama file: string
gunakan file konfigurasi f untuk logger

memasukkan Pilihan
umum:

-i --input-format [i]nput format file: string
format yang didukung: JPEG (default), BMP

-df --dataset-from [f]nama file: string
gunakan kumpulan data dari file DICOM f

-stf --study-from [f]nama file: string
membaca pasien/studi dari file DICOM f

-sef --seri-dari [f]nama file: string
baca pasien/studi/seri dari file DICOM f

-ii --instance-inc
tingkatkan nomor instance yang dibaca dari file DICOM

Format JPEG:

-dp --nonaktifkan-progr
nonaktifkan dukungan untuk JPEG progresif

-de --disable-ext
nonaktifkan dukungan untuk JPEG berurutan yang diperpanjang

-jf --inst-on-jfif
bersikeras pada keberadaan header JFIF

-ka --simpan-aplikasi
pertahankan bagian APPn (kecuali JFIF)

pengolahan Pilihan
pemeriksaan atribut:

--lakukan-pemeriksaan
aktifkan pemeriksaan validitas atribut (default)

--tidak ada pemeriksaan
nonaktifkan pemeriksaan validitas atribut

+i2 --sisipkan-tipe2
masukkan atribut tipe 2 yang hilang (default)
(hanya dengan --do-checks)

-i2 --tidak ada-tipe2-masukkan
jangan masukkan atribut tipe 2 yang hilang
(hanya dengan --do-checks)

+i1 --penemuan-tipe1
temukan atribut tipe 1 yang hilang
(hanya dengan --do-checks)

-i1 --no-type1-menemukan
jangan menemukan atribut tipe 1 yang hilang
(hanya dengan --do-checks)

set karakter:

+l1 --latin1
setel latin-1 sebagai set karakter standar (default)

-l1 --tidak-latin1
pertahankan ASCII 7-bit sebagai set karakter standar

opsi pemrosesan lainnya:

-k --key [k]ey: gggg,eeee="str", path atau nama kamus="str"
tambahkan atribut lebih lanjut

keluaran Pilihan
kelas SOP sasaran:

-sc --detik-capture
tulis kelas SOP Tangkapan Sekunder

-nsc --baru-sc
tulis kelas SOP Tangkapan Sekunder baru

-vlp --vl-foto
tulis kelas SOP Fotografi Cahaya Terlihat (default)

format file keluaran:

+F --tulis-file
format file tulis (default)

-F --tulis-dataset
tulis kumpulan data tanpa informasi meta file

pengkodean panjang grup:

+g= --penghitungan panjang grup
hitung ulang panjang grup jika ada (default)

+g --grup-panjang-buat
selalu tulis dengan elemen panjang grup

-g --group-length-hapus
selalu tulis tanpa elemen panjang grup

pengkodean panjang dalam urutan dan item:

+e --panjang-eksplisit
tulis dengan panjang eksplisit (default)

-e --panjang-tidak terdefinisi
tulis dengan panjang yang tidak ditentukan

data set trailing padding (bukan dengan --write-dataset):

-p --padding-off
tidak ada padding (implisit jika --write-dataset)

+p --padding-buat [f]ile-pad [i]tem-pad: bilangan bulat
menyelaraskan file pada beberapa f byte
dan item pada kelipatan i byte

CATATAN

Atribut sumber
Untuk mengonversi format gambar umum ke format DICOM, img2dcm aplikasi mungkin
diberi beberapa input tambahan untuk mengisi atribut wajib (dan opsional) di yang baru
File DICOM seperti informasi pasien, studi dan seri. Informasi ini dapat dikumpulkan
menggunakan pendekatan yang berbeda, yang dapat digabungkan dan diterapkan ke file hasil di
urutan berikut:

· Menggunakan --set-data-dari Option img2dcm dipaksa untuk mengimpor atribut dari yang sudah ada
berkas DICOM. File DICOM yang diberikan sepenuhnya diimpor dan berfungsi sebagai dasar untuk semua
operasi ekspor lebih lanjut. Sebagai pengecualian, UID Instance SOP tidak disalin oleh ini
pilihan. Juga data terkait gambar seperti Baris, Kolom, dll. dipertukarkan selama konversi.
Perhatikan bahwa img2dcm tidak memeriksa nilai atribut lain untuk validitas, mis
tidak melihat ke dalam urutan untuk mengadaptasi atribut apa pun ke objek baru (gambar referensi
dll.). Oleh karena itu, disarankan untuk menggunakan template di direktori data untuk (lama)
objek SC dan VLP. Lihat juga bagian 'Template Masukan'.
· Itu --studi-dari dan --seri-dari opsi (saling eksklusif) dapat digunakan untuk mengimpor
pasien, studi dan informasi seri dari file DICOM yang ada. Jika --seri-dari is
ditentukan, maka file DICOM yang diberikan dibuka oleh img2dcm dan semua informasi wajib
ke tingkat seri diimpor. Perhatikan bahwa ini termasuk pasien, studi, dan seri
informasi. dalam kasus --studi-dari, informasi seri dikecualikan. Pengikut
atribut diambil alih:
Tingkat Pasien:
Nama pasien
ID pasien
jenis kelamin pasien
Tanggal Lahir Pasien
Set Karakter Tertentu

Tingkat Studi:
Studi Instance UID
Tanggal Studi
Waktu belajar
Nama Dokter yang Merujuk
ID studi
Nomor Aksesi

Level Seri (hanya dalam kasus opsi --series-from):
UID Instance Seri
Nomor seri
Pabrikan
· Dengan --sisipkan-tipe2 dan --menemukan-tipe1 opsi (keduanya diaktifkan per default), tidak ada
atribut (atribut tipe 2) dan/atau nilai atribut yang hilang (untuk atribut tipe 1)
secara otomatis ditambahkan dan ditemukan oleh img2dcm. Harap dicatat bahwa opsi ini hanya
dievaluasi jika opsi --lakukan-pemeriksaan diaktifkan (default). jika --tidak ada pemeriksaan pilihannya adalah
diaktifkan, tidak ada penyisipan atribut otomatis yang akan dilakukan.
· Itu --kunci opsi dapat digunakan untuk menambahkan atribut lebih lanjut ke file keluaran DICOM. Ini
opsi diterapkan di bagian paling akhir, tepat sebelum menyimpan file DICOM. Itu juga
memungkinkan untuk menentukan urutan, item, dan atribut bersarang menggunakan --kunci pilihan. Di dalam
kasus ini, notasi 'jalur' khusus harus digunakan. Detail pada notasi jalur ini dapat
ditemukan dalam dokumentasi modifikasi.
UID
UID Instance Studi dan Seri Baru dibuat if perlu setelah menerapkan --belajar-
dari dan --seri pilihan. Jika UID Instance Studi atau UID Instance Seri tidak ada
setelah langkah-langkah ini, mereka baru dibuat, secara independen satu sama lain. Sebaliknya
perilaku dipilih untuk SOP Instance UID yang diharapkan dapat diambil alih ketika
menggunakan --set-data-dari pilihan. Ini adalah tidak kasusnya, SOP Instance UID adalah tidak disalin
ke objek baru. Ini harus menjadi perilaku yang diinginkan untuk sebagian besar kasus penggunaan. Namun, jika
UID Instance SOP tertentu harus dimasukkan ke objek baru, yaitu --kunci pilihan harus
digunakan.
Memasukkan template
Untuk mendukung konversi ke DICOM, img2dcm dilengkapi dengan beberapa templat yang telah ditentukan sebelumnya
yang dapat digunakan untuk --set-data-dari opsi (lihat file contoh SC.dump dan VLP.dump).
Template ini harus diisi dengan nilai yang diinginkan dan kemudian harus dibuang
(dikonversi) ke file DICOM sebelum benar-benar digunakan dengan img2dcm. Menggunakan dump2dcm untuk
mengkonversi dump ke DICOM. Contoh:
dump2dcm SC.dump SC.dcm

Dimungkinkan untuk menggunakan file DICOM apa pun sebagai templat. Harap dicatat bahwa DICOM lengkap
kumpulan data diimpor; karenanya, harus dipastikan bahwa hanya atribut yang ada yang
harus menjadi bagian dari objek DICOM yang dibangun. UID Kelas SOP dan Data Piksel
atribut (termasuk atribut seperti Baris, Kolom, dll.) tidak disalin tetapi diganti dengan
img2dcm selama konversi.
Memasukkan plugin
Grafik img2dcm aplikasi saat ini mendukung format gambar JPEG dan BMP sebagai input.
JPEG Memasukkan Plugin
Untuk JPEG, JPEG asli dari file sumber tidak diterjemahkan tetapi diekstraksi dan sedikit
diubah (misalnya header JFIF terpotong) untuk memungkinkan konversi cepat bahkan file JPEG besar
tanpa perlu decoding dan re-encoding. Plugin JPEG memilih output yang diperlukan
mentransfer sintaks secara otomatis tergantung pada pengkodean sebenarnya dari data di dalam JPEG
mengajukan. Oleh karena itu, Sintaks Transfer berikut (dan pengkodean JPEG yang sesuai)
digunakan oleh plugin JPEG:
· Proses Coding JPEG 1 Baseline, Lossy, Non-Hierarchical, Sequential, DCT, Huffman, 8 Bit
Kelas SOP = 1.2.840.10008.1.2.4.50
· Proses Pengkodean JPEG 2 (8-bit) dan 4 (12-bit) Extended, Lossy, Non-Hierarchical,
Sequential, DCT, Huffman, 8/12 Bit Kelas SOP = 1.2.840.10008.1.2.4.51
· Proses Pengkodean JPEG 10 (8-bit) dan 12 (12-bit) Progresi Penuh, lossy, Non-Hierarch.,
Progresif, DCT, Huffman, 8/12 Bit Kelas SOP = 1.2.840.10008.1.2.4.55
Gambar berwarna dan skala abu-abu didukung.
Dukungan untuk Extended JPEG Transfer Syntax dapat dinonaktifkan (--nonaktifkan-ext opsional)
serta dukungan untuk Sintaks Transfer JPEG Progresif (sudah pensiun) (--nonaktifkan-program
pilihan).
Pengkodean lossless JPEG serta mode pengkodean JPEG aritmatika atau hierarkis adalah
tidak didukung oleh plugin.
Informasi JFIF (JPEG File Interchange Format) memfasilitasi penanda APPn opsional dalam a
berkas JPEG. Banyak kamera digital tidak mengintegrasikan informasi JFIF tersebut ke dalam JPEG
keluaran yang mereka buat. Misalnya, JFIF berisi informasi tentang rasio aspek piksel dari
gambar terkompresi. Jika Anda ingin img2dcm aplikasi untuk menuntut header JFIF di
aliran JPEG, Anda dapat menggunakan opsi --inist-on-jfif yang akan dibatalkan jika tidak ada JFIF
informasi dapat ditemukan. Secara default, informasi JFIF yang hilang diabaikan.
Untuk DICOM itu semacam 'zona abu-abu', apakah integrasi JFIF (atau APPn lainnya)
data ke dalam aliran JPEG internal objek DICOM diperbolehkan atau tidak. Namun, yang paling
pendekatan yang dapat diandalkan adalah dengan memotong penanda tersebut dan informasinya dari aliran JPEG. Ini
pendekatan juga diambil oleh img2dcm aplikasi. Secara default, semua penanda APPn terpotong
off dari aliran JPEG asli. Namun, jika Anda ingin menyimpan penanda APPn selain
JFIF (misalnya informasi EXIF) di dalam aliran DICOM, opsinya --simpan-aplikasi apakah
menipu. Itu juga harus sedikit lebih cepat daripada memotong informasi APPn, karena itu
tidak perlu memindai seluruh aliran JPEG untuk data tersebut. Informasi JFIF adalah selalu
dihapus oleh img2dcm.
BMP Memasukkan Plugin
img2dcm mendukung BMP sebagai format input. Namun, sejauh ini hanya gambar BMP yang paling umum adalah
didukung. Secara khusus, gambar BMP yang menggunakan bitfield atau pengkodean panjang proses akan menjadi
ditolak. Gambar seperti itu jarang terjadi. Semua gambar masukan akan diubah menjadi gambar DICOM
dengan model warna RGB dan kedalaman sedikit 24. Tidak ada opsi khusus untuk fine-tuning
konversi format BMP.
Keluaran plugin
Output SOP Class yang diinginkan dapat dipilih pada command line. Saat ini, ekspor
plugin untuk kelas SOP Pengambilan Gambar Sekunder (default, opsi -sc), Sekunder baru
Ambil kelas SOP Gambar (opsi -nsc) dan kelas SOP Gambar Fotografi Cahaya Tampak
(pilihan -vl) tersedia. Harap dicatat bahwa yang pertama tidak digunakan lagi sesuai dengan
Standar DICOM tetapi dipilih sebagai default karena didukung secara luas. Masa depan
versi dari img2dcm mungkin menyediakan plugin keluaran lebih lanjut untuk Kelas SOP lainnya.
Untuk kelas SOP Pengambilan Sekunder yang baru, tidak mungkin untuk menentukan yang spesifik
Kelas SOP harus digunakan untuk output. Itu karena kelas SOP baru ini
dibedakan satu sama lain berdasarkan kedalaman warna (1/8/16) dan fakta apakah gambar tersebut
hitam/putih atau berwarna. Itulah mengapa img2dcm memutuskan selama konversi, yang menghasilkan SOP
class cocok untuk gambar sumber tertentu.

CONTOH

Berikut adalah beberapa contoh yang menunjukkan bagaimana img2dcm aplikasi dapat digunakan.
1. img2dcm gambar.jpg keluar.dcm
Baca file JPEG 'image.jpg', konversikan ke kelas SOP Pengambilan Sekunder yang lama dan simpan
hasilnya menjadi file DICOM 'out.dcm'. Ini adalah cara termudah menggunakan img2dcm. Jenis apa pun
Atribut 1 dan tipe 2 yang diperlukan untuk menulis objek yang valid dari kelas SOP ini adalah
dimasukkan secara otomatis.
2. img2dcm -i BMP gambar.bmp keluar.dcm
Sama seperti di atas tetapi memberitahu img2dcm untuk membaca file BMP bukan JPEG.
3. img2dcm image.jpg out.dcm -vlp -k 'PatientName=Bond^James'
Sama seperti contoh pertama, tetapi menulis objek Gambar Fotografi Cahaya Tampak ke 'out.dcm'
dan set PatientName ke 'Bond^ James' yang jika tidak akan dibiarkan kosong.
4. img2dcm image.jpg out.dcm --series-from template.dcm -k 'PatientName=Bond^James'
Sama seperti 1), tetapi mengimpor informasi pasien/studi/seri dari file DICOM
'templat.dcm'. Harap perhatikan bahwa atribut PatientName akan berisi 'Bond^James' di
akhirnya, nilai apa pun dari 'template.dcm' akan ditimpa. Artinya, karena -k
opsi diterapkan di bagian paling akhir dari jalur konversi (lihat di atas).
5. img2dcm image.jpg out.dcm --tanpa pemeriksaan
Sama seperti 1), tetapi tidak melakukan pemeriksaan atribut apa pun dan tidak ada tipe 1 dan tipe 2
penyisipan atribut! Jadi dalam kasus ini, objek DICOM yang tidak valid akan dihasilkan. Ini
bisa menarik jika file output tidak dimaksudkan untuk diselesaikan tetapi akan menjalani
transformasi lebih lanjut, misalnya menambahkan atribut menggunakan modifikasi. Hanya gunakan opsi --tidak-
pemeriksaan jika Anda tahu apa yang Anda lakukan!
6. img2dcm image.jpg keluar.dcm --no-type1-invent
Sama seperti 1), tetapi tidak memasukkan atribut tipe 1 yang hilang dan/atau nilainya. Tipe 2
atribut akan dimasukkan. Perhatikan bahwa dalam hal ini harus dipastikan bahwa semua tipe 1
atribut disediakan dengan cara lain, yaitu dengan menambahkannya dengan --kunci .
Jika tidak, img2dcm akan melaporkan kesalahan dan akan berhenti mengonversi.
7. img2dcm image.jpg out.dcm --keep-appn --insist-on-jfif
Sama seperti 1), tetapi mengambil alih informasi APPn seperti EXIF ​​ke dalam objek DICOM
menghasilkan aliran JPEG. Lebih jauh, --inist-on-jfif akan memaksa img2dcm menggugurkan jika tidak
Informasi JFIF ada di file sumber.

masuk

Tingkat keluaran logging dari berbagai alat baris perintah dan pustaka yang mendasarinya dapat
akan ditentukan oleh pengguna. Secara default, hanya kesalahan dan peringatan yang ditulis ke standar
aliran kesalahan. Menggunakan opsi --bertele-tele juga pesan informasi seperti memproses detail
dilaporkan. Pilihan --debug dapat digunakan untuk mendapatkan detail lebih lanjut tentang aktivitas internal,
misalnya untuk tujuan debugging. Level logging lainnya dapat dipilih menggunakan opsi --catatan-
tingkat. di --diam mode hanya kesalahan fatal yang dilaporkan. Dalam peristiwa kesalahan yang sangat parah,
aplikasi biasanya akan berhenti. Untuk detail lebih lanjut tentang tingkat logging yang berbeda,
lihat dokumentasi modul 'oflog'.
Jika output logging harus ditulis ke file (opsional dengan rotasi file log),
ke syslog (Unix) atau opsi log peristiwa (Windows) --log-config dapat digunakan. Ini
file konfigurasi juga memungkinkan untuk mengarahkan hanya pesan tertentu ke output tertentu
streaming dan untuk memfilter pesan tertentu berdasarkan modul atau aplikasi tempat mereka
dihasilkan. Contoh file konfigurasi disediakan di /logger.cfg.

COMMAND GARIS

Semua alat baris perintah menggunakan notasi berikut untuk parameter: kurung siku melampirkan
nilai opsional (0-1), tiga titik tambahan menunjukkan bahwa beberapa nilai diperbolehkan
(1-n), kombinasi keduanya berarti 0 hingga n nilai.
Opsi baris perintah dibedakan dari parameter dengan tanda '+' atau '-' di depan,
masing-masing. Biasanya, urutan dan posisi opsi baris perintah bersifat arbitrer (mis
dapat muncul di mana saja). Namun, jika opsi saling eksklusif, penampilan paling kanan
digunakan. Perilaku ini sesuai dengan aturan evaluasi standar shell Unix umum.
Selain itu, satu atau lebih file perintah dapat ditentukan menggunakan tanda '@' sebagai awalan untuk
nama file (mis @ perintah.txt). Argumen perintah seperti itu diganti dengan isi dari
file teks yang sesuai (beberapa spasi putih diperlakukan sebagai pemisah tunggal kecuali
mereka muncul di antara dua tanda kutip) sebelum evaluasi lebih lanjut. Harap dicatat bahwa
file perintah tidak dapat berisi file perintah lain. Pendekatan sederhana namun efektif ini
memungkinkan seseorang untuk meringkas kombinasi umum opsi/parameter dan menghindari gondrong dan
baris perintah yang membingungkan (contoh disediakan dalam file /dumppat.txt).

LINGKUNGAN

Grafik img2dcm utilitas akan mencoba memuat kamus data DICOM yang ditentukan dalam
DCMDICPATH variabel lingkungan. Secara default, yaitu jika DCMDICPATH variabel lingkungan
tidak disetel, file /dicom.dic akan dimuat kecuali kamus dibuat
ke dalam aplikasi (default untuk Windows).
Perilaku default harus lebih disukai dan DCMDICPATH variabel lingkungan saja
digunakan ketika kamus data alternatif diperlukan. NS DCMDICPATH variabel lingkungan
memiliki format yang sama dengan shell Unix PATH variabel di mana titik dua (':') memisahkan
entri. Pada sistem Windows, titik koma (';') digunakan sebagai pemisah. kamus data
kode akan mencoba memuat setiap file yang ditentukan dalam DCMDICPATH variabel lingkungan. Dia
adalah kesalahan jika tidak ada kamus data yang dapat dimuat.

Gunakan img2dcm online menggunakan layanan onworks.net