xml2dcm - Dalam Talian di Awan

JADUAL:

NAMA

xml2dcm - Tukar dokumen XML kepada fail DICOM atau set data

SINOPSIS

xml2dcm [pilihan] xmlfile-in dcmfile-out

DESCRIPTION

. xml2dcm utiliti menukarkan kandungan dokumen XML (Extensible Markup Language).
kepada fail DICOM atau set data. Dokumen XML dijangka mengesahkan terhadap DTD
(Definisi Jenis Dokumen) yang diterangkan dalam fail dcm2xml.dtd. Fail XML yang sesuai
boleh dibuat menggunakan dcm2xml alat (pilihan +Wb disyorkan untuk memasukkan data binari).

PARAMETER

xmlfile-in nama fail input XML untuk ditukar (stdin: "-")

nama fail keluaran DICOM dcmfile-out

PILIHAN

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

--versi
maklumat versi cetakan 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

input pilihan
format fail input:

+f --read-meta-info
baca maklumat meta jika ada (lalai)

-f --abaikan-meta-info
abaikan maklumat meta fail

pemprosesan pilihan
pengesahan:

+Vd --validate-document
mengesahkan dokumen XML terhadap DTD

+Vn --check-ruang nama
semak ruang nama XML dalam akar dokumen

pengecam unik:

+Ug --jana-uids-baru
menjana UID Contoh Kajian/Siri/SOP baharu

-Uo --jangan-timpa-uids
jangan tulis ganti UID sedia ada (lalai)

+Uo --timpa-uids
tulis ganti UID sedia ada

output pilihan
format fail output:

+F --tulis-fail
tulis format fail (lalai)

-F --tulis-set data
tulis set data tanpa maklumat meta fail

+Fu --kemas kini-meta-info
kemas kini maklumat meta fail tertentu

sintaks pemindahan output:

+t= --tulis-xfer-sama
tulis dengan TS yang sama seperti input (lalai)

+te --tulis-xfer-sedikit
tulis dengan TS endian kecil VR eksplisit

+tb --tulis-xfer-besar
tulis dengan TS endian besar VR eksplisit

+ti --write-xfer-implisit
tulis dengan TS endian kecil VR tersirat

+td --write-xfer-deflated
tulis dengan TS endian kecil VR eksplisit kempis

perwakilan nilai selepas 1993:

+u --dayakan-baru-vr
dayakan sokongan untuk VR baharu (UN/UT) (lalai)

-u --disable-new-vr
lumpuhkan sokongan untuk VR baharu, tukar kepada OB

pengekodan panjang kumpulan:

+g= --group-length-recalc
kira semula panjang kumpulan jika ada (lalai)

+g --kumpulan-panjang-buat
sentiasa menulis dengan elemen panjang kumpulan

-g --kumpulan-panjang-buang
sentiasa menulis tanpa elemen panjang kumpulan

pengekodan panjang dalam urutan dan item:

+e --panjang-eksplisit
tulis dengan panjang yang jelas (lalai)

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

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

-p= --padding-retain
jangan tukar padding (lalai jika tidak --write-dataset)

-p --padding-off
tiada padding (tersirat jika --write-dataset)

+p --padding-create [f]ile-pad [i]tem-pad: integer
selaraskan fail pada berbilang bait f dan item dihidupkan
berbilang i bait

mengempiskan tahap mampatan (hanya dengan --write-xfer-deflated):

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

NOTA

Struktur asas input XML yang dijangka kelihatan seperti berikut:



<fail-format xmlns="http://dicom.offis.de/dcmtk">

<element tag="0002,0000" vr="UL" vm="1" len="4"
name="MetaElementGroupLength">
166

...
<element tag="0002,0013" vr="SH" vm="1" len="16"
name="ImplementationVersionName">
OFFIS_DCMTK_353



<element tag="0008,0005" vr="CS" vm="1" len="10"
name="SpecificCharacterSet">
ISO_IR 100

...


<element tag="0028,3002" vr="xs" vm="3" len="6"
name="LUTDescriptor">
256 \ 0 \ 8

...

...

...
<element tag="7fe0,0010" vr="OW" vm="1" len="262144"
name="PixelData" dimuatkan="no" binary="hidden">




Teg 'format-fail' dan 'meta-header' mungkin tiada untuk set data DICOM.

Watak Pengekodan
Pengekodan aksara DICOM ditentukan secara automatik daripada elemen dengan tag
'0008,0005' (Set Karakter Khusus) - jika ada. Set aksara berikut ialah
disokong pada masa ini (memerlukan libxml untuk memasukkan iconv sokongan, lihat --versi pengeluaran):

ASCII (ISO_IR 6) (UTF-8)
UTF-8 "ISO_IR 192" (UTF-8)
ISO Latin 1 "ISO_IR 100" (ISO-8859-1)
ISO Latin 2 "ISO_IR 101" (ISO-8859-2)
ISO Latin 3 "ISO_IR 109" (ISO-8859-3)
ISO Latin 4 "ISO_IR 110" (ISO-8859-4)
ISO Latin 5 "ISO_IR 148" (ISO-8859-9)
Cyrillic "ISO_IR 144" (ISO-8859-5)
Bahasa Arab "ISO_IR 127" (ISO-8859-6)
Yunani "ISO_IR 126" (ISO-8859-7)
Ibrani "ISO_IR 138" (ISO-8859-8)

Set berbilang aksara tidak disokong (hanya nilai pertama 'Watak Khusus
Set' digunakan untuk pengekodan aksara dalam kes kepelbagaian nilai).

Lihat dcm2xml dokumentasi untuk butiran lanjut tentang struktur XML.

Perduaan Tarikh
Data binari boleh dikodkan sama ada sebagai jujukan nombor heks yang dipisahkan dengan garis serong ke belakang
'\' atau dalam format Base64 (binary='base64'). Selain itu, data binari juga boleh dibaca daripada
fail (binari='fail'). Dalam kes ini, nama fail perlu dinyatakan sebagai nilai elemen,
contohnya

subdir/pixeldata.raw

Sila ambil perhatian bahawa kandungan fail akan dibaca sebagaimana adanya. Data OW dijangka akan
endian sedikit dipesan dan akan ditukar jika perlu. Tiada semakan akan dibuat untuk memastikan
bahawa jumlah data adalah munasabah dari segi atribut lain seperti Rows atau
Lajur.

Mampatan
Jika libxml disusun dengan sokongan zlib, fail input (xmlfile-in) juga boleh
dimampatkan dengan ZIP, yang biasanya menghasilkan fail yang lebih kecil. Lihat output pilihan
--versi untuk menyemak sama ada sokongan zlib tersedia.

Batasan
Versi libxml yang berbeza mungkin mempunyai had yang berbeza untuk panjang maksimum XML
nilai unsur. Oleh itu, ia harus dielakkan untuk menggunakan nilai elemen yang sangat panjang (cth
data piksel).

Sila ambil perhatian bahawa xml2dcm pada masa ini tidak menyokong sepenuhnya fail DICOMDIR. Secara khusus,
nilai pelbagai elemen data offset tidak dikemas kini secara automatik oleh alat ini.

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

PERSEKITARAN

. xml2dcm 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 xml2dcm dalam talian menggunakan perkhidmatan onworks.net