img2dcm - Online în cloud

PROGRAM:

NUME

img2dcm - Convertiți formatele standard de imagine în format DICOM

REZUMAT

img2dcm [opțiuni] imgfile-in dcmfile-out

DESCRIERE

img2dcm instrumentul servește ca instrument de conversie dintr-un format de imagine standard, cum ar fi JPEG sau BMP
către DICOM. Pot fi selectate diferite clase SOP de ieșire. Informațiile suplimentare
(privind pacienți, serii etc.) stocate în fișierul de ieșire DICOM pot fi extrase din
alte fișiere DICOM care servesc drept „șablon” pentru obiectul DICOM rezultat. img2dcm poate să
de asemenea, să fie configurat pentru a inventa atributele DICOM de tip 1 și 2 lipsă pentru a funcționa chiar
fără nici un set de date șablon.

PARAMETRI

fișierul imagine imgfile-in care urmează să fie importat

dcmfile-out fișier de ieșire DICOM

OPŢIUNI

general Opțiuni
-h --ajutor
imprimați acest text de ajutor și ieșiți

--versiune
imprimați informațiile despre versiunea și ieșiți

--argumente
tipăriți argumentele liniei de comandă extinse

-q --liniște
modul silențios, nu imprimați avertismente și erori

-v --verbos
mod verbos, detalii de procesare a tipăririi

-d --debug
modul de depanare, imprimați informațiile de depanare

-ll --log-level [l]evel: constantă șir
(fatal, eroare, avertizare, informații, depanare, urmărire)
utilizați nivelul l pentru logger

-lc --log-config [f]ilename: șir
utilizați fișierul de configurare f pentru logger

intrare Opțiuni
general:

-i --input-format [i]nput format de fișier: șir
formate acceptate: JPEG (implicit), BMP

-df --dataset-from [f]ilename: șir
utilizați setul de date din fișierul DICOM f

-stf --study-from [f]ilename: șir
citiți pacientul/studiul din fișierul DICOM f

-sef --series-from [f]ilename: șir
citiți pacient/studiu/serie din fișierul DICOM f

-ii --instanță-inc
măriți numărul instanței citite din fișierul DICOM

Format JPEG:

-dp --disable-progr
dezactivați suportul pentru JPEG progresiv

-de --disable-ext
dezactivați suportul pentru JPEG secvenţial extins

-jf --insist-on-jfif
insistați asupra existenței antetului JFIF

-ka --keep-appn
păstrați secțiunile APPn (cu excepția JFIF)

prelucrare Opțiuni
verificarea atributelor:

--fa-verificări
activați verificarea validității atributelor (implicit)

--fără-verificări
dezactivați verificarea validității atributelor

+i2 --insert-type2
inserați atributele de tip 2 lipsă (implicit)
(numai cu --do-checks)

-i2 --no-type2-insert
nu introduceți atributele de tip 2 lipsă
(numai cu --do-checks)

+i1 --invent-type1
inventează care lipsesc atributele de tip 1
(numai cu --do-checks)

-i1 --no-type1-invent
nu inventați atributele de tip 1 care lipsesc
(numai cu --do-checks)

set de caractere:

+l1 --latin1
setați latin-1 ca set de caractere standard (implicit)

-l1 --no-latin1
păstrați ASCII pe 7 biți ca set de caractere standard

alte opțiuni de procesare:

-k --key [k]ey: gggg,eeee="str", cale sau nume dicționar="str"
adăugați un alt atribut

producție Opțiuni
clasa SOP țintă:

-sc --sec-captură
scrie clasa secundară SOP Capture

-nsc --new-sc
scrie noi clase secundare SOP Capture

-vlp --vl-foto
scrieți clasa SOP fotografică cu lumină vizibilă (implicit)

format de fișier de ieșire:

+F --write-file
scriere format de fișier (implicit)

-F --write-dataset
scrieți setul de date fără metainformații ale fișierului

codificarea lungimii grupului:

+g= --grup-lungime-recalc
recalculați lungimile grupului dacă există (implicit)

+g --grup-lungime-creare
scrie întotdeauna cu elemente de lungime a grupului

-g --grup-lungime-elimină
scrie întotdeauna fără elemente de lungime a grupului

codificarea lungimii în secvențe și elemente:

+e --lungime-explicit
scrieți cu lungimi explicite (implicit)

-e --lungime-nedefinită
scrie cu lungimi nedefinite

umplutură finală a setului de date (nu cu --write-dataset):

-p --padding-off
fără umplutură (implicit dacă --write-dataset)

+p --padding-create [fi]ile-pad [i]tem-pad: întreg
aliniați fișierul pe multiplu de f octeți
și articole pe mai mulți de i octeți

NOTE

Atribut Surse
Pentru a converti un format general de imagine în format DICOM, img2dcm aplicarea poate fi
alimentat cu unele intrări suplimentare pentru completarea atributelor obligatorii (și opționale) în noul
Fișier DICOM precum informații despre pacient, studiu și serie. Aceste informații pot fi colectate
folosind diferite abordări, care pot fi combinate și aplicate fișierului rezultat în
urmatoarea ordine:

· Folosind --set de date-de la opțiune img2dcm este forțat să importe atribute dintr-un existent
fișier DICOM. Fișierul DICOM dat este complet importat și servește drept bază pentru toate
operațiuni de export ulterioare. Ca o excepție, UID-ul instanței SOP nu este copiat de acesta
opțiune. De asemenea, date legate de imagine, cum ar fi rânduri, coloane etc., sunt schimbate în timpul conversiei.
Rețineți că img2dcm nu verifică nicio altă valoare de atribut pentru valabilitate, de exemplu, o face
nu căutați în secvențe pentru a adapta orice atribute la noul obiect (imagini de referință
etc.). Prin urmare, este recomandat să folosiți șabloanele din directorul de date pentru (vechi)
Obiecte SC și VLP. Consultați și secțiunea „Șabloane de intrare”.
· --studiu-din și --serie-din opțiunile (se exclud reciproc) pot fi folosite pentru a importa
informații despre pacient, studiu și serie dintr-un fișier DICOM existent. Dacă --serie-din is
specificat, apoi fișierul DICOM dat este deschis de img2dcm și toate informațiile obligatorii
este importat până la nivelul seriei. Rețineți că aceasta include pacientul, studiul și seria
informație. In caz de --studiu-din, informațiile de serie sunt excluse. Următoarele
atributele sunt preluate:
Nivelul pacientului:
Numele pacientului
ID pacient
Sexul pacientului
Data nașterii pacientului
Set de caractere specifice

Nivel de studiu:
Studiu UID de instanță
Data studiului
Timp de studiu
Numele medicului de trimitere
ID de studiu
Număr de acces

Nivel de serie (numai în cazul opțiunii --series-from):
UID de instanță de serie
Numărul seriei
Producător
· Cu --insert-type2 și --invent-tip1 opțiuni (ambele activate implicit), lipsesc
atribute (atribute de tip 2) și/sau valori ale atributelor lipsă (pentru atribute de tip 1)
sunt adăugate și inventate automat de img2dcm. Vă rugăm să rețineți că aceste opțiuni sunt doar
evaluat dacă opțiunea --fa-verificări este activat (implicit). Dacă --fără-verificări opțiuni este
activată, nu va avea loc nicio inserare automată a atributelor.
· --cheie opțiunea poate fi utilizată pentru a adăuga alte atribute la fișierul de ieșire DICOM. Acest
opțiunea este aplicată la sfârșit, chiar înainte de a salva fișierul DICOM. Este, de asemenea
este posibil să specificați secvențe, elemente și atribute imbricate folosind --cheie opțiune. În
în aceste cazuri, trebuie utilizată o notație specială „cale”. Detaliile despre această notare a căii pot
se regăsesc în documentația de dcmodify.
UID-uri
Sunt generate noi UID-uri ale instanțelor de studiu și serie if necesar după aplicarea --studiu-
din și --serie Opțiuni. Dacă UID-ul de instanță de studiu sau UID-ul de instanță de serie nu sunt prezente
după acești pași, acestea sunt nou generate, independent unele de altele. Un contrariu
comportamentul este ales pentru UID-ul instanței SOP la care ne-am putea aștepta să fie preluat când
folosind --set de date-de la opțiune. Aceasta este nu În acest caz, UID-ul instanței SOP este nu copiat
la noul obiect. Acesta ar trebui să fie comportamentul de dorit pentru majoritatea cazurilor de utilizare. Cu toate acestea, dacă a
un anumit UID de instanță SOP ar trebui să fie inserat în noul obiect, the --cheie opțiunea ar trebui
fi folosit.
Intrare Șabloane
Pentru a sprijini conversia în DICOM, img2dcm vine cu câteva șabloane predefinite
care poate fi folosit pentru --set de date-de la opțiunea (consultați fișierele exemplu SC.basculă și VLP.dump).
Aceste șabloane trebuie completate cu valorile dorite și apoi trebuie aruncate
(convertit) într-un fișier DICOM înainte de a fi folosit efectiv cu img2dcm. Utilizare dump2dcm la
convertiți dump-ul în DICOM. Exemplu:
dump2dcm SC.dump SC.dcm

Este posibil să utilizați orice fișier DICOM ca șablon. Vă rugăm să rețineți că DICOM complet
setul de date este importat; prin urmare, ar trebui să se asigure că sunt prezente numai atribute care
ar trebui să facă parte din obiectul DICOM construit. UID-ul clasei SOP și datele pixelilor
atributele (inclusiv atribute precum Rânduri, Coloane etc.) nu sunt copiate, ci înlocuite cu
img2dcm în timpul conversiei.
Intrare Plugin-uri
img2dcm aplicația acceptă în prezent formatul de imagine JPEG și BMP ca intrare.
JPEG Intrare Plugin
Pentru JPEG, JPEG original din fișierul sursă nu este decodat, ci extras și ușor
transformat (de exemplu, antetul JFIF este tăiat) pentru a permite conversia rapidă chiar și a fișierelor JPEG mari
fără a fi nevoie de decodare și re-codificare. Pluginul JPEG alege rezultatul necesar
transferă automat sintaxa în funcție de codificarea reală a datelor din interiorul JPEG
fişier. Prin urmare, următoarele sintaxe de transfer (și codificările lor JPEG corespunzătoare)
sunt utilizate de pluginul JPEG:
· Procesul de codare JPEG 1 de bază, cu pierderi, non-ierarhic, secvenţial, DCT, Huffman, 8 biţi
Clasa SOP = 1.2.840.10008.1.2.4.50
· Proces de codare JPEG 2 (8 biți) și 4 (12 biți) extins, cu pierderi, non-ierarhic,
Secvenţial, DCT, Huffman, Clasa SOP 8/12 biţi = 1.2.840.10008.1.2.4.51
· Proces de codare JPEG 10 (8 biți) și 12 (12 biți) Progresie completă, cu pierderi, non-ierarh.,
Progresiv, DCT, Huffman, Clasa SOP 8/12 biți = 1.2.840.10008.1.2.4.55
Imaginile color și în tonuri de gri sunt acceptate.
Suportul pentru Sintaxa de transfer JPEG extinsă poate fi dezactivat (--disable-ext opțiune)
precum și suportul pentru Sintaxa de transfer JPEG progresiv (retras) (--disable-progr
opțiune).
Codarea JPEG fără pierderi, precum și orice mod de codare JPEG aritmetic sau ierarhic sunt
nu este acceptat de plugin.
Informațiile JFIF (JPEG File Interchange Format) facilitează marcatorii opționali APPn în a
Fișier JPEG. Multe camere digitale nu integrează astfel de informații JFIF în JPEG
ieșirea pe care o creează. De exemplu, JFIF conține informații despre raportul de aspect al pixelilor
imaginea comprimată. Daca vrei ca img2dcm aplicație pentru a insista asupra unui antet JFIF în
fluxul JPEG, puteți utiliza opțiunea --insist-on-jfif care va anula dacă nu există JFIF
informatii pot fi gasite. În mod implicit, informațiile JFIF lipsă sunt ignorate.
Pentru DICOM este un fel de „zonă gri”, indiferent dacă este integrarea JFIF (sau orice alt APPn)
datele în fluxul JPEG intern al obiectului DICOM sunt permise sau nu. Cu toate acestea, cel mai mult
abordarea de încredere este să tăiați acești markeri și informațiile lor din fluxul JPEG. Acest
abordarea este adoptată și de către img2dcm aplicarea. În mod implicit, toți markerii APPn sunt tăiați
deconectat de la fluxul JPEG original. Cu toate acestea, dacă doriți să păstrați alți markeri APPn decât
JFIF (de exemplu, informații EXIF) în fluxul DICOM, opțiunea --keep-appn nu
truc. De asemenea, ar trebui să fie puțin mai rapid decât tăierea informațiilor APPn, deoarece este
nu este necesar să scanați întregul flux JPEG pentru astfel de date. Informațiile JFIF sunt mereu
înlăturat de img2dcm.
BMP Intrare Plugin
img2dcm acceptă BMP ca format de intrare. Cu toate acestea, până acum sunt doar cele mai comune imagini BMP
sprijinit. În special, imaginile BMP care utilizează câmpuri de biți sau codificarea lungimii de rulare vor fi
respins. Asemenea imagini sunt neobișnuite. Toate imaginile de intrare vor fi convertite într-o imagine DICOM
cu model de culoare RGB și o adâncime de 24. Nu există opțiuni specifice pentru reglare fină
Conversie format BMP.
producție Plugin-uri
Clasa SOP de ieșire dorită poate fi selectată pe linia de comandă. În prezent, un export
plugin pentru clasa SOP de imagine secundară (implicit, opțiune -sc), noul Secundar
Clasele SOP Capture Image (opțiune -nsc) și clasa SOP de imagine fotografică în lumină vizibilă
(opțiune -vl) Sunt disponibile. Vă rugăm să rețineți că primul este depreciat în conformitate cu
Standard DICOM, dar este selectat ca implicit deoarece este acceptat pe scară largă. Viitor
versiuni de img2dcm ar putea furniza pluginuri de ieșire suplimentare pentru alte clase SOP.
Pentru noile clase SOP de captura secundară, nu este posibil să specificați care anume
Clasa SOP trebuie utilizată pentru ieșire. Asta pentru că aceste noi clase SOP sunt
diferenţiate între ele prin adâncimea culorii (1/8/16) şi faptul dacă imaginea este
alb/negru sau color. Acesta este motivul pentru care img2dcm decide în timpul conversiei care iese SOP
clasa este potrivită pentru o anumită imagine sursă.

EXEMPLE

Iată câteva exemple care arată cum img2dcm aplicația poate fi utilizată.
1. img2dcm imagine.jpg out.dcm
Citiți fișierul JPEG „image.jpg”, convertiți-l în vechea clasă SOP Capture secundară și salvați
rezultatul în fișierul DICOM „out.dcm”. Acesta este cel mai simplu mod de utilizare img2dcm. Orice tip
Atributele 1 și de tip 2 necesare pentru scrierea obiectelor valide din această clasă SOP sunt
introdus automat.
2. img2dcm -i BMP imagine.bmp out.dcm
La fel ca mai sus, dar îi spune img2dcm să citească un fișier BMP în loc de JPEG.
3. img2dcm image.jpg out.dcm -vlp -k „PatientName=Bond^James”
La fel ca primul exemplu, dar scrie obiectul Visible Light Photographic Image în „out.dcm”
și setează PatientName la „Bond^James”, care altfel ar fi lăsat gol.
4. img2dcm image.jpg out.dcm --series-from template.dcm -k 'PatientName=Bond^James'
La fel ca 1), dar importă informații despre pacient/studiu/serie din fișierul DICOM
'șablon.dcm'. Vă rugăm să rețineți că atributul PatientName va conține „Bond^James” la
la sfârșit, orice valoare din „template.dcm” va fi suprascrisă. Adică pentru că -k
opțiunea este aplicată chiar la sfârșitul conductei de conversie (vezi mai sus).
5. img2dcm image.jpg out.dcm --no-checks
La fel ca 1), dar nu efectuează nicio verificare a atributelor și nici tipul 1 și tipul 2
inserarea atributelor! Deci, în acest caz, va fi generat un obiect DICOM nevalid. Acest
poate fi interesant dacă fișierul de ieșire nu este menit să fie finalizat, dar va fi supus
transformări ulterioare, de exemplu adăugarea de atribute folosind dcmodify. Folosiți doar opțiunea --Nu-
verificări daca stii ce faci!
6. img2dcm image.jpg out.dcm --no-type1-invent
La fel ca 1), dar nu inserează atributele lipsă de tip 1 și/sau valorile acestora. Tipul 2
vor fi inserate atribute. Rețineți că în acest caz trebuie să vă asigurați că toate tipurile 1
atributele sunt furnizate prin alte mijloace, adică prin adăugarea lor cu --cheie opțiune.
In caz contrar, img2dcm va raporta o eroare și va opri conversia.
7. img2dcm image.jpg out.dcm --keep-appn --insist-on-jfif
La fel ca 1), dar preia informațiile APPn precum EXIF ​​în obiectele DICOM
fluxul JPEG rezultat. Mai departe, --insist-on-jfif va forța img2dcm a avorta daca nu
Informațiile JFIF există în fișierul sursă.

LOGARE

Nivelul de înregistrare în jurnal al diferitelor instrumente de linie de comandă și biblioteci subiacente poate
fi specificat de utilizator. În mod implicit, numai erorile și avertismentele sunt scrise conform standardului
fluxul de erori. Folosind opțiunea --verbos de asemenea, mesaje informaționale precum detaliile de procesare
sunt raportate. Opțiune --depanare poate fi folosit pentru a obține mai multe detalii despre activitatea internă,
de exemplu, în scopuri de depanare. Alte niveluri de înregistrare pot fi selectate folosind opțiunea --Buturuga-
nivel. În --Liniște mod sunt raportate numai erori fatale. În astfel de evenimente de eroare foarte grave,
aplicația se va încheia de obicei. Pentru mai multe detalii despre diferitele niveluri de înregistrare,
vezi documentația modulului „oflog”.
În cazul în care ieșirea de jurnal ar trebui să fie scrisă în fișier (opțional cu rotația fișierului de jurnal),
la syslog (Unix) sau la opțiunea jurnal de evenimente (Windows). --log-config poate fi utilizat. Acest
fișierul de configurare permite, de asemenea, direcționarea numai anumitor mesaje către o anumită ieșire
stream și pentru filtrarea anumitor mesaje în funcție de modulul sau aplicația în care acestea
sunt generate. Un exemplu de fișier de configurare este furnizat în /logger.cfg.

COMMAND LINE

Toate instrumentele din linia de comandă folosesc următoarea notație pentru parametri: parantezele pătrate includ
valori opționale (0-1), trei puncte în urmă indică faptul că sunt permise mai multe valori
(1-n), o combinație a ambelor înseamnă valori de la 0 la n.
Opțiunile liniei de comandă se deosebesc de parametri prin semnul „+” sau „-”,
respectiv. De obicei, ordinea și poziția opțiunilor liniei de comandă sunt arbitrare (adică acestea
poate apărea oriunde). Cu toate acestea, dacă opțiunile se exclud reciproc, aspectul cel mai potrivit
este folosit. Acest comportament se conformează regulilor standard de evaluare ale shell-urilor Unix obișnuite.
În plus, unul sau mai multe fișiere de comandă pot fi specificate folosind semnul „@” ca prefix pentru
numele fișierului (de ex @command.txt). Un astfel de argument de comandă este înlocuit cu conținutul lui
fișierul text corespunzător (mai multe spații albe sunt tratate ca un singur separator, cu excepția cazului în care
apar între două ghilimele) înainte de orice evaluare ulterioară. Vă rugăm să rețineți că
un fișier de comandă nu poate conține un alt fișier de comandă. Această abordare simplă, dar eficientă
permite rezumarea combinațiilor comune de opțiuni/parametri și evită lungimi și
linii de comandă confuze (un exemplu este oferit în fișier /dumppat.txt).

MEDIUL

img2dcm utilitarul va încerca să încarce dicționarele de date DICOM specificate în
DCMDICTPATH variabilă de mediu. Implicit, adică dacă DCMDICTPATH variabilă de mediu
nu este setat, fișierul /dicom.dic va fi încărcat dacă nu este construit dicționarul
în aplicație (implicit pentru Windows).
Comportamentul implicit ar trebui să fie preferat și DCMDICTPATH numai variabila de mediu
utilizat atunci când sunt necesare dicționare de date alternative. The DCMDICTPATH variabilă de mediu
are același format ca și shell-ul Unix PATH variabilă prin aceea că se separă două puncte (':').
intrări. Pe sistemele Windows, un punct și virgulă (';') este folosit ca separator. Dicționarul de date
codul va încerca să încarce fiecare fișier specificat în DCMDICTPATH variabilă de mediu. Aceasta
este o eroare dacă nu poate fi încărcat niciun dicționar de date.

Utilizați img2dcm online folosind serviciile onworks.net