نام (NAME)

drtdump - تخلیه و نمایش ساختار فایل و مجموعه داده DICOM RT

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

drtdump [options] drtfile-in...

توضیحات (DESCRIPTION)

ابزار drtdump محتوای یک شیء پرتودرمانی دایکام (DICOM RT ‏- قالب فایل یا مجموعه داده خام) را به صورت متنی در خروجی استاندارد (stdout) تخلیه و چاپ می‌کند. خروجی شامل اطلاعات ضروری شیء RT در قالبی است که خواندن آن نسبت به قالب عمومی‌تر ابزار dcmdump آسان‌تر است.

اگر drtdump یک مجموعه داده خام (داده‌های DICOM بدون هدر متای قالب فایل) را بخواند، تلاش می‌کند تا با بررسی چند بایت اول فایل، سینتکس انتقال (transfer syntax) را حدس بزند. حدس زدن صحیح سینتکس انتقال همیشه امکان‌پذیر نیست و بهتر است در صورت امکان، با استفاده از ابزار dcmconv یک مجموعه داده به قالب فایل تبدیل شود. همچنین می‌توان از گزینه‌های -f و -t[ieb] استفاده کرد تا drtdump مجبور به خواندن مجموعه داده با یک سینتکس انتقال مشخص شود.

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

drtfile-in  نام فایل ورودی DICOM RT برای تخلیه و نمایش ("-" برای stdin)

گزینه‌ها (OPTIONS)

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

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

گزینه‌های ورودی (input options)

قالب فایل ورودی:
  +f   --read-file
         خواندن قالب فایل یا مجموعه داده (پیش‌فرض)
  +fo  --read-file-only
         خواندن صرفاً قالب فایل
  -f   --read-dataset
         خواندن مجموعه داده بدون اطلاعات متای فایل
سینتکس انتقال ورودی:
  -t=  --read-xfer-auto
         استفاده از تشخیص خودکار TS (پیش‌فرض)
  -td  --read-xfer-detect
         نادیده گرفتن TS مشخص‌شده در هدر متای فایل
  -te  --read-xfer-little
         خواندن با TS صریح VR و little endian
  -tb  --read-xfer-big
         خواندن با TS صریح VR و big endian
  -ti  --read-xfer-implicit
         خواندن با TS ضمنی VR و little endian

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

چاپ و نمایش:
  +Pf  --print-filename
         چاپ هدر حاوی نام فایل برای هر فایل ورودی

نکات (NOTES)

انطباق با دایکام (DICOM Conformance)

ابزار drtdump از کلاس‌های SOP زیر پشتیبانی می‌کند:

RTImageStorage                   1.2.840.10008.5.1.4.1.1.481.1
RTDoseStorage                    1.2.840.10008.5.1.4.1.1.481.2
RTStructureSetStorage            1.2.840.10008.5.1.4.1.1.481.3
RTPlanStorage                    1.2.840.10008.5.1.4.1.1.481.5
RTTreatmentSummaryRecordStorage  1.2.840.10008.5.1.4.1.1.481.7
RTIonPlanStorage                 1.2.840.10008.5.1.4.1.1.481.8
RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9

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

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

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

خط فرمان (COMMAND LINE)

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

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

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

محیط (ENVIRONMENT)

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

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

همچنین ببینید (SEE ALSO)

dcmconv(1), dcmdump(1)