xml2dcm - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

xml2dcm - Перетворення XML-документа у файл DICOM або набір даних

СИНТАКСИС

xml2dcm [параметри] xmlfile-in dcmfile-out

ОПИС

Команда xml2dcm утиліта перетворює вміст документа XML (Extensible Markup Language).
у файл DICOM або набір даних. Очікується, що XML-документ перевіряється на DTD
(Визначення типу документа), який описано у файлі dcm2xml.dtd. Відповідний файл XML
можна створити за допомогою dcm2xml інструмент (опція +Wb рекомендується включати двійкові дані).

ПАРАМЕТРИ

xmlfile-in ім'я вхідного файлу XML, яке потрібно перетворити (стандартний номер: "-")

dcmfile-out Ім'я вихідного файлу DICOM

ВАРІАНТИ

загальний опції
-h --допомога
роздрукувати цей текст довідки та вийти

-- версія
роздрукувати інформацію про версію та вийти

-- аргументи
друкувати розширені аргументи командного рядка

-q -- тихо
тихий режим, друк без попереджень і помилок

-v -- багатослівний
докладний режим, деталі обробки друку

-d --налагодження
режим налагодження, друк налагоджувальної інформації

-ll --log-level [l]рівень: рядкова константа
(фатальна, помилка, попередження, інформація, налагодження, відстеження)
використовуйте рівень l для реєстратора

-lc --log-config [f]ім'я файлу: рядок
використовуйте файл конфігурації f для реєстратора

вхід опції
формат вхідного файлу:

+f --read-meta-info
прочитати метаінформацію, якщо є (за замовчуванням)

-f --ігнорувати-мета-інфо
ігнорувати метадані файлу

обробка опції
перевірка:

+Vd --підтвердити-документ
перевірити XML-документ на відповідність DTD

+Vn --check-namespace
перевірте простір імен XML у корені документа

унікальні ідентифікатори:

+Ug --generate-new-uids
створити новий UID екземпляра дослідження/серії/SOP

-Uo --dont-overwrite-uids
не перезаписувати існуючі UID (за замовчуванням)

+Uo --overwrite-uids
перезаписати існуючі UID

вихід опції
формат вихідного файлу:

+F --записати-файл
формат запису файлу (за замовчуванням)

-F --запис-набір даних
записувати набір даних без метаінформації файлу

+Fu --оновити мета-інформацію
оновити певну мета-інформацію файлу

Синтаксис передачі вихідних даних:

+t= --write-xfer-same
записувати з тим же TS, що і вхідні дані (за замовчуванням)

+te --write-xfer-little
писати з явним VR з малим байтом TS

+tb --write-xfer-big
писати з явним VR великим байтом TS

+ti --write-xfer-implicit
писати з неявним VR з малим байтом TS

+td --write-xfer-deflated
писати з дефлюованим явним VR з малим байтом TS

представлення цінностей після 1993 року:

+u --enable-new-vr
увімкнути підтримку нових VR (UN/UT) (за замовчуванням)

-u --вимкнути-новий-vr
вимкнути підтримку нових VR, конвертувати в OB

кодування довжини групи:

+g= --перерахунок довжини групи
перерахувати довжину груп, якщо є (за замовчуванням)

+g --створювати довжину групи
завжди пишіть з елементами довжини групи

-g --довжина-групи-видалити
завжди пишіть без елементів довжини групи

кодування довжини в послідовностях і елементах:

+e --довжина-явна
писати з явною довжиною (за замовчуванням)

-e --довжина-невизначена
писати з невизначеною довжиною

Завершення набору даних (не з --write-dataset):

-p= --padding-retain
не змінювати заповнення (за замовчуванням, якщо ні --write-dataset)

-p --adding-off
без заповнення (неявно якщо --write-dataset)

+p --padding-create [f]ile-pad [i]tem-pad: ціле
вирівняти файл за кількома f байтами та елементами
кратність i байт

знизити рівень стиснення (тільки з --write-xfer-deflated):

+cl --compression-level [l]evel: ціле (за замовчуванням: 6)
0 = нестиснутий, 1 = найшвидший, 9 = найкраще стиснення

ПРИМІТКИ

Основна структура очікуваного введення XML виглядає так:



<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">




Теги '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)
Кирилиця "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.

двійковий дані
Двійкові дані можуть бути закодовані або у вигляді послідовності шістнадцяткових чисел, розділених зворотною косою рискою
'\' або у форматі Base64 (двійковий='base64'). Крім того, двійкові дані також можна зчитувати
файл (двійковий='файл'). У цьому випадку ім’я файлу має бути вказано як значення елемента,
наприклад

subdir/pixeldata.raw

Зверніть увагу, що вміст файлу буде прочитано як є. Очікується, що дані OW будуть
Замовлено та буде замінено, якщо потрібно. Жодних перевірок не буде
що кількість даних є розумною з точки зору інших атрибутів, таких як рядки або
Стовпці.

компресія
Якщо libxml скомпільовано з підтримкою zlib, вхідний файл (xmfile-in) також може бути
стиснутий за допомогою ZIP, що зазвичай призводить до значно менших файлів. Дивіться вихід параметра
-- версія щоб перевірити, чи доступна підтримка zlib.

Недоліки
Різні версії libxml можуть мати різні обмеження для максимальної довжини XML
значення елемента. Тому слід уникати використання дуже довгих значень елементів (наприклад, for
піксельні дані).

Зверніть увагу, що xml2dcm наразі не повністю підтримує файли DICOMDIR. Зокрема,
значення різних елементів даних зміщення не оновлюється автоматично цим інструментом.

ВХІД

Рівень виводу журналу різних інструментів командного рядка та базових бібліотек може
вказується користувачем. За замовчуванням до стандарту записуються лише помилки та попередження
потік помилок. Використання опції -багатослівний також інформаційні повідомлення, як-от деталі обробки
повідомляється. Варіант --відлагоджувати можна використовувати для отримання більш детальної інформації про внутрішню діяльність,
наприклад, для налагодження. Інші рівні реєстрації можна вибрати за допомогою параметра --log-
рівень, в --спокійно режим повідомляється лише про смертельні помилки. У таких дуже серйозних помилках,
програма зазвичай припиняється. Щоб отримати докладнішу інформацію про різні рівні реєстрації,
див. документацію модуля 'oflog'.

У випадку, якщо вихідні дані журналу потрібно записати у файл (за бажанням з ротацією файлу журналу),
у системний журнал (Unix) або в журнал подій (Windows). --log-config може бути використаний. Це
конфігураційний файл також дозволяє направляти лише певні повідомлення на певний вихід
потоку та для фільтрації певних повідомлень на основі модуля чи програми, де вони
генеруються. Приклад файлу конфігурації наведено в /logger.cfg.

КОМАНДА ЛІНІЯ

Усі інструменти командного рядка використовують такі позначення параметрів: квадратні дужки
необов’язкові значення (0-1), три крапки в кінці вказують на те, що можна використовувати декілька значень
(1-n), комбінація обох означає від 0 до n значень.

Параметри командного рядка відрізняються від параметрів провідним знаком «+» або «-»,
відповідно. Зазвичай порядок і положення параметрів командного рядка довільні (тобто вони
може з'явитися де завгодно). Однак, якщо варіанти взаємовиключні, крайній правий зовнішній вигляд
використовується. Така поведінка відповідає стандартним правилам оцінки звичайних оболонок Unix.

Крім того, один або кілька командних файлів можна вказати, використовуючи знак «@» як префікс до
ім'я файлу (напр @command.txt). Такий аргумент команди замінюється вмістом
відповідний текстовий файл (кілька пробілів розглядаються як один роздільник, якщо
вони з’являються між двома лапками) перед будь-яким подальшим оцінюванням. Будь ласка, зверніть увагу, що
командний файл не може містити інший командний файл. Це простий, але ефективний підхід
дозволяє узагальнити загальні комбінації параметрів/параметрів і уникає довгих і
заплутані командні рядки (приклад наведено у файлі /dumppat.txt).

НАВКОЛИШНЄ СЕРЕДОВИЩЕ

Команда xml2dcm утиліта спробує завантажити словники даних DICOM, зазначені в
DCMDICTPATH змінна середовища. За замовчуванням, тобто якщо DCMDICTPATH змінна оточення
не встановлено, файл /dicom.dic буде завантажено, якщо словник не буде створено
в програму (за замовчуванням для Windows).

Слід віддавати перевагу поведінці за замовчуванням та DCMDICTPATH тільки змінна середовища
використовується, коли потрібні альтернативні словники даних. The DCMDICTPATH змінна оточення
має той самий формат, що й оболонка Unix PATH змінна, що розділяється двокрапкою (':').
записи. У системах Windows крапка з комою (';') використовується як роздільник. Словник даних
код спробує завантажити кожен файл, зазначений у файлі DCMDICTPATH змінна середовища. Це
є помилкою, якщо не вдається завантажити словник даних.

Використовуйте xml2dcm онлайн за допомогою служб onworks.net