xml2dcm - Online sa Cloud

PROGRAMA:

NAME

xml2dcm - I-convert ang XML na dokumento sa DICOM file o set ng data

SINOPSIS

xml2dcm [mga opsyon] xmlfile-in dcmfile-out

DESCRIPTION

Ang xml2dcm Kino-convert ng utility ang mga nilalaman ng isang XML (Extensible Markup Language) na dokumento
sa DICOM file o data set. Ang XML na dokumento ay inaasahang magpapatunay laban sa DTD
(Kahulugan ng Uri ng Dokumento) na inilarawan sa file dcm2xml.dtd. Isang naaangkop na XML file
maaaring malikha gamit ang dcm2xml tool (pagpipilian +Wb inirerekomenda na isama ang binary data).

MGA PARAMETERS

xmlfile-in XML input filename na iko-convert (stdin: "-")

dcmfile-out DICOM output filename

Opsyon

pangkalahatan pagpipilian
-h --tulong
i-print ang text ng tulong na ito at lumabas

--bersyon
impormasyon ng bersyon ng pag-print at paglabas

--mga argumento
i-print ang pinalawak na mga argumento ng command line

-q --tahimik
quiet mode, walang mga babala at error sa pag-print

-v --verbose
verbose mode, mga detalye ng pagproseso ng pag-print

-d --debug
debug mode, i-print ang impormasyon ng debug

-ll --log-level [l]evel: string constant
(fatal, error, babala, impormasyon, debug, trace)
gumamit ng level l para sa logger

-lc --log-config [f]ilename: string
gumamit ng config file f para sa logger

input pagpipilian
format ng input file:

+f --read-meta-info
basahin ang impormasyon ng meta kung naroroon (default)

-f --ignore-meta-info
huwag pansinin ang impormasyon ng meta ng file

pagproseso pagpipilian
pagpapatunay:

+Vd --validate-document
patunayan ang XML na dokumento laban sa DTD

+Vn --check-namespace
suriin ang XML namespace sa root ng dokumento

natatanging identifier:

+Ug --generate-new-uids
bumuo ng bagong Study/Series/SOP Instance UID

-Uo --huwag-overwrite-uids
huwag i-overwrite ang mga umiiral nang UID (default)

+Uo --overwrite-uids
i-overwrite ang mga kasalukuyang UID

output pagpipilian
format ng output file:

+F --write-file
sumulat ng format ng file (default)

-F --write-dataset
magsulat ng set ng data nang walang impormasyon sa meta ng file

+Fu --update-meta-info
i-update ang partikular na impormasyon ng meta file

syntax ng paglilipat ng output:

+t= --write-xfer-same
magsulat ng parehong TS bilang input (default)

+te --write-xfer-little
magsulat gamit ang tahasang VR little endian TS

+tb --write-xfer-big
magsulat gamit ang tahasang VR big endian TS

+ti --write-xfer-implicit
magsulat gamit ang implicit na VR little endian TS

+td --write-xfer-deflated
magsulat gamit ang deflated tahasang VR little endian TS

mga representasyon ng halaga pagkatapos ng 1993:

+u --enable-new-vr
paganahin ang suporta para sa mga bagong VR (UN/UT) (default)

-u --disable-new-vr
huwag paganahin ang suporta para sa mga bagong VR, i-convert sa OB

pag-encode ng haba ng pangkat:

+g= --group-length-recalc
muling kalkulahin ang mga haba ng pangkat kung naroroon (default)

+g --grupo-haba-lumikha
palaging magsulat gamit ang mga elemento ng haba ng pangkat

-g --grupo-haba-alisin
palaging sumulat nang walang mga elemento ng haba ng pangkat

haba ng pag-encode sa mga sequence at item:

+e --length-explicit
sumulat nang may tahasang haba (default)

-e --haba-hindi natukoy
sumulat ng hindi natukoy ang mga haba

data set trailing padding (hindi kasama ang --write-dataset):

-p= --padding-retain
huwag baguhin ang padding (default kung hindi --write-dataset)

-p --padding-off
walang padding (implicit kung --write-dataset)

+p --padding-create [f]ile-pad [i]tem-pad: integer
align file sa maramihang mga f byte at mga item sa
maramihang i bytes

deflate antas ng compression (lamang na may --write-xfer-deflated):

+cl --compression-level [l]evel: integer (default: 6)
0=hindi naka-compress, 1=pinakamabilis, 9=pinakamahusay na compression

NOTA

Ang pangunahing istraktura ng XML input na inaasahan ay ganito ang hitsura ng sumusunod:



<file-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" loaded="no" binary="hidden">




Ang 'file-format' at 'meta-header' na mga tag ay maaaring wala para sa DICOM data set.

Katangian Pag-encode
Ang DICOM character encoding ay awtomatikong tinutukoy mula sa elementong may tag
'0008,0005' (Specific Character Set) - kung naroroon. Ang mga sumusunod na set ng character ay
kasalukuyang sinusuportahan (nangangailangan libxml upang isama iconv suporta, tingnan --bersyon output):

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)
Arabic "ISO_IR 127" (ISO-8859-6)
Griyego "ISO_IR 126" (ISO-8859-7)
Hebrew "ISO_IR 138" (ISO-8859-8)

Hindi sinusuportahan ang maraming hanay ng character (ang unang halaga lamang ng 'Tiyak na Karakter
Set' ay ginagamit para sa pag-encode ng character sa kaso ng pagpaparami ng halaga).

Tingnan dcm2xml dokumentasyon para sa higit pang mga detalye sa istruktura ng XML.

binary data
Maaaring i-encode ang binary data bilang isang sequence ng mga hex na numero na pinaghihiwalay ng backslash
'\' o sa Base64 na format (binary='base64'). Bilang karagdagan, ang binary data ay maaari ding basahin mula sa
file (binary='file'). Sa kasong ito, kailangang tukuyin ang filename bilang halaga ng elemento,
hal

subdir/pixeldata.raw

Pakitandaan na ang mga nilalaman ng file ay babasahin kung ano. Ang data ng OW ay inaasahang magiging
maliit na endian ang inorder at papalitan kung kinakailangan. Walang gagawing pagsusuri upang matiyak
na ang dami ng data ay makatwiran sa mga tuntunin ng iba pang mga katangian gaya ng Rows o
Mga Haligi.

Pagpiga
Kung ang libxml ay pinagsama-sama sa suporta ng zlib, ang input file (xmlfile-in) ay maaari ding maging
naka-compress sa ZIP, na kadalasang nagreresulta sa mas maliliit na file. Tingnan ang output ng opsyon
--bersyon para masuri kung available ang zlib support.

Mga hangganan
Maaaring may iba't ibang limitasyon ang iba't ibang bersyon ng libxml para sa maximum na haba ng isang XML
halaga ng elemento. Samakatuwid, dapat itong iwasan na gumamit ng napakahabang halaga ng elemento (hal para sa
data ng pixel).

Mangyaring tandaan na ang xml2dcm kasalukuyang hindi ganap na sumusuporta sa DICOMDIR file. Sa partikular,
hindi awtomatikong ina-update ng tool na ito ang halaga ng iba't ibang elemento ng offset data.

PAGTOTROSO

Ang antas ng pag-log output ng iba't ibang command line tool at pinagbabatayan na mga aklatan ay maaaring
matukoy ng gumagamit. Bilang default, mga error at babala lamang ang isinulat sa pamantayan
stream ng error. Paggamit ng opsyon --verbose gayundin ang mga mensaheng nagbibigay-kaalaman tulad ng mga detalye ng pagproseso
ay iniulat. Pagpipilian --debug maaaring magamit upang makakuha ng higit pang mga detalye sa panloob na aktibidad,
hal para sa mga layunin ng pag-debug. Maaaring mapili ang iba pang antas ng pag-log gamit ang opsyon --log-
antas. Sa --tahimik mode na mga fatal error lang ang naiulat. Sa gayong napakatinding error na mga kaganapan,
karaniwang wawakasan ang aplikasyon. Para sa higit pang mga detalye sa iba't ibang antas ng pag-log,
tingnan ang dokumentasyon ng module na 'oflog'.

Kung sakaling ang output ng pag-log ay dapat isulat sa file (opsyonal na may pag-ikot ng logfile),
sa syslog (Unix) o sa event log (Windows) na opsyon --log-config maaaring gamitin. Ito
Ang configuration file ay nagbibigay-daan din sa pagdidirekta lamang ng ilang mga mensahe sa isang partikular na output
stream at para sa pag-filter ng ilang mga mensahe batay sa module o application kung saan sila
ay nabuo. Isang halimbawang configuration file ang ibinigay sa /logger.cfg.

COMMAND LINE

Ginagamit ng lahat ng tool sa command line ang sumusunod na notasyon para sa mga parameter: nakalakip ang mga square bracket
mga opsyonal na halaga (0-1), ang tatlong trailing na tuldok ay nagpapahiwatig na maraming mga halaga ang pinapayagan
(1-n), ang kumbinasyon ng pareho ay nangangahulugang 0 hanggang n mga halaga.

Ang mga opsyon sa command line ay nakikilala mula sa mga parameter sa pamamagitan ng isang nangungunang tanda na '+' o '-',
ayon sa pagkakabanggit. Karaniwan, ang pagkakasunud-sunod at posisyon ng mga pagpipilian sa command line ay arbitrary (ibig sabihin, sila
maaaring lumitaw kahit saan). Gayunpaman, kung ang mga pagpipilian ay kapwa eksklusibo ang pinakatamang hitsura
Ginagamit. Ang pag-uugali na ito ay umaayon sa karaniwang mga panuntunan sa pagsusuri ng mga karaniwang shell ng Unix.

Bilang karagdagan, ang isa o higit pang mga command file ay maaaring tukuyin gamit ang isang '@' sign bilang prefix sa
ang filename (hal @command.txt). Ang nasabing command argument ay pinapalitan ng nilalaman ng
ang kaukulang text file (maraming mga whitespace ay itinuturing bilang isang solong separator maliban kung
lumilitaw ang mga ito sa pagitan ng dalawang panipi) bago ang anumang karagdagang pagsusuri. Mangyaring tandaan na
ang isang command file ay hindi maaaring maglaman ng isa pang command file. Ang simple ngunit epektibong diskarte na ito
nagbibigay-daan sa isa na ibuod ang mga karaniwang kumbinasyon ng mga opsyon/parameter at iniiwasan ang longish at
nakalilitong mga linya ng utos (isang halimbawa ay ibinigay sa file /dumppat.txt).

Kapaligiran

Ang xml2dcm susubukan ng utility na i-load ang mga diksyunaryo ng data ng DICOM na tinukoy sa
DCMDICTPATH variable ng kapaligiran. Bilang default, ibig sabihin, kung ang DCMDICTPATH variable ng kapaligiran
ay hindi nakatakda, ang file /dicom.dic ilo-load maliban kung ang diksyunaryo ay binuo
sa application (default para sa Windows).

Ang default na gawi ay dapat na mas gusto at ang DCMDICTPATH variable ng kapaligiran lamang
ginagamit kapag ang mga alternatibong diksyunaryo ng data ay kinakailangan. Ang DCMDICTPATH variable ng kapaligiran
ay may parehong format tulad ng Unix shell PATH variable na ang isang colon (':') ay naghihiwalay
mga entry. Sa mga system ng Windows, ang isang semicolon (';') ay ginagamit bilang isang separator. Ang diksyunaryo ng data
susubukan ng code na i-load ang bawat file na tinukoy sa DCMDICTPATH variable ng kapaligiran. Ito
ay isang error kung walang ma-load na diksyunaryo ng data.

Gumamit ng xml2dcm online gamit ang mga serbisyo ng onworks.net