هذا هو الأمر dsr2xml الذي يمكن تشغيله في موفر الاستضافة المجاني OnWorks باستخدام إحدى محطات العمل المجانية المتعددة عبر الإنترنت مثل Ubuntu Online أو Fedora Online أو محاكي Windows عبر الإنترنت أو محاكي MAC OS عبر الإنترنت
برنامج:
اسم
dsr2xml - تحويل ملف DICOM SR ومجموعة البيانات إلى XML
موجز
dsr2xml [خيارات] إدخال dsrfile [خروج xmlfile]
الوصف
إنّ كافة أنواع عهود الـ dsr2xml تقوم الأداة المساعدة بتحويل محتويات مستند DICOM Structured Reporting (SR).
(تنسيق الملف أو مجموعة البيانات الأولية) إلى XML (لغة التوصيف القابلة للتوسيع). مخطط XML
dsr2xml.xsd لا يتبع أي تنسيق قياسي حتى الآن. ومع ذلك ، فإن dsr2xml استمارتنا
يمكن تعزيز هذا الجانب في المستقبل (على سبيل المثال من خلال دعم HL7/CDA - Clinical
هندسة الوثيقة).
If dsr2xml يقرأ مجموعة بيانات أولية (بيانات DICOM بدون رأس تعريف تنسيق ملف) سوف يفعل ذلك
محاولة تخمين صيغة النقل عن طريق فحص البايتات القليلة الأولى من الملف. إنها
ليس من الممكن دائمًا تخمين صيغة النقل بشكل صحيح ومن الأفضل تحويل ملف
مجموعة البيانات إلى تنسيق ملف كلما أمكن ذلك (باستخدام امتداد dcmconv جدوى). بل هو أيضا
من الممكن استخدام -f و -t [ieb] خيارات القوة dsr2xml لقراءة مجموعة بيانات بامتداد
صيغة نقل معينة.
المعلمات
dsrfile-in اسم ملف إدخال DICOM SR المراد تحويله
xmlfile-out اسم ملف إخراج XML (الافتراضي: stdout)
OPTIONS
جنرال لواء الخيارات
ح- مساعدة
اطبع نص المساعدة واخرج
--الإصدار
طباعة معلومات الإصدار والخروج
--الحجج
طباعة وسيطات سطر الأوامر الموسعة
-Q - هادئ
الوضع الصامت ، لا تطبع أي تحذيرات وأخطاء
-v - الإسراف
الوضع المطول ، تفاصيل معالجة الطباعة
-د - ديبوغ
وضع التصحيح ، طباعة معلومات التصحيح
-ll --log-level [l] evel: سلسلة ثابتة
(فادح ، خطأ ، تحذير ، معلومات ، تصحيح ، تتبع)
استخدام المستوى l للمسجل
-lc --log-config [f] ilename: string
استخدام ملف التكوين f للمسجل
إدخال الخيارات
تنسيق ملف الإدخال:
+ f - قراءة الملف
قراءة تنسيق الملف أو مجموعة البيانات (افتراضي)
+ fo - قراءة ملف فقط
قراءة تنسيق الملف فقط
-f - قراءة-مجموعة البيانات
قراءة مجموعة البيانات بدون معلومات ملف التعريف
صيغة نقل الإدخال:
-t = - قراءة-xfer-auto
استخدام التعرف على TS (افتراضي)
-تد - قراءة-xfer-Detection
تجاهل TS المحدد في رأس الملف التعريفي
-te -read-xfer-little
قراءة مع صريحة VR قليلا Endian TS
-tb - قراءة-xfer-big
قراءة مع TS endian كبيرة VR صريحة
- ti - قراءة - xfer - ضمني
قراءة مع الواقع الافتراضي قليلا endian TS
معالجة الخيارات
معالجة الأخطاء:
- علاقة غير معروفة
قبول نوع علاقة غير معروف / مفقود
-Ev - قيمة العنصر غير صالحة
قبول قيمة عنصر المحتوى غير صالحة
(مثل انتهاك تعريف VR أو VM)
-تجاهل القيود
تجاهل قيود محتوى العلاقة
-ه- تجاهل أخطاء العنصر
لا تجهض أخطاء عنصر المحتوى ، فقط حذر
(على سبيل المثال ، السمات الخاصة بنوع القيمة المفقودة)
-Ei - تخطي العناصر غير الصالحة
تخطي عناصر المحتوى غير الصالحة (بما في ذلك الشجرة الفرعية)
-Dv - تعطيل- vr-checker
قم بتعطيل التحقق من قيم السلسلة المتوافقة مع VR
مجموعة أحرف محددة:
+ Cr - تتطلب مجموعة أحرف
تتطلب التصريح عن مجموعة الأحرف الموسعة (افتراضي)
+ Ca - تفترض مجموعة أحرف [c] harset: string
افترض c charset إذا لم يتم التصريح عن أحرف موسعة
+Cc --charset-check-all
تحقق من جميع عناصر البيانات بقيم السلسلة
(افتراضي: فقط PN و LO و LT و SH و ST و UT)
# يستخدم هذا الخيار فقط لتعيين ملف
# ترميز أحرف XML، ولكن ليس للتحويل إلى UTF-8
+ U8 - تحويل إلى utf8
تحويل جميع قيم العناصر المتأثرة
حسب مجموعة الأحرف المحددة (0008,0005) إلى UTF-8
# يتطلب دعمًا من مجموعة أدوات libiconv
الناتج الخيارات
التشفير:
+Ea --attr-all
تشفير كل شيء كسمة XML
(اختصار لـ +Ec و+Er و+Ev و+Et)
+Ec --attr-code
تشفير قيمة الكود، محدد مخطط الترميز
وإصدار نظام الترميز كسمة XML
+Er --attr-relationship
تشفير نوع العلاقة كسمة XML
+Ev --attr-value-type
تشفير نوع القيمة كسمة XML
+Et --attr-template-id
تشفير معرف القالب كسمة XML
+ Ee - غلاف القالب
يحتوي عنصر القالب على عناصر المحتوى
(يتطلب +Wt، يعني +Et)
هيكل XML:
+Xs --add-schema-reference
إضافة مرجع إلى مخطط XML "dsr2xml.xsd"
(ليس مع +Ea، +Ec، +Er، +Ev، +Et، +Ee، +We)
+Xn --use-xml-namespace
إضافة إعلان مساحة اسم XML إلى العنصر الجذر
جاري الكتابة:
+ نحن --نكتب علامات فارغة
كتابة كافة العلامات حتى لو كانت قيمتها فارغة
+Wi --write-item-id
اكتب دائمًا معرف العنصر
+Wt --write-template-id
كتابة معلومات تعريف القالب
الملاحظات
ديكوم التوافق
إنّ كافة أنواع عهود الـ dsr2xml تدعم الأداة المساعدة فئات SOP التالية:
وصف SpectacleReportStorage 1.2.840.10008.5.1.4.1.1.78.6
MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
التخزين المحسن SRStorage 1.2.840.10008.5.1.4.1.1.88.22
تخزين SR الشامل 1.2.840.10008.5.1.4.1.1.88.33
التخزين الشامل 3DSR 1.2.840.10008.5.1.4.1.1.88.34
الإجراء LogStorage 1.2.840.10008.5.1.4.1.1.88.40
التصوير الشعاعي للثدي CADSR التخزين 1.2.840.10008.5.1.4.1.1.88.50
KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
XRayRadiation جرعة SR التخزين 1.2.840.10008.5.1.4.1.1.88.67
المستحضرات الصيدلانية المشعة جرعة الإشعاع SR التخزين 1.2.840.10008.5.1.4.1.1.88.68
كولونCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
الزرع PlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
يرجى ملاحظة أنه في الوقت الحالي يتم دعم بعض السمات الإلزامية والاختيارية فقط.
حرف ترميز
يتم تحديد ترميز XML تلقائيًا من سمة DICOM (0008,0005)
"مجموعة الأحرف المحددة" باستخدام التعيين التالي:
ASCII (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"
إذا كانت سمة DICOM هذه مفقودة في ملف الإدخال ، على الرغم من الحاجة إليها ، الخيار --شارست-
افترض يمكن استخدامها لتحديد مجموعة أحرف مناسبة يدويًا (باستخدام واحدة من
المصطلحات المعرفة DICOM).
لا يتم دعم مجموعات الأحرف المتعددة (يتم تعيين قيمة السمة الأولى فقط في
حالة تعدد القيمة). إذا لزم الأمر ، الخيار - تحويل إلى utf8 يمكن استخدامها للتحويل
ملف DICOM أو مجموعة البيانات على ترميز UTF-8 قبل التحويل إلى تنسيق XML.
خطأ معالجة
يرجى توخي الحذر مع خيارات المعالجة --علاقة غير معروفة, - عنصر غير صالح-
قيمنا, --تجاهل القيود, --تجاهل أخطاء العنصر و --تخطي العناصر غير الصالحة لأنهم
قم بتعطيل بعض عمليات التحقق من الصحة في ملف إدخال DICOM SR، وبالتالي قد يؤدي ذلك إلى حدوث ذلك
في الإخراج المطابق غير القياسي. ومع ذلك، قد تكون هناك أسباب لاستخدام واحد أو أكثر
من هذه الخيارات، على سبيل المثال، من أجل قراءة ومعالجة مستند SR مشفر بشكل غير صحيح.
القيود
مخطط XML dsr2xml.xsd لا يدعم كافة الاختلافات في dsr2xml تنسيق الإخراج.
ومع ذلك ، فإن تنسيق الإخراج الافتراضي (بالإضافة إلى خيار --استخدام- xml- مساحة الاسم) يجب أن تعمل.
LOGGING
يمكن لمستوى تسجيل الإخراج لأدوات سطر الأوامر المختلفة والمكتبات الأساسية
يحدده المستخدم. بشكل افتراضي ، تتم كتابة الأخطاء والتحذيرات فقط وفقًا للمعيار
تيار الخطأ. باستخدام الخيار - الإسراف أيضًا الرسائل الإعلامية مثل تفاصيل المعالجة
تم عمل تقرير لها. خيار --Debug يمكن استخدامها للحصول على مزيد من التفاصيل حول النشاط الداخلي ،
على سبيل المثال لأغراض التصحيح. يمكن تحديد مستويات التسجيل الأخرى باستخدام الخيار --سجل-
مستوى. في --هادئ الوضع يتم الإبلاغ عن الأخطاء الفادحة فقط. في مثل هذه الأحداث الخطيرة جدًا ،
عادةً ما يتم إنهاء التطبيق. لمزيد من التفاصيل حول مستويات التسجيل المختلفة ،
انظر توثيق وحدة 'oflog'.
في حالة وجوب كتابة مخرجات التسجيل في ملف (اختياريًا مع تدوير ملف السجل) ،
إلى سجل النظام (Unix) أو خيار سجل الأحداث (Windows) --لوج التكوين يمكن استخدامها. هذه
يسمح ملف التكوين أيضًا بتوجيه رسائل معينة فقط إلى ناتج معين
تيار ولتصفية رسائل معينة بناءً على الوحدة النمطية أو التطبيق الذي توجد فيه
يتم إنشاؤها. يتم توفير مثال لملف التكوين بتنسيق /logger.cfg.
COMMAND خط
تستخدم جميع أدوات سطر الأوامر الترميز التالي للمعلمات: أرفق الأقواس المربعة
القيم الاختيارية (0-1) ، ثلاث نقاط لاحقة تشير إلى السماح بقيم متعددة
(1-n) ، مزيج من كلاهما يعني 0 إلى n قيم.
يتم تمييز خيارات سطر الأوامر عن المعلمات بعلامة "+" أو "-" بادئة ،
على التوالى. عادةً ما يكون ترتيب خيارات سطر الأوامر وموضعها تعسفيًا (أي أنها
يمكن أن تظهر في أي مكان). ومع ذلك ، إذا كانت الخيارات متنافية ، يظهر أقصى اليمين
يستخدم. يتوافق هذا السلوك مع قواعد التقييم القياسية لقذائف Unix الشائعة.
بالإضافة إلى ذلك ، يمكن تحديد ملف أو أكثر من ملفات الأوامر باستخدام علامة "@" كبادئة لـ
اسم الملف (على سبيل المثال @ command.txt). يتم استبدال حجة الأمر بمحتوى
الملف النصي المقابل (يتم التعامل مع المسافات البيضاء المتعددة كفاصل واحد ما لم يكن
تظهر بين علامتي اقتباس) قبل أي تقييم آخر. يرجى ملاحظة ذلك
لا يمكن أن يحتوي ملف الأوامر على ملف أوامر آخر. هذا نهج بسيط ولكن فعال
يسمح للمرء بتلخيص المجموعات المشتركة من الخيارات / المعلمات وتجنب longish و
أسطر الأوامر المربكة (يتم توفير مثال في ملف /dumppat.txt).
البيئة
إنّ كافة أنواع عهود الـ dsr2xml ستحاول الأداة المساعدة تحميل قواميس بيانات DICOM المحددة في ملف
DCMDICTPATH متغيرات البيئة. بشكل افتراضي ، على سبيل المثال ، إذا كان الملف DCMDICTPATH متغيرات البيئة
لم يتم تعيين الملف /dicom.dic سيتم تحميلها ما لم يتم بناء القاموس
في التطبيق (الافتراضي لنظام التشغيل Windows).
يجب تفضيل السلوك الافتراضي و DCMDICTPATH متغير البيئة فقط
تستخدم عندما تكون قواميس البيانات البديلة مطلوبة. ال DCMDICTPATH متغيرات البيئة
له نفس تنسيق غلاف يونكس PATH متغير في أن علامة النقطتين (':') تفصل
إدخالات. في أنظمة Windows ، يتم استخدام الفاصلة المنقوطة ('؛') كفاصل. قاموس البيانات
سيحاول الكود تحميل كل ملف محدد في DCMDICTPATH متغيرات البيئة. هو - هي
يعد خطأ إذا تعذر تحميل قاموس البيانات.
استخدم dsr2xml عبر الإنترنت باستخدام خدمات onworks.net
