img2dcm - Online sa Cloud

PROGRAMA:

NAME

img2dcm - I-convert ang mga karaniwang format ng imahe sa DICOM na format

SINOPSIS

img2dcm [mga opsyon] imgfile-in dcmfile-out

DESCRIPTION

Ang img2dcm nagsisilbing tool ng conversion mula sa karaniwang format ng larawan tulad ng JPEG o BMP
sa DICOM. Maaaring pumili ng iba't ibang Output SOP Classes. Ang karagdagang impormasyon
(tungkol sa mga pasyente, serye, atbp.) na nakaimbak sa DICOM output file ay maaaring makuha mula sa
iba pang DICOM file na nagsisilbing 'template' para sa resultang DICOM object. img2dcm maaari
i-configure din para mag-imbento ng nawawalang DICOM type 1 at type 2 na attribute para gumana kahit na
nang walang anumang dataset ng template.

MGA PARAMETERS

imgfile-in na file ng imahe na mai-import

dcmfile-out DICOM output file

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
pangkalahatan:

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

-df --dataset-from [f]ilename: string
gumamit ng dataset mula sa DICOM file f

-stf --study-from [f]ilename: string
basahin ang pasyente/pag-aaral mula sa DICOM file f

-sef --series-from [f]ilename: string
basahin ang pasyente/pag-aaral/serye mula sa DICOM file f

-ii --instance-inc
dagdagan ang instance number na nabasa mula sa DICOM file

JPEG format:

-dp --disable-progr
huwag paganahin ang suporta para sa progresibong JPEG

-de --disable-ext
huwag paganahin ang suporta para sa pinalawig na sequential JPEG

-jf --ipilit-sa-jfif
igiit ang pagkakaroon ng header ng JFIF

-ka --keep-appn
panatilihin ang mga seksyon ng APPn (maliban sa JFIF)

pagproseso pagpipilian
pagsusuri ng katangian:

--do-check
paganahin ang pagsuri sa bisa ng katangian (default)

--walang mga tseke
huwag paganahin ang pagsusuri ng bisa ng katangian

+i2 --insert-type2
ipasok ang nawawalang uri 2 na mga katangian (default)
(may --do-checks lang)

-i2 --no-type2-insert
huwag ipasok ang mga nawawalang uri 2 na katangian
(may --do-checks lang)

+i1 --invent-type1
mag-imbento ng mga nawawalang uri 1 na katangian
(may --do-checks lang)

-i1 --no-type1-invent
huwag mag-imbento ng mga nawawalang uri 1 na katangian
(may --do-checks lang)

set ng character:

+l1 --latin1
itakda ang latin-1 bilang karaniwang set ng character (default)

-l1 --no-latin1
panatilihin ang 7-bit na ASCII bilang karaniwang set ng character

iba pang mga opsyon sa pagproseso:

-k --key [k]ey: gggg,eeee="str", pangalan ng path o diksyunaryo="str"
magdagdag ng karagdagang katangian

output pagpipilian
target na klase ng SOP:

-sc --sec-capture
sumulat ng Secondary Capture SOP class

-nsc --bagong-sc
sumulat ng mga bagong klase sa Secondary Capture SOP

-vlp --vl-larawan
isulat ang Visible Light Photographic SOP class (default)

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

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-off
walang padding (implicit kung --write-dataset)

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

NOTA

katangian Pinagmumulan ng
Para sa pag-convert ng pangkalahatang format ng imahe sa DICOM na format, ang img2dcm aplikasyon ay maaaring
pinapakain ng ilang karagdagang input para sa pagpuno ng mandatory (at opsyonal) na mga katangian sa bago
DICOM file tulad ng impormasyon ng pasyente, pag-aaral at serye. Maaaring kolektahin ang impormasyong ito
gamit ang iba't ibang mga diskarte, na maaaring pagsamahin at inilalapat sa file ng resulta sa
ang sumusunod na pagkakasunud-sunod:

· Gamit ang --dataset-mula sa opsyon img2dcm ay napipilitang mag-import ng mga katangian mula sa isang umiiral na
DICOM file. Ang ibinigay na DICOM file ay ganap na na-import at nagsisilbing batayan para sa lahat
karagdagang mga operasyon sa pag-export. Bilang pagbubukod, ang SOP Instance UID ay hindi kinokopya nito
opsyon. Gayundin, ang data na nauugnay sa larawan tulad ng Mga Row, Column atbp. ay ipinagpapalit sa panahon ng conversion.
Tandaan na ang img2dcm hindi sinusuri ang anumang iba pang mga halaga ng katangian para sa bisa, hal
huwag tumingin sa mga pagkakasunud-sunod upang iakma ang anumang mga katangian sa bagong bagay (mga isinangguni na larawan
atbp.). Samakatuwid, inirerekomendang gamitin ang mga template sa direktoryo ng data para sa (luma)
Mga bagay sa SC at VLP. Tingnan din ang seksyong 'Mga Template ng Input'.
· Ang --pag-aaral-mula sa at --serye-mula sa ang mga opsyon (mutual exclusive) ay maaaring gamitin sa pag-import
pasyente, pag-aaral at serye ng impormasyon mula sa isang umiiral na DICOM file. Kung --serye-mula sa is
tinukoy, pagkatapos ang ibinigay na DICOM file ay binuksan ni img2dcm at lahat ng ipinag-uutos na impormasyon
pababa sa antas ng serye ay na-import. Tandaan na kasama dito ang pasyente, pag-aaral at serye
impormasyon. Kung sakali --pag-aaral-mula sa, ang impormasyon ng serye ay hindi kasama. Ang mga sumusunod
kinuha ang mga katangian:
Antas ng Pasyente:
Pangalan ng Pasyente
ID ng pasyente
Kasarian ng Pasyente
Petsa ng Kapanganakan ng Pasyente
Partikular na Set ng Character

Antas ng Pag-aaral:
Study Instance UID
Petsa ng Pag-aaral
Oras ng pag-aaral
Nagre-refer sa Pangalan ng Doktor
ID ng Pag-aaral
Numero ng Accession

Antas ng Serye (sa kaso lamang ng opsyon --series-from):
Serye ng Instance UID
Numero ng Serye
tagagawa
· Kasama ang --insert-type2 at --invent-type1 mga opsyon (parehong pinagana bawat default), nawawala
mga attribute (type 2 attributes) at/o nawawalang attribute values ​​(para sa type 1 attributes)
ay awtomatikong idinaragdag at naimbento ng img2dcm. Pakitandaan na ang mga opsyon na ito ay tanging
sinusuri kung opsyon --do-check ay pinagana (default). Kung ang --walang mga tseke ang mga pagpipilian ay
pinagana, walang awtomatikong paglalagay ng attribute na magaganap.
· Ang --susi ang opsyon ay maaaring gamitin upang magdagdag ng karagdagang mga katangian sa DICOM output file. Ito
ang opsyon ay inilapat sa pinakadulo, bago i-save ang DICOM file. Ito ay din
posibleng tukuyin ang mga sequence, item at nested attribute gamit ang --susi opsyon. Sa
sa mga kasong ito, kailangang gumamit ng espesyal na notasyon ng 'path'. Ang mga detalye sa notasyon ng landas na ito ay maaaring
ay makikita sa dokumentasyon ng dcmodify.
Mga UID
Ang mga bagong Study at Series Instance UID ay nabuo if kinakailangan pagkatapos ilapat ang --pag-aaral-
mula at --serye mga pagpipilian. Kung wala ang Study Instance UID o Series Instance UID
pagkatapos ng mga hakbang na ito, ang mga ito ay bagong nabuo, hiwalay sa isa't isa. Isang kabaligtaran
Ang pag-uugali ay pinili para sa SOP Instance UID na maaaring asahan ng isang tao na kukunin kung kailan
gamit ang --dataset-mula sa opsyon. Ito ay hindi ang kaso, ang SOP Instance UID ay hindi kinopya
sa bagong bagay. Ito dapat ang kanais-nais na pag-uugali para sa karamihan ng mga kaso ng paggamit. Gayunpaman, kung a
ilang SOP Instance UID ay dapat na ipasok sa bagong bagay, ang --susi opsyon dapat
magamit.
input Template
Para sa pagsuporta sa conversion sa DICOM, img2dcm ay may kasamang ilang paunang natukoy na mga template
na maaaring gamitin para sa --dataset-mula sa opsyon (tingnan ang mga sample na file SC.dump at VLP.dump).
Ang mga template na ito ay dapat punan ng mga nais na halaga at pagkatapos ay dapat itapon
(na-convert) sa isang DICOM file bago aktwal na gamitin sa img2dcm. Gamitin dump2dcm sa
i-convert ang dump sa DICOM. Halimbawa:
dump2dcm SC.dump SC.dcm

Posibleng gumamit ng anumang DICOM file bilang template. Mangyaring tandaan na ang kumpletong DICOM
ang dataset ay na-import; samakatuwid, dapat itong makatiyak na ang mga katangian lamang ang naroroon
dapat ay bahagi ng constructed DICOM object. Ang SOP Class UID at ang Pixel Data
ang mga attribute (kabilang ang mga attribute tulad ng Rows, Column atbp.) ay hindi kinokopya ngunit pinapalitan ng
img2dcm sa panahon ng conversion.
input Plugins
Ang img2dcm kasalukuyang sinusuportahan ng application ang JPEG at ang BMP na format ng imahe bilang input.
JPEG input Isaksak
Para sa JPEG, ang orihinal na JPEG mula sa source file ay hindi na-decode ngunit na-extract at bahagyang
binago (hal. JFIF header ay pinutol) upang payagan ang mabilis na conversion ng kahit malalaking JPEG file
nang hindi nangangailangan ng pag-decode at muling pag-encode. Pinipili ng JPEG plugin ang kinakailangang output
awtomatikong ilipat ang syntax depende sa aktwal na pag-encode ng data sa loob ng JPEG
file. Samakatuwid, ang mga sumusunod na Transfer Syntax (at ang kanilang kaukulang JPEG encodings)
ay ginagamit ng JPEG plugin:
· Proseso ng JPEG Coding 1 Baseline, Lossy, Non-Hierarchical, Sequential, DCT, Huffman, 8 Bit
Klase ng SOP = 1.2.840.10008.1.2.4.50
· Proseso ng JPEG Coding 2 (8-bit) at 4 (12-bit) Extended, Lossy, Non-Hierarchical,
Sequential, DCT, Huffman, 8/12 Bit SOP Class = 1.2.840.10008.1.2.4.51
· Proseso ng JPEG Coding 10 (8-bit) at 12 (12-bit) na Buong Pag-unlad, lossy, Non-Hierarch.,
Progressive, DCT, Huffman, 8/12 Bit SOP Class = 1.2.840.10008.1.2.4.55
Ang mga kulay at grayscale na imahe ay suportado.
Ang suporta para sa Extended JPEG Transfer Syntax ay maaaring hindi paganahin (--disable-ext option)
pati na rin ang suporta para sa (retirado) Progressive JPEG Transfer Syntax (--disable-progr
pagpipilian).
JPEG lossless encoding pati na rin ang anumang arithmetic o hierarchical JPEG encoding mode ay
hindi suportado ng plugin.
Pinapadali ng impormasyon ng JFIF (JPEG File Interchange Format) ang mga opsyonal na APPn marker sa a
JPEG file. Maraming mga digital camera ang hindi nagsasama ng naturang impormasyon ng JFIF sa JPEG
output na kanilang nilikha. Halimbawa, ang JFIF ay naglalaman ng impormasyon tungkol sa pixel aspect ratio ng
ang naka-compress na imahe. Kung gusto mo ang img2dcm application upang igiit ang isang JFIF header in
ang JPEG stream, maaari mong gamitin ang opsyon --pagpilitan-sa-jfif na magpapalaglag kung walang JFIF
mahahanap ang impormasyon. Bilang default, ang nawawalang impormasyon ng JFIF ay binabalewala.
Para sa DICOM ito ay uri ng isang 'gray zone', kung ang pagsasama ng JFIF (o anumang iba pang APPn)
ang data sa panloob na JPEG stream ng object ng DICOM ay pinapayagan o hindi. Gayunpaman, ang karamihan
Ang maaasahang diskarte ay upang putulin ang mga marker na iyon at ang kanilang impormasyon mula sa stream ng JPEG. Ito
diskarte ay kinuha din ng img2dcm aplikasyon. Bilang default, lahat ng APPn marker ay pinutol
mula sa orihinal na stream ng JPEG. Gayunpaman, kung gusto mong panatilihin ang iba pang mga APPn marker kaysa sa
JFIF (eg EXIF ​​information) sa loob ng DICOM stream, ang opsyon --keep-appn ay ang
panlilinlang. Dapat din itong bahagyang mas mabilis kaysa sa pagputol ng impormasyon ng APPn, dahil ito nga
hindi kinakailangang i-scan ang buong JPEG stream para sa naturang data. Ang impormasyon ng JFIF ay palagi
inalis ng img2dcm.
BMP input Isaksak
img2dcm Sinusuportahan ang BMP bilang format ng pag-input. Gayunpaman, sa ngayon ay ang pinakakaraniwang BMP na mga imahe lamang
suportado. Sa partikular, ang mga BMP na imahe na gumagamit ng mga bitfield o run length encoding ay magiging
tinanggihan. Ang mga ganitong larawan ay hindi pangkaraniwan. Ang lahat ng input na imahe ay mako-convert sa isang DICOM na imahe
na may modelo ng kulay ng RGB at medyo depth na 24. Walang mga partikular na opsyon para sa fine-tuning
Pag-convert ng BMP format.
Pagbubuhos Plugins
Ang nais na output SOP Class ay maaaring mapili sa command line. Sa kasalukuyan, isang pag-export
plugin para sa klase ng Secondary Capture Image SOP (default, opsyon -sc), ang bagong Sekundarya
Kumuha ng mga klase ng SOP ng Imahe (opsyon -nsc) at Visible Light Photographic Image SOP na klase
(pagpipilian -vl) ay magagamit. Pakitandaan na ang una ay hindi na ginagamit ayon sa
DICOM standard ngunit pinili bilang default dahil malawak itong sinusuportahan. kinabukasan
mga bersyon ng img2dcm maaaring magbigay ng karagdagang output plugin para sa iba pang SOP Classes.
Para sa mga bagong klase ng Secondary Capture SOP, hindi posibleng tukuyin kung aling partikular
Ang klase ng SOP ay dapat gamitin para sa output. Iyon ay dahil ang mga bagong SOP na klase ay
naiiba sa bawat isa sa pamamagitan ng lalim ng kulay (1/8/16) at ang katotohanan kung ang imahe ay
itim/puti o kulay. Kaya naman img2dcm nagpapasya sa panahon ng conversion, kung aling output SOP
Ang klase ay angkop para sa isang ibinigay na pinagmulang larawan.

HALIMBAWA

Narito ang ilang mga halimbawa na nagpapakita kung paano ang img2dcm maaaring gamitin ang application.
1. img2dcm image.jpg out.dcm
Basahin ang JPEG file na 'image.jpg', i-convert sa lumang Secondary Capture SOP class at i-save
ang resulta sa DICOM file na 'out.dcm'. Ito ang pinakamadaling paraan ng paggamit img2dcm. Kahit anong uri
1 at type 2 na mga katangian na kinakailangan para sa pagsulat ng mga wastong bagay ng klase ng SOP na ito ay
awtomatikong ipinasok.
2. img2dcm -i BMP image.bmp out.dcm
Pareho sa itaas ngunit nagsasabi sa img2dcm na magbasa ng BMP file sa halip na JPEG.
3. img2dcm image.jpg out.dcm -vlp -k 'PatientName=Bond^James'
Pareho sa unang halimbawa, ngunit isinusulat ang Visible Light Photographic Image object sa 'out.dcm'
at itinatakda ang PatientName sa 'Bond^James' na kung hindi ay maiiwanang walang laman.
4. img2dcm image.jpg out.dcm --series-from template.dcm -k 'PatientName=Bond^James'
Pareho sa 1), ngunit nag-import ng impormasyon ng pasyente/pag-aaral/serye mula sa DICOM file
'template.dcm'. Pakitandaan na ang attribute na PatientName ay maglalaman ng 'Bond^James' sa
sa dulo, ang anumang halaga mula sa 'template.dcm' ay mapapatungan. Iyon ay, dahil ang -k
inilapat ang opsyon sa pinakadulo ng pipeline ng conversion (tingnan sa itaas).
5. img2dcm image.jpg out.dcm --no-checks
Pareho sa 1), ngunit hindi nagsasagawa ng anumang pagsusuri sa katangian at walang uri 1 at uri 2
paglalagay ng katangian! Kaya sa kasong ito, isang di-wastong bagay na DICOM ang bubuo. Ito
maaaring maging kawili-wili kung ang output file ay hindi sinadya upang makumpleto ngunit sasailalim
karagdagang pagbabago, hal. pagdaragdag ng mga katangian gamit dcmodify. Gamitin lamang ang opsyon --hindi-
checks kung alam mo ang ginagawa mo!
6. img2dcm image.jpg out.dcm --no-type1-invent
Kapareho ng 1), ngunit hindi naglalagay ng nawawalang uri 1 na mga katangian at/o ang kanilang mga halaga. Uri 2
ilalagay ang mga katangian. Tandaan na sa kasong ito dapat makatiyak na ang lahat ng uri 1
ang mga katangian ay ibinibigay sa pamamagitan ng iba pang paraan, ibig sabihin, sa pamamagitan ng pagdaragdag sa kanila ng --susi pagpipilian.
Kung hindi, img2dcm mag-uulat ng error at hihinto sa pagko-convert.
7. img2dcm image.jpg out.dcm --keep-appn --insist-on-jfif
Pareho sa 1), ngunit kinukuha ang impormasyon ng APPn tulad ng EXIF ​​sa object ng DICOM
nagreresultang JPEG stream. Dagdag pa, --pagpilitan-sa-jfif pipilitin img2dcm i-abort kung hindi
Ang impormasyon ng JFIF ay umiiral sa source file.

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 img2dcm 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 img2dcm online gamit ang mga serbisyo ng onworks.net