xml2dcm - ອອນລາຍໃນຄລາວ

ໂຄງການ:

NAME

xml2dcm - ປ່ຽນເອກະສານ XML ເປັນໄຟລ໌ DICOM ຫຼືຊຸດຂໍ້ມູນ

ສະຫຼຸບສັງລວມ

xml2dcm [ຕົວເລືອກ] xmlfile-in dcmfile-out

ລາຍລະອຽດ

ໄດ້ xml2dcm ຜົນປະໂຫຍດປ່ຽນເນື້ອໃນຂອງເອກະສານ XML (Extensible Markup Language).
ໄປຫາໄຟລ໌ DICOM ຫຼືຊຸດຂໍ້ມູນ. ເອກະສານ XML ຄາດວ່າຈະມີຄວາມຖືກຕ້ອງຕໍ່ກັບ DTD
(ຄໍານິຍາມປະເພດເອກະສານ) ເຊິ່ງອະທິບາຍໄວ້ໃນເອກະສານ dcm2xml.dtd. ໄຟລ໌ XML ທີ່ເຫມາະສົມ
ສາມາດສ້າງໂດຍໃຊ້ dcm2xml ເຄື່ອງ​ມື (ທາງ​ເລືອກ​ +Wb ແນະນໍາໃຫ້ລວມເອົາຂໍ້ມູນຖານສອງ).

PARAMETERS

xmlfile-in XML ຊື່ໄຟລ໌ທີ່ຈະຖືກແປງ (stdin: "-")

dcmfile-out DICOM ຊື່ໄຟລ໌ຜົນຜະລິດ

OPTIONS

ໂດຍທົ່ວໄປ ທາງເລືອກໃນການ
-h --help
ພິມຂໍ້ຄວາມຊ່ວຍເຫຼືອນີ້ ແລະອອກ

- ການປ່ຽນແປງ
ພິມຂໍ້ມູນສະບັບແລະອອກ

--ການໂຕ້ຖຽງ
ພິມການໂຕ້ຖຽງແຖວຄໍາສັ່ງຂະຫຍາຍ

-q --ງຽບ
ໂໝດງຽບ, ພິມບໍ່ມີຄຳເຕືອນ ແລະຄວາມຜິດພາດ

-v --verbose
ຮູບແບບ verbose, ລາຍລະອຽດການປະມວນຜົນການພິມ

-d --debug
ໂໝດດີບັກ, ພິມຂໍ້ມູນດີບັກ

-ll --log-level [l]evel: string constant
(ຮ້າຍແຮງ, ຄວາມຜິດພາດ, ເຕືອນ, ຂໍ້ມູນ, ດີບັກ, ຕິດຕາມ)
ໃຊ້ລະດັບ l ສໍາລັບຜູ້ຕັດໄມ້

-lc --log-config [f]ilename: string
ໃຊ້ config file f ສໍາລັບ logger

ການປ້ອນຂໍ້ມູນ ທາງເລືອກໃນການ
ຮູບ​ແບບ​ໄຟລ​໌​ປ້ອນ​ຂໍ້​ມູນ​:

+f --read-meta-info
ອ່ານຂໍ້ມູນ meta ຖ້າມີ (ຄ່າເລີ່ມຕົ້ນ)

-f --ignore-meta-info
ບໍ່ສົນໃຈຂໍ້ມູນ meta ຂອງໄຟລ໌

ການປຸງແຕ່ງ ທາງເລືອກໃນການ
ການກວດສອບ:

+Vd --validate-document
ກວດສອບເອກະສານ XML ຕໍ່ກັບ DTD

+Vn --check-namespace
ກວດເບິ່ງ XML namespace ໃນຮາກເອກະສານ

ຕົວ​ລະ​ບຸ​ທີ່​ເປັນ​ເອ​ກະ​ລັກ​:

+Ug --generate-new-uids
ສ້າງ Study/Series/SOP Instance UID ໃໝ່

-Uo --dont-overwrite-uids
ຢ່າຂຽນທັບ UID ທີ່ມີຢູ່ແລ້ວ (ຄ່າເລີ່ມຕົ້ນ)

+Uo --ຂຽນທັບ-uids
ຂຽນທັບ UID ທີ່ມີຢູ່ແລ້ວ

output ທາງເລືອກໃນການ
ຮູບ​ແບບ​ໄຟລ​໌​ຜົນ​ຜະ​ລິດ​:

+F --write-file
ຂຽນຮູບແບບໄຟລ໌ (ຄ່າເລີ່ມຕົ້ນ)

-F --write-dataset
ຂຽນຊຸດຂໍ້ມູນໂດຍບໍ່ມີຂໍ້ມູນ meta ໄຟລ໌

+Fu --update-meta-info
ປັບປຸງຂໍ້ມູນ meta ໄຟລ໌ໂດຍສະເພາະ

syntax ການໂອນຜົນຜະລິດ:

+t= --write-xfer-same
ຂຽນດ້ວຍ TS ດຽວກັນກັບການປ້ອນຂໍ້ມູນ (ຄ່າເລີ່ມຕົ້ນ)

+te --write-xfer-little
ຂຽນດ້ວຍ VR ນ້ອຍ endian TS ຢ່າງຊັດເຈນ

+tb --write-xfer-big
ຂຽນດ້ວຍ VR big endian TS ຢ່າງຊັດເຈນ

+ti --write-xfer-implicit
ຂຽນດ້ວຍ implicit VR ນ້ອຍ endian TS

+td --write-xfer-deflated
ຂຽນດ້ວຍ deflated explicit VR little endian TS

ການສະແດງມູນຄ່າຫຼັງປີ 1993:

+u --enable-new-vr
ເປີດໃຊ້ການຮອງຮັບ VRs ໃໝ່ (UN/UT) (ຄ່າເລີ່ມຕົ້ນ)

-u --disable-new-vr
ປິດການຮອງຮັບ VRs ໃໝ່, ປ່ຽນເປັນ OB

ການ​ເຂົ້າ​ລະ​ຫັດ​ກຸ່ມ​:

+g= --group-length-recalc
ຄິດໄລ່ຄວາມຍາວຂອງກຸ່ມຄືນໃໝ່ຖ້າມີ (ຄ່າເລີ່ມຕົ້ນ)

+g --group-length-create
ສະເຫມີຂຽນດ້ວຍອົງປະກອບຄວາມຍາວຂອງກຸ່ມ

-g --group-length-remove
ສະເຫມີຂຽນໂດຍບໍ່ມີອົງປະກອບຄວາມຍາວຂອງກຸ່ມ

ການ​ເຂົ້າ​ລະ​ຫັດ​ຄວາມ​ຍາວ​ໃນ​ລໍາ​ດັບ​ແລະ​ລາຍ​ການ​:

+e --length-explicit
ຂຽນດ້ວຍຄວາມຍາວຢ່າງຊັດເຈນ (ຄ່າເລີ່ມຕົ້ນ)

-e --length-undefined
ຂຽນດ້ວຍຄວາມຍາວທີ່ບໍ່ໄດ້ກໍານົດ

ຊຸດຂໍ້ມູນ trailing padding (ບໍ່ແມ່ນກັບ --write-dataset):

-p= --padding-retain
ຢ່າປ່ຽນ padding (ຄ່າເລີ່ມຕົ້ນຖ້າບໍ່ແມ່ນ --write-dataset)

-p --padding-off
ບໍ່ມີ padding ( implicit ຖ້າ --write-dataset)

+p --padding-create [f]ile-pad [i]tem-pad: integer
ຈັດຮຽງໄຟລ໌ຢູ່ໃນຫຼາຍໆ f bytes ແລະລາຍການຢູ່ໃນ
ຫຼາຍຂອງ i bytes

ລະດັບການບີບອັດ deflate (ພຽງແຕ່ມີ --write-xfer-deflated):

+cl --compression-level [l]evel: integer (ຄ່າເລີ່ມຕົ້ນ: 6)
0=ບໍ່ໄດ້ບີບອັດ, 1=ໄວທີ່ສຸດ, 9=ການບີບອັດທີ່ດີທີ່ສຸດ

ຫມາຍເຫດ

ໂຄງສ້າງພື້ນຖານຂອງການປ້ອນຂໍ້ມູນ XML ຄາດວ່າຈະມີລັກສະນະດັ່ງຕໍ່ໄປນີ້:



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

<ອົງປະກອບ tag="0002,0000" vr="UL" vm="1" len="4"
name="MetaElementGroupLength">
166

...
<ອົງປະກອບ tag="0002,0013" vr="SH" vm="1" len="16"
name="ImplementationVersionName">
OFFIS_DCMTK_353



<ອົງປະກອບ tag="0008,0005" vr="CS" vm="1" len="10"
name="SpecificCharacterSet">
ISO_IR 100

...


<ອົງປະກອບ tag="0028,3002" vr="xs" vm="3" len="6"
name="LUTDDescriptor">
256 \ 0 \ 8

...

...

...
<ອົງປະກອບ tag="7fe0,0010" vr="OW" vm="1" len="262144"
name="PixelData" loaded="no" binary="hidden">




ແທັກ 'file-format' ແລະ 'meta-header' ອາດຈະບໍ່ມີຢູ່ສຳລັບຊຸດຂໍ້ມູນ DICOM.

ລັກສະນະ ການເຂົ້າລະຫັດ
ການເຂົ້າລະຫັດຕົວອັກສອນ DICOM ຖືກກຳນົດໂດຍອັດຕະໂນມັດຈາກອົງປະກອບທີ່ມີແທັກ
'0008,0005' (ຊຸດລັກສະນະສະເພາະ) - ຖ້າມີ. ຊຸດຕົວອັກສອນຕໍ່ໄປນີ້ແມ່ນ
ປະຈຸບັນສະຫນັບສະຫນູນ (ຕ້ອງການ libxml ປະກອບ iconv ສະຫນັບສະຫນູນ, ເບິ່ງ - ການປ່ຽນແປງ ຜົນຜະລິດ):

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)
ອາຣັບ "ISO_IR 127" (ISO-8859-6)
ກເຣັກ "ISO_IR 126" (ISO-8859-7)
ພາສາເຮັບເຣີ "ISO_IR 138" (ISO-8859-8)

ບໍ່ຮອງຮັບຊຸດຕົວອັກສອນຫຼາຍຕົວ (ພຽງແຕ່ຄ່າທຳອິດຂອງ 'ຕົວລະຄອນສະເພາະ
Set' ຖືກນໍາໃຊ້ສໍາລັບການເຂົ້າລະຫັດຕົວອັກສອນໃນກໍລະນີຂອງການຄູນມູນຄ່າ).

ເບິ່ງ dcm2xml ເອກະສານສໍາລັບລາຍລະອຽດເພີ່ມເຕີມກ່ຽວກັບໂຄງສ້າງ XML.

ຖານສອງ ຂໍ້ມູນ
ຂໍ້​ມູນ​ຖານ​ສອງ​ສາ​ມາດ​ໄດ້​ຮັບ​ການ​ເຂົ້າ​ລະ​ຫັດ​ບໍ່​ວ່າ​ຈະ​ເປັນ​ລໍາ​ດັບ​ຂອງ​ຈໍາ​ນວນ hex ແຍກ​ອອກ​ໂດຍ backslash ເປັນ​
'\' ຫຼືໃນຮູບແບບ Base64 (binary='base64'). ນອກຈາກນັ້ນ, ຂໍ້ມູນຖານສອງຍັງສາມາດອ່ານໄດ້ຈາກ
file (binary='file'). ໃນກໍລະນີນີ້, ຊື່ໄຟລ໌ຕ້ອງໄດ້ຮັບການລະບຸເປັນມູນຄ່າອົງປະກອບ,
ຕົວຢ່າງ:

subdir/pixeldata.raw

ກະລຸນາຮັບຊາບວ່າເນື້ອໃນຂອງໄຟລ໌ຈະຖືກອ່ານເປັນ. ຂໍ້ມູນ OW ຄາດວ່າຈະເປັນ
ນ້ອຍ endian ສັ່ງແລະຈະຖືກ swapped ຖ້າຈໍາເປັນ. ບໍ່ມີການກວດສອບໃດໆທີ່ຈະເຮັດເພື່ອຮັບປະກັນ
ວ່າຈໍານວນຂໍ້ມູນແມ່ນສົມເຫດສົມຜົນໃນເງື່ອນໄຂຂອງຄຸນລັກສະນະອື່ນໆເຊັ່ນ Rows ຫຼື
ຖັນ.

ການບີບອັດ
ຖ້າ libxml ຖືກລວບລວມດ້ວຍການສະຫນັບສະຫນູນ zlib, ໄຟລ໌ປ້ອນຂໍ້ມູນ (xmlfile-in) ຍັງສາມາດເປັນ
ຖືກບີບອັດດ້ວຍ ZIP, ເຊິ່ງປົກກະຕິຈະສົ່ງຜົນໃຫ້ໄຟລ໌ນ້ອຍລົງຫຼາຍ. ເບິ່ງຜົນຜະລິດຂອງທາງເລືອກ
- ການປ່ຽນແປງ ເພື່ອກວດເບິ່ງວ່າມີການສະຫນັບສະຫນູນ zlib.

ຂໍ້ຈໍາກັດ
ຮຸ່ນຕ່າງໆຂອງ libxml ອາດຈະມີຂໍ້ຈໍາກັດທີ່ແຕກຕ່າງກັນສໍາລັບຄວາມຍາວສູງສຸດຂອງ XML
ມູນ​ຄ່າ​ອົງ​ປະ​ກອບ​. ດັ່ງນັ້ນ, ຄວນຫຼີກລ່ຽງການໃຊ້ຄ່າອົງປະກອບທີ່ຍາວຫຼາຍ (ຕົວຢ່າງ
ຂໍ້ມູນ pixels).

ກະລຸນາສັງເກດວ່າ xml2dcm ໃນປັດຈຸບັນບໍ່ຮອງຮັບໄຟລ໌ DICOMDIR ຢ່າງເຕັມສ່ວນ. ໂດຍສະເພາະ,
ມູນຄ່າຂອງອົງປະກອບຂໍ້ມູນຊົດເຊີຍຕ່າງໆບໍ່ໄດ້ຖືກປັບປຸງໂດຍອັດຕະໂນມັດໂດຍເຄື່ອງມືນີ້.

ການບັນທຶກ

ລະດັບການອອກບັນທຶກຂອງເຄື່ອງມືບັນທັດຄໍາສັ່ງຕ່າງໆແລະຫ້ອງສະຫມຸດທີ່ຕິດພັນສາມາດ
ຖືກລະບຸໂດຍຜູ້ໃຊ້. ໂດຍຄ່າເລີ່ມຕົ້ນ, ມີພຽງແຕ່ຄວາມຜິດພາດແລະຄໍາເຕືອນທີ່ຖືກຂຽນເປັນມາດຕະຖານ
ການຖ່າຍທອດຄວາມຜິດພາດ. ການນໍາໃຊ້ທາງເລືອກ -- verbose ຂໍ້ຄວາມທີ່ເປັນຂໍ້ມູນເຊັ່ນ: ລາຍລະອຽດການປະມວນຜົນ
ມີລາຍງານ. ທາງເລືອກ --debug ສາມາດໃຊ້ເພື່ອໃຫ້ໄດ້ລາຍລະອຽດເພີ່ມເຕີມກ່ຽວກັບກິດຈະກໍາພາຍໃນ,
ຕົວຢ່າງ: ສໍາລັບຈຸດປະສົງ debugging. ລະດັບການບັນທຶກອື່ນໆສາມາດຖືກເລືອກໂດຍໃຊ້ທາງເລືອກ --ບັນທຶກ-
ລະດັບ. ໃນ --ງຽບ ໂຫມດມີພຽງແຕ່ລາຍງານຄວາມຜິດພາດທີ່ຮ້າຍແຮງເທົ່ານັ້ນ. ໃນ​ເຫດ​ການ​ຄວາມ​ຜິດ​ພາດ​ທີ່​ຮ້າຍ​ແຮງ​ດັ່ງ​ກ່າວ​,
ປົກກະຕິແລ້ວຄໍາຮ້ອງສະຫມັກຈະຢຸດເຊົາ. ສໍາລັບລາຍລະອຽດເພີ່ມເຕີມກ່ຽວກັບລະດັບການຕັດໄມ້ທີ່ແຕກຕ່າງກັນ,
ເບິ່ງເອກະສານຂອງໂມດູນ 'oflog'.

ໃນ​ກໍ​ລະ​ນີ​ທີ່​ຜົນ​ຜະ​ລິດ​ການ​ບັນ​ທຶກ​ຄວນ​ຈະ​ໄດ້​ຮັບ​ການ​ລາຍ​ລັກ​ອັກ​ສອນ (ທາງ​ເລືອກ​ທີ່​ມີ​ການ​ຫມຸນ logfile​)​.
ກັບ syslog (Unix) ຫຼືບັນທຶກເຫດການ (Windows) ທາງເລືອກ --log-config ສາມາດນໍາໃຊ້ໄດ້. ນີ້
ໄຟລ​໌​ການ​ຕັ້ງ​ຄ່າ​ຍັງ​ອະ​ນຸ​ຍາດ​ໃຫ້​ສໍາ​ລັບ​ການ​ຊີ້​ນໍາ​ພຽງ​ແຕ່​ຂໍ້​ຄວາມ​ສະ​ເພາະ​ໃດ​ຫນຶ່ງ​ກັບ​ຜົນ​ຜະ​ລິດ​ສະ​ເພາະ​ໃດ​ຫນຶ່ງ​
stream ແລະສໍາລັບການກັ່ນຕອງຂໍ້ຄວາມສະເພາະໃດຫນຶ່ງໂດຍອີງໃສ່ໂມດູນຫຼືຄໍາຮ້ອງສະຫມັກທີ່ເຂົາເຈົ້າ
ຖືກສ້າງຂື້ນ. ໄຟລ໌ການຕັ້ງຄ່າຕົວຢ່າງແມ່ນສະຫນອງໃຫ້ຢູ່ໃນ /logger.cfg.

ຄໍາສັ່ງ LINE

ເຄື່ອງມືບັນທັດຄໍາສັ່ງໃຊ້ຫມາຍເຫດຕໍ່ໄປນີ້ສໍາລັບພາລາມິເຕີ: ວົງເລັບສີ່ຫລ່ຽມປິດລ້ອມ
ຄ່າທາງເລືອກ (0-1), ສາມຈຸດຕໍ່ທ້າຍຊີ້ໃຫ້ເຫັນວ່າຫຼາຍຄ່າຖືກອະນຸຍາດ
(1-n), ການປະສົມປະສານຂອງທັງສອງຫມາຍຄວາມວ່າຄ່າ 0 ຫາ n.

ຕົວເລືອກແຖວຄໍາສັ່ງຖືກຈໍາແນກຈາກພາລາມິເຕີໂດຍເຄື່ອງຫມາຍ '+' ຫຼື '-' ຊັ້ນນໍາ,
ຕາມລໍາດັບ. ປົກກະຕິແລ້ວ, ຄໍາສັ່ງແລະຕໍາແຫນ່ງຂອງທາງເລືອກເສັ້ນຄໍາສັ່ງແມ່ນ arbitrary (ie ເຂົາເຈົ້າ
ສາມາດປາກົດຢູ່ບ່ອນໃດກໍໄດ້). ຢ່າງໃດກໍຕາມ, ຖ້າທາງເລືອກແມ່ນສະເພາະເຊິ່ງກັນແລະກັນ, ລັກສະນະທີ່ຖືກຕ້ອງທີ່ສຸດ
ຖືກນໍາໃຊ້. ພຶດຕິກໍານີ້ສອດຄ່ອງກັບກົດລະບຽບການປະເມີນຜົນມາດຕະຖານຂອງຫອຍ Unix ທົ່ວໄປ.

ນອກຈາກນັ້ນ, ໄຟລ໌ຄໍາສັ່ງຫນຶ່ງຫຼືຫຼາຍສາມາດຖືກກໍານົດໂດຍໃຊ້ເຄື່ອງຫມາຍ '@' ເປັນຄໍານໍາຫນ້າ
ຊື່ໄຟລ໌ (ເຊັ່ນ @command.txt). ການໂຕ້ຖຽງຄໍາສັ່ງດັ່ງກ່າວຖືກແທນທີ່ດ້ວຍເນື້ອໃນຂອງ
ໄຟລ໌ຂໍ້ຄວາມທີ່ສອດຄ້ອງກັນ (ຫຼາຍຊ່ອງຫວ່າງຖືກປະຕິບັດເປັນຕົວແຍກດຽວເວັ້ນເສຍແຕ່
ພວກມັນປາກົດຢູ່ລະຫວ່າງສອງເຄື່ອງໝາຍວົງຢືມ) ກ່ອນການປະເມີນຕື່ມອີກ. ກະລຸນາສັງເກດວ່າ
ໄຟລ໌ຄໍາສັ່ງບໍ່ສາມາດມີໄຟລ໌ຄໍາສັ່ງອື່ນ. ວິທີການງ່າຍດາຍແຕ່ປະສິດທິຜົນນີ້
ອະ​ນຸ​ຍາດ​ໃຫ້​ຫນຶ່ງ​ເພື່ອ​ສະ​ຫຼຸບ​ການ​ປະ​ສົມ​ທົ່ວ​ໄປ​ຂອງ​ທາງ​ເລືອກ / ຕົວ​ກໍາ​ນົດ​ການ​ແລະ​ຫຼີກ​ເວັ້ນ​ການ​ຍາວ​ແລະ​
ເສັ້ນຄໍາສັ່ງທີ່ສັບສົນ (ຕົວຢ່າງແມ່ນສະຫນອງໃຫ້ຢູ່ໃນໄຟລ໌ /dumppat.txt).

ENVIRONMENT

ໄດ້ xml2dcm ຜົນປະໂຫຍດຈະພະຍາຍາມໂຫຼດຂໍ້ມູນວັດຈະນານຸກົມ DICOM ທີ່ລະບຸໄວ້ໃນ
DCMDICTPATH ສະພາບແວດລ້ອມປ່ຽນແປງ. ໂດຍຄ່າເລີ່ມຕົ້ນ, ie ຖ້າ DCMDICTPATH ຕົວແປສິ່ງແວດລ້ອມ
ບໍ່ໄດ້ຕັ້ງ, ໄຟລ໌ /dicom.dic ຈະຖືກໂຫຼດເວັ້ນເສຍແຕ່ຈະນານຸກົມຖືກສ້າງຂຶ້ນ
ເຂົ້າໄປໃນແອັບພລິເຄຊັນ (ຄ່າເລີ່ມຕົ້ນສໍາລັບ Windows).

ພຶດຕິກໍາໃນຕອນຕົ້ນຄວນຈະເປັນທີ່ມັກແລະ DCMDICTPATH ຕົວແປສະພາບແວດລ້ອມເທົ່ານັ້ນ
ໃຊ້ໃນເວລາທີ່ຕ້ອງການວັດຈະນານຸກົມຂໍ້ມູນທາງເລືອກ. ໄດ້ DCMDICTPATH ຕົວແປສິ່ງແວດລ້ອມ
ມີຮູບແບບດຽວກັນກັບ Unix shell PATH ຕົວແປໃນຈໍ້າສອງເມັດ (':') ແຍກ
ລາຍການ. ໃນລະບົບ Windows, ເຄື່ອງໝາຍຈຸດ (';') ຖືກໃຊ້ເປັນຕົວແຍກ. ວັດຈະນານຸກົມຂໍ້ມູນ
ລະຫັດຈະພະຍາຍາມໂຫລດແຕ່ລະໄຟລ໌ທີ່ລະບຸໄວ້ໃນ DCMDICTPATH ສະພາບແວດລ້ອມປ່ຽນແປງ. ມັນ
ເປັນຂໍ້ຜິດພາດຖ້າບໍ່ມີວັດຈະນານຸກົມຂໍ້ມູນສາມາດໂຫລດໄດ້.

ໃຊ້ xml2dcm ອອນໄລນ໌ໂດຍໃຊ້ບໍລິການ onworks.net