xml2dcm - آنلاین در ابر

برنامه:

نام

xml2dcm - سند XML را به فایل یا مجموعه داده DICOM تبدیل کنید

خلاصه

xml2dcm [گزینه‌ها] xmlfile-in dcmfile-out

شرح

La xml2dcm ابزار محتویات یک سند XML (زبان نشانه گذاری توسعه پذیر) را تبدیل می کند
به فایل یا مجموعه داده DICOM. انتظار می رود سند XML در برابر DTD اعتبار سنجی کند
(Document Type Definition) که در فایل توضیح داده شده است dcm2xml.dtd. یک فایل XML مناسب
را می توان با استفاده از dcm2xml ابزار (گزینه +Wb توصیه می شود شامل داده های باینری باشد).

پارامترهای

xmlfile-in نام فایل ورودی XML برای تبدیل (stdin: "-")

dcmfile-out نام فایل خروجی DICOM

OPTIONS

عمومی گزینه های
-h -- کمک
این متن راهنما را چاپ کنید و خارج شوید

- نسخه
چاپ اطلاعات نسخه و خروج

-- استدلال
آرگومان های خط فرمان گسترش یافته را چاپ کنید

-q -- ساکت
حالت بی صدا، بدون اخطار و خطا چاپ کنید

-v -- پرحرف
حالت پرحرف، جزئیات پردازش چاپ

-d - اشکال زدایی
حالت اشکال زدایی، چاپ اطلاعات اشکال زدایی

-ll --log-level [l]vel: رشته ثابت
(کشنده، خطا، هشدار، اطلاعات، اشکال زدایی، ردیابی)
از سطح l برای لاگر استفاده کنید

-lc --log-config [f]ilename: رشته
از فایل پیکربندی f برای لاگر استفاده کنید

ورودی گزینه های
فرمت فایل ورودی:

+f --read-meta-info
خواندن اطلاعات متا در صورت وجود (پیش‌فرض)

-f --نادیده گرفتن-متا اطلاعات
نادیده گرفتن اطلاعات متا فایل

در حال پردازش گزینه های
اعتبار سنجی:

+Vd --validate-document
سند XML را در برابر DTD تأیید کنید

+Vn --check-namespace
فضای نام XML را در ریشه سند بررسی کنید

شناسه های منحصر به فرد:

+Ug --تولید-نو-uids
UID نمونه مطالعه/سری/SOP جدید ایجاد کنید

-Uo --نباید رونویسی-uids
UID های موجود را رونویسی نکنید (پیش فرض)

+Uo -- رونویسی-uids
رونویسی UID های موجود

تولید گزینه های
فرمت فایل خروجی:

+F --writ-file
نوشتن فرمت فایل (پیش فرض)

-F --نوشتن-مجموعه داده
نوشتن مجموعه داده بدون اطلاعات متا فایل

+Fu -- به روز رسانی-متا اطلاعات
اطلاعات متا فایل خاص را به روز کنید

نحو انتقال خروجی:

+t= --write-xfer-same
نوشتن با همان TS به عنوان ورودی (پیش فرض)

+te --write-xfer-little
با اندیان TS صریح VR بنویسید

+tb --write-xfer-big
با VR صریح big endian TS بنویسید

+ti --نوشتن-xfer-ضمنی
با VR ضمنی اندیان TS بنویسید

+td --write-xfer-deflated
با اندیان TS کمی واقعیت مجازی صریح و واضح بنویسید

بازنمایی ارزش پس از سال 1993:

+u --enable-new-vr
فعال کردن پشتیبانی از VR های جدید (UN/UT) (پیش فرض)

-u --disable-new-vr
پشتیبانی از VR های جدید را غیرفعال کنید، به OB تبدیل کنید

رمزگذاری طول گروه:

+g= --group-length-recalc
محاسبه مجدد طول گروه در صورت وجود (پیش فرض)

+g --group-length-create
همیشه با عناصر طول گروه بنویسید

-g --group-length-remove
همیشه بدون عناصر طول گروه بنویسید

رمزگذاری طول در دنباله ها و آیتم ها:

+e --length-explicit
نوشتن با طول های واضح (پیش فرض)

-e --length-undefined
با طول های نامشخص بنویسید

padding دنباله مجموعه داده (نه با --write-dataset):

-p= --padding-retain
padding را تغییر ندهید (پیش‌فرض اگر نه --write-dataset)

-p -- padding-off
بدون بالشتک (اگر -write-dataset ضمنی)

+p --padding-create [f]ile-pad [i]tem-pad: عدد صحیح
تراز کردن فایل بر روی مضاعف f بایت و موارد در
چند برابر i بایت

سطح فشرده سازی را کاهش دهید (فقط با --write-xfer-deflated):

+cl -- فشرده سازی سطح [l]سطح: عدد صحیح (پیش فرض: 6)
0=فشرده نشده، 1=سریعترین، 9=بهترین فشرده سازی

NOTES

ساختار اصلی ورودی 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">




ممکن است تگ های «فرمت فایل» و «متا سربرگ» برای مجموعه داده های DICOM وجود نداشته باشد.

شخصیت رمز گذاری
رمزگذاری کاراکتر DICOM به طور خودکار از عنصر دارای برچسب تعیین می شود
'0008,0005' (مجموعه کاراکترهای خاص) - در صورت وجود. مجموعه کاراکترهای زیر هستند
در حال حاضر پشتیبانی می شود (نیاز دارد libxml که شامل نماد حمایت کنید، ببینید - نسخه خروجی):

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)

مجموعه نویسه‌های چندگانه پشتیبانی نمی‌شوند (فقط اولین مقدار «نویسه خاص».
Set' برای رمزگذاری کاراکتر در صورت تعدد مقدار استفاده می شود.

دیدن dcm2xml اسناد برای جزئیات بیشتر در مورد ساختار XML.

دوتایی داده ها
داده‌های باینری را می‌توان به صورت دنباله‌ای از اعداد هگز که با یک اسلش از هم جدا شده‌اند، رمزگذاری کرد.
'\' یا در قالب Base64 (باینری='base64'). علاوه بر این، داده های باینری را نیز می توان از آن خواند
فایل (باینری='پرونده'). در این مورد، نام فایل باید به عنوان مقدار عنصر مشخص شود،
به عنوان مثال

subdir/pixeldata.raw

توجه داشته باشید که محتویات فایل به همین صورت خوانده می شود. انتظار می رود داده های OW باشد
اندیان کوچک سفارش داده شده و در صورت لزوم تعویض خواهد شد. هیچ بررسی برای اطمینان انجام نخواهد شد
که مقدار داده ها از نظر سایر ویژگی ها مانند ردیف یا
ستون ها.

فشرده سازی
اگر libxml با پشتیبانی zlib کامپایل شده باشد، فایل ورودی (xmlfile-in) همچنین می تواند
فشرده شده با ZIP، که معمولا منجر به فایل های بسیار کوچکتر می شود. خروجی گزینه را ببینید
- نسخه به منظور بررسی اینکه آیا پشتیبانی zlib در دسترس است یا خیر.

محدودیت ها
نسخه های مختلف libxml ممکن است محدودیت های متفاوتی برای حداکثر طول XML داشته باشند
مقدار عنصر بنابراین، باید از استفاده از مقادیر بسیار طولانی عناصر (مثلاً برای
داده های پیکسلی).

لطفا توجه داشته باشید که xml2dcm در حال حاضر فایل های DICOMDIR را به طور کامل پشتیبانی نمی کند. به طور مشخص،
مقدار عناصر مختلف داده افست به طور خودکار توسط این ابزار به روز نمی شود.

عشق ورزیدن

سطح خروجی ورود به سیستم از ابزارهای مختلف خط فرمان و کتابخانه های زیرین می تواند
توسط کاربر مشخص شود. به طور پیش فرض، فقط خطاها و هشدارها در استاندارد نوشته می شوند
جریان خطا با استفاده از گزینه -- پرحرف همچنین پیام های اطلاعاتی مانند جزئیات پردازش
گزارش می شوند. گزینه - رفع اشکال می توان برای دریافت جزئیات بیشتر در مورد فعالیت داخلی استفاده کرد،
به عنوان مثال برای اهداف اشکال زدایی. سطوح دیگر ورود به سیستم را می توان با استفاده از گزینه انتخاب کرد --log-
سطح. به --ساکت حالت فقط خطاهای کشنده گزارش می شود. در چنین رویدادهای خطای بسیار شدید،
برنامه معمولاً خاتمه می یابد. برای جزئیات بیشتر در مورد سطوح مختلف ورود به سیستم،
مستندات ماژول "oflog" را ببینید.

در صورتی که خروجی لاگ باید در فایل نوشته شود (به صورت اختیاری با چرخش فایل لاگ)،
به syslog (یونیکس) و یا گزارش رویداد (ویندوز). --log-config می تواند به کار رود. این
فایل پیکربندی همچنین اجازه می دهد تا فقط پیام های خاصی را به یک خروجی خاص هدایت کنید
جریان و برای فیلتر کردن پیام های خاص بر اساس ماژول یا برنامه ای که در آن قرار دارند
تولید می شوند. یک نمونه فایل پیکربندی در ارائه شده است /logger.cfg.

COMMAND LINE

همه ابزارهای خط فرمان از نماد زیر برای پارامترها استفاده می کنند: براکت های مربع محصور می شود
مقادیر اختیاری (0-1)، سه نقطه انتهایی نشان می دهد که مقادیر متعدد مجاز هستند
(1-n)، ترکیبی از هر دو به معنای 0 تا n مقدار است.

گزینه های خط فرمان با علامت «+» یا «-» از پارامترها متمایز می شوند.
به ترتیب. معمولاً ترتیب و موقعیت گزینه های خط فرمان دلخواه هستند (یعنی آنها
می تواند در هر جایی ظاهر شود). با این حال، اگر گزینه‌ها متقابلاً منحصر به فرد باشند، ظاهر درست است
استفاده می شود. این رفتار با قوانین ارزیابی استاندارد پوسته های رایج یونیکس مطابقت دارد.

علاوه بر این، یک یا چند فایل فرمان را می توان با استفاده از علامت «@» به عنوان پیشوند مشخص کرد
نام فایل (مثلا @command.txt). چنین آرگومان دستوری با محتوای of جایگزین می شود
فایل متنی مربوطه (چند فاصله خالی به عنوان یک جداکننده در نظر گرفته می شود مگر اینکه
قبل از هر گونه ارزیابی بیشتر، بین دو علامت نقل قول ظاهر می شوند. لطفا توجه داشته باشید که
یک فایل فرمان نمی تواند حاوی فایل فرمان دیگری باشد. این روش ساده اما موثر
به فرد اجازه می دهد تا ترکیبات رایج گزینه ها/پارامترها را خلاصه کند و از longish و اجتناب کند
خطوط فرمان گیج کننده (مثالی در فایل ارائه شده است /dumppat.txt).

محیط زیست

La xml2dcm ابزار تلاش خواهد کرد تا دیکشنری های داده DICOM مشخص شده در را بارگیری کند
DCMDICTPATH متغیر محیطی. به طور پیش فرض، یعنی اگر DCMDICTPATH متغیر محیطی
تنظیم نشده است، فایل /dicom.dic بارگذاری می شود مگر اینکه فرهنگ لغت ساخته شود
به برنامه (پیش فرض برای ویندوز).

رفتار پیش فرض باید ترجیح داده شود و DCMDICTPATH فقط متغیر محیطی
زمانی استفاده می شود که به دیکشنری داده های جایگزین نیاز باشد. در DCMDICTPATH متغیر محیطی
فرمت مشابه پوسته یونیکس را دارد PATH متغیری که یک دونقطه (':') جدا می شود
ورودی های. در سیستم های ویندوز، نقطه ویرگول (';') به عنوان جداکننده استفاده می شود. فرهنگ لغت داده ها
کد سعی خواهد کرد هر فایل مشخص شده در را بارگیری کند DCMDICTPATH متغیر محیطی. آی تی
اگر دیکشنری داده‌ای بارگیری نشود، یک خطا است.

با استفاده از خدمات onworks.net از xml2dcm آنلاین استفاده کنید