این فرمان img2dcm است که می تواند در ارائه دهنده هاست رایگان OnWorks با استفاده از یکی از چندین ایستگاه کاری آنلاین رایگان ما مانند Ubuntu Online، Fedora Online، شبیه ساز آنلاین ویندوز یا شبیه ساز آنلاین MAC OS اجرا شود.
برنامه:
نام
img2dcm - فرمت های استاندارد تصویر را به فرمت DICOM تبدیل کنید
خلاصه
img2dcm [گزینهها] imgfile-in dcmfile-out
شرح
La img2dcm ابزار به عنوان یک ابزار تبدیل از یک فرمت تصویر استاندارد مانند JPEG یا BMP عمل می کند
به DICOM کلاس های SOP خروجی مختلف را می توان انتخاب کرد. اطلاعات اضافی
(در مورد بیماران، سری ها و غیره) ذخیره شده در فایل خروجی DICOM را می توان از آن استخراج کرد
سایر فایلهای DICOM که بهعنوان «الگو» برای شی DICOM بهدستآمده عمل میکنند. img2dcm می توان
همچنین برای اختراع ویژگیهای گمشده DICOM نوع 1 و نوع 2 پیکربندی شود تا حتی کار کند
بدون هیچ مجموعه داده الگو
پارامترهای
فایل تصویری imgfile-in که باید وارد شود
dcmfile-out فایل خروجی DICOM
OPTIONS
عمومی گزینه های
-h -- کمک
این متن راهنما را چاپ کنید و خارج شوید
- نسخه
چاپ اطلاعات نسخه و خروج
-- استدلال
آرگومان های خط فرمان گسترش یافته را چاپ کنید
-q -- ساکت
حالت بی صدا، بدون اخطار و خطا چاپ کنید
-v -- پرحرف
حالت پرحرف، جزئیات پردازش چاپ
-d - اشکال زدایی
حالت اشکال زدایی، چاپ اطلاعات اشکال زدایی
-ll --log-level [l]vel: رشته ثابت
(کشنده، خطا، هشدار، اطلاعات، اشکال زدایی، ردیابی)
از سطح l برای لاگر استفاده کنید
-lc --log-config [f]ilename: رشته
از فایل پیکربندی f برای لاگر استفاده کنید
ورودی گزینه های
عمومی:
-i --input-format [i]nput فرمت فایل: رشته
فرمت های پشتیبانی شده: JPEG (پیش فرض)، BMP
-df --dataset-from [f]ilename: رشته
استفاده از مجموعه داده از فایل DICOM f
-stf --study-from [f]ilename: رشته
مطالعه بیمار/مطالعه از فایل DICOM f
-sef --series-from [f]ilename: رشته
بیمار/مطالعه/سری ها را از فایل DICOM بخوانید f
-ii --instance-inc
افزایش تعداد نمونه خوانده شده از فایل DICOM
فرمت JPEG:
-dp --disable-progr
غیرفعال کردن پشتیبانی از JPEG مترقی
-de --disable-ext
پشتیبانی از JPEG متوالی طولانی را غیرفعال کنید
-jf -- اصرار بر jfif
اصرار بر وجود هدر JFIF
-ka --keep-appn
حفظ بخش های APPn (به جز JFIF)
در حال پردازش گزینه های
بررسی ویژگی:
-- انجام چک
فعال کردن بررسی اعتبار ویژگی (پیشفرض)
-- بدون چک
غیرفعال کردن بررسی اعتبار ویژگی
+i2 --insert-type2
درج ویژگی های گمشده نوع 2 (پیش فرض)
(فقط با --do-checks)
-i2 --no-type2-insert
ویژگی های گمشده نوع 2 را وارد نکنید
(فقط با --do-checks)
+i1 --invent-type1
ویژگی های گمشده نوع 1 را ابداع کنید
(فقط با --do-checks)
-i1 --no-type1-invent
ویژگی های گمشده نوع 1 را اختراع نکنید
(فقط با --do-checks)
مجموعه کاراکتر:
+l1 --latin1
تنظیم latin-1 به عنوان مجموعه کاراکترهای استاندارد (پیشفرض)
-l1 --بدون لاتین1
ASCII 7 بیتی را به عنوان مجموعه کاراکترهای استاندارد نگه دارید
سایر گزینه های پردازش:
-k --key [k]ey: gggg,eeee="str"، مسیر یا دیکشنری نام = "str"
ویژگی بیشتر اضافه کنید
تولید گزینه های
کلاس SOP هدف:
-sc --sec-capture
کلاس SOP ضبط ثانویه را بنویسید
-nsc --new-sc
کلاس های SOP ضبط ثانویه جدید بنویسید
-vlp --vl-photo
نوشتن کلاس SOP عکاسی با نور مرئی (پیشفرض)
فرمت فایل خروجی:
+F --writ-file
نوشتن فرمت فایل (پیش فرض)
-F --نوشتن-مجموعه داده
نوشتن مجموعه داده بدون اطلاعات متا فایل
رمزگذاری طول گروه:
+g= --group-length-recalc
محاسبه مجدد طول گروه در صورت وجود (پیش فرض)
+g --group-length-create
همیشه با عناصر طول گروه بنویسید
-g --group-length-remove
همیشه بدون عناصر طول گروه بنویسید
رمزگذاری طول در دنباله ها و آیتم ها:
+e --length-explicit
نوشتن با طول های واضح (پیش فرض)
-e --length-undefined
با طول های نامشخص بنویسید
padding دنباله مجموعه داده (نه با --write-dataset):
-p -- padding-off
بدون بالشتک (اگر -write-dataset ضمنی)
+p --padding-create [f]ile-pad [i]tem-pad: عدد صحیح
تراز کردن فایل در مضرب f بایت
و موارد در چند بایت i
NOTES
صفت منابع
برای تبدیل فرمت تصویر عمومی به فرمت DICOM، img2dcm کاربرد ممکن است
با مقداری ورودی اضافی برای پر کردن ویژگی های اجباری (و اختیاری) در جدید تغذیه می شود
فایل DICOM مانند اطلاعات بیمار، مطالعه و سری. این اطلاعات قابل جمع آوری است
با استفاده از رویکردهای مختلف، که می توانند ترکیب شوند و در فایل نتیجه اعمال شوند
ترتیب زیر
· با استفاده از - مجموعه داده-از انتخاب img2dcm مجبور است ویژگی ها را از موجودی وارد کند
فایل DICOM. فایل DICOM داده شده به طور کامل وارد شده است و به عنوان پایه برای همه عمل می کند
عملیات صادرات بیشتر به عنوان یک استثنا، UID نمونه SOP توسط این کپی نمی شود
گزینه. همچنین داده های مربوط به تصویر مانند ردیف ها، ستون ها و غیره در طول تبدیل رد و بدل می شوند.
توجه داشته باشید که img2dcm هیچ ارزش ویژگی دیگری را برای اعتبار بررسی نمی کند، به عنوان مثال انجام می دهد
برای تطبیق هر ویژگی با شی جدید به دنباله ها نگاه نکنید (تصاویر ارجاع شده
و غیره.). بنابراین، توصیه می شود از الگوهای موجود در فهرست داده ها برای (قدیمی) استفاده کنید.
اشیاء SC و VLP. همچنین به بخش "الگوهای ورودی" مراجعه کنید.
· --مطالعه-از و --سریال-از گزینه های (متقابل انحصاری) را می توان برای واردات استفاده کرد
اطلاعات بیمار، مطالعه و سری از فایل DICOM موجود. اگر --سریال-از is
مشخص شده، سپس فایل DICOM داده شده توسط باز می شود img2dcm و کلیه اطلاعات اجباری
تا سطح سری وارد می شود. توجه داشته باشید که این شامل بیمار، مطالعه و سریال است
اطلاعات در صورت --مطالعه-از، اطلاعات سری مستثنی شده است. به شرح زیر
صفات گرفته می شود:
سطح بیمار:
نام بیمار
شناسه بیمار
جنسیت بیمار
تاریخ تولد بیمار
مجموعه کاراکترهای خاص
سطح تحصیلات:
UID نمونه مطالعه
تاریخ مطالعه
زمان مطالعه
اشاره به نام پزشک
شناسه تحصیلی
شماره ورود، شماره دسترسی
سطح سری (فقط در مورد گزینه --series-from):
UID نمونه سری
شماره سریال
سازنده
· با --insert-type2 و --invent-type1 گزینه ها (هر دو به صورت پیش فرض فعال هستند)، از دست رفته است
ویژگی ها (ویژگی های نوع 2) و/یا مقادیر مشخصه از دست رفته (برای ویژگی های نوع 1)
به طور خودکار توسط اضافه و اختراع می شوند img2dcm. لطفا توجه داشته باشید که این گزینه ها فقط هستند
اگر گزینه ارزیابی شد -- انجام چک فعال است (پیش فرض). اگر -- بدون چک گزینه ها است
فعال باشد، هیچ درج خودکار ویژگی انجام نخواهد شد.
· -- کلید می توان از گزینه برای افزودن ویژگی های بیشتر به فایل خروجی DICOM استفاده کرد. این
گزینه در انتها، درست قبل از ذخیره فایل DICOM اعمال می شود. همچنین است
تعیین توالی ها، آیتم ها و ویژگی های تودرتو با استفاده از -- کلید گزینه. که در
در این موارد، باید از نماد «مسیر» ویژه استفاده شود. جزئیات در این نماد مسیر می تواند
در اسناد یافت می شود dcmodify.
UID ها
UIDهای نمونه سری و مطالعاتی جدید تولید می شوند if لازم پس از اعمال --مطالعه-
از جانب و --سلسله گزینه ها. اگر UID نمونه مطالعه یا UID نمونه سری وجود نداشته باشد
پس از این مراحل، آنها به تازگی و مستقل از یکدیگر تولید می شوند. برعکس
رفتاری برای UID نمونه SOP انتخاب شده است که می توان انتظار داشت در چه زمانی آن را تصاحب کند
با استفاده از - مجموعه داده-از گزینه. این هست نه در مورد، UID نمونه SOP است نه کپی شده
به شی جدید این باید رفتار مطلوب برای اکثر موارد استفاده باشد. با این حال، اگر الف
UID نمونه SOP خاص باید در شی جدید، the وارد شود -- کلید گزینه باید
استفاده شود
ورودی قالب
برای پشتیبانی از تبدیل به DICOM، img2dcm همراه با چند قالب از پیش تعریف شده است
که می تواند برای - مجموعه داده-از گزینه (نمونه فایل ها را ببینید SC.dump و VLP.dump).
این قالب ها باید با مقادیر مورد نظر پر شده و سپس تخلیه شوند
(تبدیل شده) به یک فایل DICOM قبل از استفاده واقعی با img2dcm. استفاده از dump2dcm به
Dump را به DICOM تبدیل کنید. مثال:
dump2dcm SC.dump SC.dcm
امکان استفاده از هر فایل DICOM به عنوان الگو وجود دارد. لطفاً توجه داشته باشید که DICOM کامل است
مجموعه داده وارد شده است. از این رو، باید مطمئن بود که فقط صفاتی وجود دارد که
باید بخشی از شی DICOM ساخته شده باشد. SOP Class UID و Pixel Data
ویژگی ها (از جمله ویژگی هایی مانند ردیف ها، ستون ها و غیره) کپی نمی شوند بلکه با
img2dcm در طول تبدیل
ورودی پلاگین
La img2dcm برنامه در حال حاضر از فرمت تصویر JPEG و BMP به عنوان ورودی پشتیبانی می کند.
JPEG ورودی پلاگین
برای JPEG، JPEG اصلی از فایل منبع رمزگشایی نمی شود، بلکه استخراج و کمی استخراج می شود
تبدیل شده است (به عنوان مثال هدر JFIF قطع شده است) تا امکان تبدیل سریع حتی فایل های بزرگ JPEG را فراهم کند
بدون نیاز به رمزگشایی و رمزگذاری مجدد. افزونه JPEG خروجی لازم را انتخاب می کند
بسته به رمزگذاری واقعی داده ها در داخل JPEG، نحو را به طور خودکار منتقل کنید
فایل. بنابراین، نحوهای انتقال زیر (و کدهای JPEG مربوط به آنها)
توسط پلاگین JPEG استفاده می شود:
· فرآیند کدنویسی JPEG 1 پایه، با اتلاف، غیر سلسله مراتبی، متوالی، DCT، هافمن، 8 بیت
کلاس SOP = 1.2.840.10008.1.2.4.50
· فرآیند کدنویسی JPEG 2 (8 بیتی) و 4 (12 بیتی) توسعه یافته، با اتلاف، غیر سلسله مراتبی،
ترتیبی، DCT، هافمن، کلاس SOP 8/12 بیتی = 1.2.840.10008.1.2.4.51
· فرآیند کدنویسی JPEG 10 (8 بیتی) و 12 (12 بیتی) با پیشرفت کامل، با اتلاف، غیر سلسله مراتبی،
Progressive، DCT، Huffman، کلاس SOP 8/12 بیت = 1.2.840.10008.1.2.4.55
تصاویر رنگی و خاکستری پشتیبانی می شوند.
پشتیبانی از Extended JPEG Transfer Syntax را می توان غیرفعال کرد (--غیرفعال کردن-ext گزینه)
و همچنین پشتیبانی از نحو انتقال پیشرو JPEG (بازنشسته)--disable-progr
گزینه).
کدگذاری JPEG بدون تلفات و همچنین هر حالت رمزگذاری حسابی یا سلسله مراتبی JPEG
توسط افزونه پشتیبانی نمی شود.
اطلاعات JFIF (فرمت تبادل فایل JPEG) نشانگرهای اختیاری APPn را در یک تسهیل می کند
فایل JPEG. بسیاری از دوربین های دیجیتال چنین اطلاعات JFIF را در JPEG ادغام نمی کنند
خروجی ای که ایجاد می کنند به عنوان مثال، JFIF حاوی اطلاعاتی در مورد نسبت ابعاد پیکسل است
تصویر فشرده شده اگر می خواهید img2dcm برنامه ای برای اصرار بر هدر JFIF در
جریان JPEG، می توانید از گزینه استفاده کنید -- اصرار بر jfif که اگر JFIF نباشد سقط می شود
اطلاعات را می توان یافت. به طور پیش فرض، اطلاعات از دست رفته JFIF نادیده گرفته می شود.
برای DICOM یک "منطقه خاکستری" است، چه ادغام JFIF (یا هر APPn دیگری)
داده های موجود در جریان JPEG داخلی شی DICOM مجاز است یا خیر. با این حال، بیشترین
روش قابل اعتماد این است که آن نشانگرها و اطلاعات آنها را از جریان JPEG حذف کنید. این
رویکرد نیز توسط img2dcm کاربرد. به طور پیش فرض، همه نشانگرهای APPn بریده می شوند
خارج از جریان اصلی JPEG. با این حال، اگر می خواهید دیگر نشانگرهای APPn را حفظ کنید
JFIF (به عنوان مثال اطلاعات EXIF) در داخل جریان DICOM، گزینه --keep-appn آیا
فوت و فن. همچنین باید کمی سریعتر از قطع کردن اطلاعات APPn باشد، زیرا اینطور است
لازم نیست کل جریان JPEG را برای چنین داده هایی اسکن کنید. اطلاعات JFIF است همیشه
حذف شده توسط img2dcm.
BMP ورودی پلاگین
img2dcm از BMP به عنوان فرمت ورودی پشتیبانی می کند. با این حال، تا کنون تنها متداول ترین تصاویر BMP هستند
پشتیبانی. به طور خاص، تصاویر BMP که از فیلدهای بیتی یا رمزگذاری طول اجرا استفاده می کنند، خواهند بود
رد شد. چنین تصاویری غیر معمول هستند. تمام تصاویر ورودی به یک تصویر DICOM تبدیل می شوند
با مدل رنگ RGB و کمی عمق 24. هیچ گزینه خاصی برای تنظیم دقیق وجود ندارد
تبدیل فرمت BMP
تولید پلاگین
کلاس SOP خروجی مورد نظر را می توان در خط فرمان انتخاب کرد. در حال حاضر، صادرات
پلاگین برای کلاس Secondary Capture Image SOP (پیشفرض، گزینه -sc) ثانویه جدید
ضبط کلاس های SOP تصویر (گزینه -nsc) و کلاس SOP عکس عکاسی با نور مرئی
(گزینه -vl) در دسترس هستند. لطفاً توجه داشته باشید که مورد اول مطابق با منسوخ شده است
استاندارد DICOM اما به عنوان پیش فرض انتخاب شده است زیرا به طور گسترده پشتیبانی می شود. آینده
نسخه های img2dcm ممکن است پلاگین های خروجی بیشتری برای سایر کلاس های SOP ارائه دهد.
برای کلاسهای Secondary Capture SOP جدید، نمیتوان مشخص کرد کدام کلاس خاص
کلاس SOP باید برای خروجی استفاده شود. به این دلیل است که این کلاس های SOP جدید هستند
با عمق رنگ (1/8/16) و اینکه آیا تصویر از یکدیگر متمایز می شوند
سیاه/سفید یا رنگی به همین دلیل است img2dcm در طول تبدیل، تصمیم می گیرد که کدام خروجی SOP
کلاس برای یک تصویر منبع داده شده مناسب است.
مثال ها
در اینجا چند نمونه آورده شده است که نشان می دهد چگونه img2dcm برنامه قابل استفاده است.
1. img2dcm image.jpg out.dcm
فایل JPEG 'image.jpg' را بخوانید، به کلاس Secondary Capture SOP قدیمی تبدیل کنید و ذخیره کنید
نتیجه به فایل DICOM 'out.dcm'. این ساده ترین راه استفاده است img2dcm. هر نوعی
ویژگی های 1 و نوع 2 مورد نیاز برای نوشتن آبجکت های معتبر این کلاس SOP هستند
به صورت خودکار درج می شود.
2. img2dcm -i BMP image.bmp out.dcm
مانند بالا اما به img2dcm می گوید که به جای JPEG یک فایل BMP را بخواند.
3. img2dcm image.jpg out.dcm -vlp -k 'PatientName=Bond^James'
مانند مثال اول، اما شیء Visible Light Photographic Image را روی "out.dcm" می نویسد.
و PatientName را روی 'Bond^James' تنظیم می کند که در غیر این صورت خالی می ماند.
4. img2dcm image.jpg out.dcm --series-from template.dcm -k 'PatientName=Bond^James'
مانند 1)، اما اطلاعات بیمار/مطالعه/سریال را از فایل DICOM وارد می کند
"template.dcm". لطفاً توجه داشته باشید که ویژگی PatientName حاوی «Bond^James» در است
در پایان، هر مقدار از "template.dcm" رونویسی خواهد شد. یعنی چون -k
گزینه در انتهای خط لوله تبدیل اعمال می شود (به بالا مراجعه کنید).
5. img2dcm image.jpg out.dcm --بدون بررسی
مانند 1)، اما هیچ گونه بررسی ویژگی و نوع 1 و نوع 2 را انجام نمی دهد
درج ویژگی! بنابراین در این مورد، یک شی DICOM نامعتبر ایجاد می شود. این
اگر قرار باشد فایل خروجی تکمیل نشود، اما تحت آن قرار گیرد، می تواند جالب باشد
تبدیل های بیشتر، به عنوان مثال اضافه کردن ویژگی ها با استفاده از dcmodify. فقط از گزینه استفاده کنید --نه-
چک ها اگر می دانید چه کار می کنید!
6. img2dcm image.jpg out.dcm --no-type1-invent
مانند 1)، اما ویژگیهای نوع 1 گمشده و/یا مقادیر آنها را درج نمیکند. نوع 2
ویژگی ها درج خواهند شد. توجه داشته باشید که در این مورد باید اطمینان حاصل شود که همه نوع 1
ویژگی ها با روش های دیگری ارائه می شوند، یعنی با افزودن آنها به -- کلید گزینه.
در غیر این صورت، img2dcm یک خطا گزارش می کند و تبدیل را متوقف می کند.
7. img2dcm image.jpg out.dcm --keep-appn --insis-on-jfif
مانند 1)، اما اطلاعات APPn مانند EXIF را در شی DICOM می گیرد
جریان JPEG حاصل. به علاوه، -- اصرار بر jfif مجبور خواهد شد img2dcm اگر نه
اطلاعات JFIF در فایل منبع وجود دارد.
عشق ورزیدن
سطح خروجی ورود به سیستم از ابزارهای مختلف خط فرمان و کتابخانه های زیرین می تواند
توسط کاربر مشخص شود. به طور پیش فرض، فقط خطاها و هشدارها در استاندارد نوشته می شوند
جریان خطا با استفاده از گزینه -- پرحرف همچنین پیام های اطلاعاتی مانند جزئیات پردازش
گزارش می شوند. گزینه - رفع اشکال می توان برای دریافت جزئیات بیشتر در مورد فعالیت داخلی استفاده کرد،
به عنوان مثال برای اهداف اشکال زدایی. سطوح دیگر ورود به سیستم را می توان با استفاده از گزینه انتخاب کرد --log-
سطح. به --ساکت حالت فقط خطاهای کشنده گزارش می شود. در چنین رویدادهای خطای بسیار شدید،
برنامه معمولاً خاتمه می یابد. برای جزئیات بیشتر در مورد سطوح مختلف ورود به سیستم،
مستندات ماژول "oflog" را ببینید.
در صورتی که خروجی لاگ باید در فایل نوشته شود (به صورت اختیاری با چرخش فایل لاگ)،
به syslog (یونیکس) و یا گزارش رویداد (ویندوز). --log-config می تواند به کار رود. این
فایل پیکربندی همچنین اجازه می دهد تا فقط پیام های خاصی را به یک خروجی خاص هدایت کنید
جریان و برای فیلتر کردن پیام های خاص بر اساس ماژول یا برنامه ای که در آن قرار دارند
تولید می شوند. یک نمونه فایل پیکربندی در ارائه شده است /logger.cfg.
COMMAND LINE
همه ابزارهای خط فرمان از نماد زیر برای پارامترها استفاده می کنند: براکت های مربع محصور می شود
مقادیر اختیاری (0-1)، سه نقطه انتهایی نشان می دهد که مقادیر متعدد مجاز هستند
(1-n)، ترکیبی از هر دو به معنای 0 تا n مقدار است.
گزینه های خط فرمان با علامت «+» یا «-» از پارامترها متمایز می شوند.
به ترتیب. معمولاً ترتیب و موقعیت گزینه های خط فرمان دلخواه هستند (یعنی آنها
می تواند در هر جایی ظاهر شود). با این حال، اگر گزینهها متقابلاً منحصر به فرد باشند، ظاهر درست است
استفاده می شود. این رفتار با قوانین ارزیابی استاندارد پوسته های رایج یونیکس مطابقت دارد.
علاوه بر این، یک یا چند فایل فرمان را می توان با استفاده از علامت «@» به عنوان پیشوند مشخص کرد
نام فایل (مثلا @command.txt). چنین آرگومان دستوری با محتوای of جایگزین می شود
فایل متنی مربوطه (چند فاصله خالی به عنوان یک جداکننده در نظر گرفته می شود مگر اینکه
قبل از هر گونه ارزیابی بیشتر، بین دو علامت نقل قول ظاهر می شوند. لطفا توجه داشته باشید که
یک فایل فرمان نمی تواند حاوی فایل فرمان دیگری باشد. این روش ساده اما موثر
به فرد اجازه می دهد تا ترکیبات رایج گزینه ها/پارامترها را خلاصه کند و از longish و اجتناب کند
خطوط فرمان گیج کننده (مثالی در فایل ارائه شده است /dumppat.txt).
محیط زیست
La img2dcm ابزار تلاش خواهد کرد تا دیکشنری های داده DICOM مشخص شده در را بارگیری کند
DCMDICTPATH متغیر محیطی. به طور پیش فرض، یعنی اگر DCMDICTPATH متغیر محیطی
تنظیم نشده است، فایل /dicom.dic بارگذاری می شود مگر اینکه فرهنگ لغت ساخته شود
به برنامه (پیش فرض برای ویندوز).
رفتار پیش فرض باید ترجیح داده شود و DCMDICTPATH فقط متغیر محیطی
زمانی استفاده می شود که به دیکشنری داده های جایگزین نیاز باشد. در DCMDICTPATH متغیر محیطی
فرمت مشابه پوسته یونیکس را دارد PATH متغیری که یک دونقطه (':') جدا می شود
ورودی های. در سیستم های ویندوز، نقطه ویرگول (';') به عنوان جداکننده استفاده می شود. فرهنگ لغت داده ها
کد سعی خواهد کرد هر فایل مشخص شده در را بارگیری کند DCMDICTPATH متغیر محیطی. آی تی
اگر دیکشنری دادهای بارگیری نشود، یک خطا است.
با استفاده از خدمات onworks.net از img2dcm به صورت آنلاین استفاده کنید