xml2dcm - عبر الإنترنت في السحابة

برنامج:

اسم

xml2dcm - تحويل مستند XML إلى ملف DICOM أو مجموعة بيانات

موجز

xml2dcm [خيارات] xmlfile-in dcmfile-out

الوصف

• xml2dcm تقوم الأداة المساعدة بتحويل محتويات مستند XML (لغة التوصيف الموسعة)
إلى ملف DICOM أو مجموعة البيانات. من المتوقع أن يتم التحقق من صحة وثيقة XML مقابل DTD
(تعريف نوع المستند) الموصوف في الملف dcm2xml.dtd. ملف XML مناسب
يمكن إنشاؤه باستخدام dcm2xml أداة (خيار + Wb يوصى بتضمين البيانات الثنائية).

المعلمات

xmlfile-in XML سيتم تحويل اسم ملف الإدخال (stdin: "-")

dcmfile-out اسم ملف الإخراج DICOM

OPTIONS

جنرال لواء الخيارات
ح- مساعدة
اطبع نص المساعدة واخرج

--الإصدار
طباعة معلومات الإصدار والخروج

--الحجج
طباعة وسيطات سطر الأوامر الموسعة

-Q - هادئ
الوضع الصامت ، لا تطبع أي تحذيرات وأخطاء

-v - الإسراف
الوضع المطول ، تفاصيل معالجة الطباعة

-د - ديبوغ
وضع التصحيح ، طباعة معلومات التصحيح

-ll --log-level [l] evel: سلسلة ثابتة
(فادح ، خطأ ، تحذير ، معلومات ، تصحيح ، تتبع)
استخدام المستوى l للمسجل

-lc --log-config [f] ilename: string
استخدام ملف التكوين f للمسجل

إدخال الخيارات
تنسيق ملف الإدخال:

+ f - قراءة معلومات التعريف
قراءة المعلومات الوصفية إذا كانت موجودة (افتراضي)

-f - تجاهل-معلومات التعريف
تجاهل المعلومات الوصفية للملف

معالجة الخيارات
تصديق:

+ Vd - التحقق من صحة الوثيقة
التحقق من صحة مستند XML مقابل DTD

+ Vn - تحقق من مساحة الاسم
تحقق من مساحة اسم XML في جذر المستند

المعرفات الفريدة:

+ Ug - إنشاء موائع جديدة
إنشاء UID مثيل جديد للدراسة / السلسلة / SOP

-Uo - لا تستبدل - uids
لا تكتب فوق معرّفات UID الموجودة (افتراضي)

+ Uo - الكتابة فوق uids
الكتابة فوق UIDs الموجودة

الناتج الخيارات
تنسيق ملف الإخراج:

+ F - كتابة ملف
تنسيق ملف الكتابة (افتراضي)

-F - كتابة- مجموعة البيانات
كتابة مجموعة البيانات بدون معلومات ملف التعريف

+ فو - تحديث المعلومات الفوقية
تحديث معلومات ملف تعريف معينة

بناء جملة نقل الإخراج:

+ t = - اكتب xfer نفس
الكتابة بنفس TS كإدخال (افتراضي)

+ te - اكتب xfer القليل
اكتب باستخدام VR الصغير Endian TS

+ tb - اكتب xfer-big
اكتب باستخدام VR الكبير Endian TS

+ ti - اكتب xfer ضمنيًا
الكتابة مع الواقع الافتراضي قليلا Endian TS

+ td - اكتب xfer-deflated
الكتابة مع صريحة فرغ من الهواء قليلا endian TS

تمثيلات القيمة بعد عام 1993:

+ u --enable-new-vr
تمكين دعم VRs الجديدة (UN / UT) (افتراضي)

-u - تعطيل جديد- vr
تعطيل دعم VRs الجديدة ، والتحويل إلى OB

ترميز طول المجموعة:

+ g = - إعادة حساب طول المجموعة
إعادة حساب أطوال المجموعة إذا كانت موجودة (افتراضي)

+ ز - مجموعة الطول - إنشاء
اكتب دائمًا باستخدام عناصر طول المجموعة

-g - مجموعة-طول-إزالة
اكتب دائمًا بدون عناصر طول المجموعة

ترميز الطول بالتسلسل والعناصر:

+ ه - الطول الصريح
الكتابة بأطوال صريحة (افتراضي)

-E - الطول - غير محدد
اكتب بأطوال غير محددة

المساحة المتروكة لمجموعة البيانات (ليس باستخدام مجموعة بيانات الكتابة):

-p = - الحشوة-الاحتفاظ
لا تغير المساحة المتروكة (الافتراضي إن لم يكن - اكتب مجموعة البيانات)

-p - الوسادة
بلا حشوة (ضمنيًا إذا - اكتب مجموعة البيانات)

+ p - padding-create [f] ile-pad [i] tem-pad: عدد صحيح
محاذاة الملف على عدة بايتات وعناصر على
مضاعفات i بايت

انكماش مستوى الضغط (فقط مع --write-xfer-deflated):

+ cl - مستوى الضغط [l] evel: عدد صحيح (افتراضي: 6)
0 = غير مضغوط ، 1 = أسرع ، 9 = أفضل ضغط

الملاحظات

يبدو الهيكل الأساسي المتوقع لإدخال XML كما يلي:



<تنسيق الملف xmlns="http://dicom.offis.de/dcmtk">

<علامة العنصر = "0002,0000" vr = "UL" vm = "1" لين = "4"
name = "MetaElementGroupLength">
166


<علامة العنصر = "0002,0013" vr = "SH" vm = "1" لين = "16"
الاسم = "ImplementationVersionName">
OFFIS_DCMTK_353



<عنصر العلامة = "0008,0005" vr = "CS" vm = "1" لين = "10"
name = "SpecificCharacterSet">
ايزو_IR100




<علامة العنصر = "0028,3002" vr = "xs" vm = "3" لين = "6"
الاسم = "LUTDescriptor">
256 \ 0 \ 8






<علامة العنصر = "7fe0,0010" vr = "OW" vm = "1" لين = "262144"
الاسم = "PixelData" تم تحميله = "لا" ثنائي = "مخفي">




قد تكون علامات "تنسيق الملف" و "meta-header" غير موجودة لمجموعات بيانات DICOM.

حرف ترميز
يتم تحديد ترميز أحرف DICOM تلقائيًا من العنصر ذي العلامة
"0008,0005" (مجموعة الأحرف المحددة) - إن وجدت. مجموعات الأحرف التالية هي
مدعوم حاليًا (يتطلب libxml لتشمل iconv الدعم ، انظر --الإصدار انتاج):

أسكي (ISO_IR 6) (UTF-8)
UTF-8 "ISO_IR 192" (UTF-8)
ISO لاتينية 1 "ISO_IR 100" (ISO-8859-1)
ISO لاتينية 2 "ISO_IR 101" (ISO-8859-2)
ISO لاتينية 3 "ISO_IR 109" (ISO-8859-3)
ISO لاتينية 4 "ISO_IR 110" (ISO-8859-4)
ISO لاتينية 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
أمر endian الصغير وسيتم مبادلة إذا لزم الأمر. لن يتم إجراء أي فحوصات للتأكد
أن مقدار البيانات معقول من حيث السمات الأخرى مثل الصفوف أو
الأعمدة.

ضغط
إذا تم تجميع libxml بدعم zlib ، فإن ملف الإدخال (xmlfile-in) يمكن أن يكون أيضًا
مضغوط بواسطة ZIP ، والذي ينتج عنه عادةً ملفات أصغر بكثير. انظر إخراج الخيار
--الإصدار من أجل التحقق مما إذا كان دعم zlib متاحًا.

القيود
قد يكون للإصدارات المختلفة من libxml حدود مختلفة للحد الأقصى لطول XML
قيمة العنصر. لذلك ، يجب تجنب استخدام قيم طويلة جدًا للعناصر (على سبيل المثال لـ
بيانات البكسل).

يرجى ملاحظة أن xml2dcm حاليًا لا يدعم ملفات DICOMDIR بشكل كامل. خاصة،
لا يتم تحديث قيمة عناصر بيانات الإزاحة المختلفة تلقائيًا بواسطة هذه الأداة.

LOGGING

يمكن لمستوى تسجيل الإخراج لأدوات سطر الأوامر المختلفة والمكتبات الأساسية
يحدده المستخدم. بشكل افتراضي ، تتم كتابة الأخطاء والتحذيرات فقط وفقًا للمعيار
تيار الخطأ. باستخدام الخيار - الإسراف أيضًا الرسائل الإعلامية مثل تفاصيل المعالجة
تم عمل تقرير لها. خيار --Debug يمكن استخدامها للحصول على مزيد من التفاصيل حول النشاط الداخلي ،
على سبيل المثال لأغراض التصحيح. يمكن تحديد مستويات التسجيل الأخرى باستخدام الخيار --سجل-
مستوى. في --هادئ الوضع يتم الإبلاغ عن الأخطاء الفادحة فقط. في مثل هذه الأحداث الخطيرة جدًا ،
عادةً ما يتم إنهاء التطبيق. لمزيد من التفاصيل حول مستويات التسجيل المختلفة ،
انظر توثيق وحدة 'oflog'.

في حالة وجوب كتابة مخرجات التسجيل في ملف (اختياريًا مع تدوير ملف السجل) ،
إلى سجل النظام (Unix) أو خيار سجل الأحداث (Windows) --لوج التكوين يمكن استخدامها. هذه
يسمح ملف التكوين أيضًا بتوجيه رسائل معينة فقط إلى ناتج معين
تيار ولتصفية رسائل معينة بناءً على الوحدة النمطية أو التطبيق الذي توجد فيه
يتم إنشاؤها. يتم توفير مثال لملف التكوين بتنسيق /logger.cfg.

COMMAND خط

تستخدم جميع أدوات سطر الأوامر الترميز التالي للمعلمات: أرفق الأقواس المربعة
القيم الاختيارية (0-1) ، ثلاث نقاط لاحقة تشير إلى السماح بقيم متعددة
(1-n) ، مزيج من كلاهما يعني 0 إلى n قيم.

يتم تمييز خيارات سطر الأوامر عن المعلمات بعلامة "+" أو "-" بادئة ،
على التوالى. عادةً ما يكون ترتيب خيارات سطر الأوامر وموضعها تعسفيًا (أي أنها
يمكن أن تظهر في أي مكان). ومع ذلك ، إذا كانت الخيارات متنافية ، يظهر أقصى اليمين
يستخدم. يتوافق هذا السلوك مع قواعد التقييم القياسية لقذائف Unix الشائعة.

بالإضافة إلى ذلك ، يمكن تحديد ملف أو أكثر من ملفات الأوامر باستخدام علامة "@" كبادئة لـ
اسم الملف (على سبيل المثال @ command.txt). يتم استبدال حجة الأمر بمحتوى
الملف النصي المقابل (يتم التعامل مع المسافات البيضاء المتعددة كفاصل واحد ما لم يكن
تظهر بين علامتي اقتباس) قبل أي تقييم آخر. يرجى ملاحظة ذلك
لا يمكن أن يحتوي ملف الأوامر على ملف أوامر آخر. هذا نهج بسيط ولكن فعال
يسمح للمرء بتلخيص المجموعات المشتركة من الخيارات / المعلمات وتجنب longish و
أسطر الأوامر المربكة (يتم توفير مثال في ملف /dumppat.txt).

البيئة

• xml2dcm ستحاول الأداة المساعدة تحميل قواميس بيانات DICOM المحددة في ملف
DCMDICTPATH متغيرات البيئة. بشكل افتراضي ، على سبيل المثال ، إذا كان الملف DCMDICTPATH متغيرات البيئة
لم يتم تعيين الملف /dicom.dic سيتم تحميلها ما لم يتم بناء القاموس
في التطبيق (الافتراضي لنظام التشغيل Windows).

يجب تفضيل السلوك الافتراضي و DCMDICTPATH متغير البيئة فقط
تستخدم عندما تكون قواميس البيانات البديلة مطلوبة. ال DCMDICTPATH متغيرات البيئة
له نفس تنسيق غلاف يونكس PATH متغير في أن علامة النقطتين (':') تفصل
إدخالات. في أنظمة Windows ، يتم استخدام الفاصلة المنقوطة ('؛') كفاصل. قاموس البيانات
سيحاول الكود تحميل كل ملف محدد في DCMDICTPATH متغيرات البيئة. هو - هي
يعد خطأ إذا تعذر تحميل قاموس البيانات.

استخدم xml2dcm عبر الإنترنت باستخدام خدمات onworks.net