نام (NAME)

dcmp2pgm - خواندن تصویر و حالت نمایش DICOM و رندر بیت‌مپ

خلاصه دستور (SYNOPSIS)

dcmp2pgm [options] dcmimage-in [bitmap-out]

توضیحات (DESCRIPTION)

ابزار dcmp2pgm یک تصویر تک‌رنگ DICOM را تحت کنترل یک شیء حالت نمایش رونوشت‌نرم مقیاس‌خاکستری (grayscale softcopy presentation state) به یک بیت‌مپ تک‌رنگ با ۸ بیت/پیکسل رندر می‌کند. این بیت‌مپ یا به‌صورت «Portable Gray Map» (PGM) یا به‌صورت یک شیء تصویری تصویربرداری ثانویه (secondary capture) DICOM ذخیره می‌شود. اگر هیچ حالت نمایشی از فایل خوانده نشود، یک حالت نمایش پیش‌فرض ایجاد می‌شود. این ابزار امکان خواندن فایل پیکربندی Softcopy Presentation State Viewer را در هنگام راه‌اندازی فراهم می‌کند. در این حالت، تنظیمات فایل پیکربندی که بر رندر حالت نمایش تأثیر می‌گذارند اعمال می‌شوند؛ برای مثال، در صورتی که منحنی مشخصه سامانه نمایش موجود بوده و در فایل پیکربندی تعریف شده باشد، می‌توان تصحیح محدوده مقیاس خاکستری را بر اساس مدل بارتن (Barten's model) (بخش ۱۴ DICOM) انجام داد.

پارامترها (PARAMETERS)

dcmimage-in  تصویر DICOM ورودی ("-" برای stdin)
bitmap-out   تصویر DICOM یا بیت‌مپ PGM خروجی

گزینه‌ها (OPTIONS)

گزینه‌های عمومی (general options)

-h   --help
       چاپ این متن راهنما و خروج
     --version
       چاپ اطلاعات نسخه و خروج
     --arguments
       چاپ آرگومان‌های بسط‌یافته خط فرمان
-q   --quiet
       حالت بی‌صدا، عدم چاپ هشدارها و خطاها
-v   --verbose
       حالت پرگو، چاپ جزئیات پردازش
-d   --debug
       حالت اشکال‌زدایی، چاپ اطلاعات اشکال‌زدایی
-ll  --log-level  [l]evel: string constant
       (fatal, error, warn, info, debug, trace)
       استفاده از سطح l برای ثبت‌کننده گزارش
-lc  --log-config  [f]ilename: string
       استفاده از فایل پیکربندی f برای ثبت‌کننده گزارش

گزینه‌های پردازش (processing options)

-p   --pstate  [f]ilename: string
       پردازش با استفاده از فایل حالت نمایش
-c   --config  [f]ilename: string
       پردازش با استفاده از تنظیمات فایل پیکربندی
-f   --frame  [f]rame: integer
       پردازش با استفاده از فریم تصویر f (پیش‌فرض: 1)

قالب خروجی (output format)

-D   --pgm
       ذخیره تصویر به عنوان PGM (پیش‌فرض)
+D   --dicom
       ذخیره تصویر به عنوان تصویربرداری ثانویه DICOM

گزینه‌های خروجی (output options)

+S   --save-pstate  [f]ilename: string
       ذخیره حالت نمایش در فایل

نکات (NOTES)

محدودیت‌ها (Limitations)

لطفاً توجه داشته باشید که ابزار dcmp2pgm تمام جنبه‌هایی را که توسط شیء Grayscale Softcopy Presentation State (GSPS) تعریف شده‌اند رندر نمی‌کند، بلکه تنها مواردی را که توسط کلاس‌های زیربنایی DCMTK پشتیبانی می‌شوند رندر می‌کند. به‌ویژه، حاشیه‌نویسی‌های متنی و گرافیکی در تصویر خروجی قابل مشاهده نخواهند بود. دلیل این امر این است که این جنبه‌های یک شیء GSPS معمولاً توسط DICOMscope رندر می‌شوند؛ واسط کاربری گرافیکی‌ای که روی کلاس‌های مرتبط DCMTK قرار گرفته و به زبان Java نوشته شده است.

همچنین مفاهیمی که پس از تعریف اولیه GSPS IOD معرفی شدند (نگاه کنید به Supplement 33) نادیده گرفته می‌شوند. این شامل Supplement 120 با قابلیت‌های توسعه‌یافته‌اش مانند Compound Graphics نیز می‌شود.

گزارش‌گیری (LOGGING)

میزان خروجی گزارش‌گیری ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر مشخص شود. به‌طور پیش‌فرض، فقط خطاها و هشدارها در جریان خطای استاندارد نوشته می‌شوند. با استفاده از گزینه --verbose پیام‌های اطلاع‌رسانی مانند جزئیات پردازش نیز گزارش می‌شوند. گزینه --debug می‌تواند برای دریافت جزئیات بیشتر در مورد فعالیت‌های داخلی، برای نمونه جهت اهداف اشکال‌زدایی، استفاده شود. سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینه --log-level انتخاب کرد. در حالت --quiet فقط خطاهای مهلک (fatal) گزارش می‌شوند. در چنین رخدادهای خطای بسیار شدیدی، برنامه معمولاً خاتمه می‌یابد. برای جزئیات بیشتر درباره سطوح مختلف گزارش‌گیری، به مستندات ماژول «oflog» مراجعه کنید.

در صورتی که خروجی گزارش‌گیری باید در فایل نوشته شود (اختیاراً همراه با چرخش فایل گزارش)، به syslog (در Unix) یا event log (در Windows) ارسال شود، می‌توان از گزینه --log-config استفاده کرد. این فایل پیکربندی همچنین امکان هدایت تنها پیام‌های خاصی را به یک جریان خروجی مشخص و فیلتر کردن برخی پیام‌ها بر اساس ماژول یا برنامه‌ای که در آن تولید شده‌اند، فراهم می‌کند. یک فایل پیکربندی نمونه در <etcdir>/logger.cfg ارائه شده است.

خط فرمان (COMMAND LINE)

تمام ابزارهای خط فرمان از نمادگذاری زیر برای پارامترها استفاده می‌کنند: کروشه‌ها مقادیر اختیاری را در بر می‌گیرند (۰-۱)، سه نقطه متوالی نشان می‌دهد که چندین مقدار مجاز است (۱-n)، و ترکیبی از هر دو به معنای ۰ تا n مقدار است.

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

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

محیط (ENVIRONMENT)

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

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

فایل‌ها (FILES)

<etcdir>/dcmpstat.cfg - فایل پیکربندی نمونه

کپی‌رایت و تکثیر (COPYRIGHT)