.TH "drtdump" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" drtdump \- تخلیه و نمایش ساختار فایل و مجموعه داده DICOM RT .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf drtdump [options] drtfile-in\&.\&.\&. .fi .PP .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBdrtdump\fP محتوای یک شیء پرتودرمانی دایکام (DICOM RT - قالب فایل یا مجموعه داده خام) را به صورت متنی در خروجی استاندارد (stdout) تخلیه و چاپ می‌کند\&. خروجی شامل اطلاعات ضروری شیء RT در قالبی است که خواندن آن نسبت به قالب عمومی‌تر ابزار \fBdcmdump\fP آسان‌تر است\&. .PP اگر \fBdrtdump\fP یک مجموعه داده خام (داده‌های DICOM بدون هدر متای قالب فایل) را بخواند، تلاش می‌کند تا با بررسی چند بایت اول فایل، سینتکس انتقال (transfer syntax) را حدس بزند\&. حدس زدن صحیح سینتکس انتقال همیشه امکان‌پذیر نیست و بهتر است در صورت امکان، با استفاده از ابزار \fBdcmconv\fP یک مجموعه داده به قالب فایل تبدیل شود\&. همچنین می‌توان از گزینه‌های \fI-f\fP و \fI-t[ieb]\fP استفاده کرد تا \fBdrtdump\fP مجبور به خواندن مجموعه داده با یک سینتکس انتقال مشخص شود\&. .SH "پارامترها (PARAMETERS)" .PP .PP .nf drtfile-in نام فایل ورودی DICOM RT برای تخلیه و نمایش ("-" برای stdin) .fi .PP .SH "گزینه‌ها (OPTIONS)" .PP .SS "گزینه‌های عمومی (general options)" .PP .nf -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 برای ثبت‌کننده رویدادها .fi .PP .SS "گزینه‌های ورودی (input options)" .PP .nf قالب فایل ورودی: +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 .fi .PP .SS "گزینه‌های خروجی (output options)" .PP .nf چاپ و نمایش: +Pf --print-filename چاپ هدر حاوی نام فایل برای هر فایل ورودی .fi .PP .SH "نکات (NOTES)" .PP .SS "انطباق با دایکام (DICOM Conformance)" ابزار \fBdrtdump\fP از کلاس‌های SOP زیر پشتیبانی می‌کند: .PP .PP .nf 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 .fi .PP .SH "گزارش‌گیری (LOGGING)" .PP سطح خروجی گزارش‌گیری ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر تعیین شود\&. به طور پیش‌فرض، فقط خطاها و هشدارها در جریان خطای استاندارد نوشته می‌شوند\&. با استفاده از گزینه \fI--verbose\fP پیام‌های اطلاع‌رسانی مانند جزئیات پردازش نیز گزارش می‌شوند\&. گزینه \fI--debug\fP می‌تواند برای دریافت جزئیات بیشتر درباره فعالیت‌های داخلی، برای مثال به منظور اشکال‌زدایی استفاده شود\&. سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینه \fI--log-level\fP انتخاب کرد\&. در حالت \fI--quiet\fP فقط خطاهای مهلک گزارش می‌شوند\&. در چنین رخدادهای خطای بسیار شدیدی، برنامه معمولاً خاتمه می‌یابد\&. برای جزئیات بیشتر درباره سطوح مختلف ثبت گزارش، به مستندات ماژول «oflog» مراجعه کنید\&. .PP در صورتی که خروجی گزارش‌ها باید در فایل (به صورت اختیاری همراه با چرخش فایل گزارش)، در syslog (یونیکس) یا event log (ویندوز) نوشته شود، می‌توان از گزینه \fI--log-config\fP استفاده کرد\&. این فایل پیکربندی همچنین امکان هدایت پیام‌های خاص به یک جریان خروجی مشخص و فیلتر کردن پیام‌ها بر اساس ماژول یا برنامه‌ای که در آن تولید شده‌اند را فراهم می‌کند\&. یک نمونه فایل پیکربندی در \fI/logger\&.cfg\fP ارائه شده است\&. .SH "خط فرمان (COMMAND LINE)" .PP تمام ابزارهای خط فرمان از نمادگذاری زیر برای پارامترها استفاده می‌کنند: براکت‌ها مقادیر اختیاری (۰-۱) را در بر می‌گیرند، سه نقطه انتهایی نشان می‌دهد که چندین مقدار مجاز است (۱-n)، و ترکیبی از هر دو به معنای ۰ تا n مقدار است\&. .PP گزینه‌های خط فرمان با یک علامت پیشوند «+» یا «-» از پارامترها متمایز می‌شوند\&. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان اختیاری است (یعنی می‌توانند در هر جایی ظاهر شوند)\&. با این حال، اگر گزینه‌ها مانعه‌الجمع باشند، راست‌ترین گزینه استفاده می‌شود\&. این رفتار مطابق با قواعد استاندارد ارزیابی در شل‌های رایج یونیکس است\&. .PP علاوه بر این، یک یا چند فایل حاوی دستور را می‌توان با استفاده از علامت «@» به عنوان پیشوند نام فایل مشخص کرد (مانند \fI@command\&.txt\fP)\&. چنین آرگومانی پیش از هرگونه ارزیابی بیشتر، با محتوای فایل متنی متناظر جایگزین می‌شود (چندین فضای خالی به عنوان یک جداکننده واحد در نظر گرفته می‌شوند مگر اینکه بین دو علامت نقل‌قول قرار گیرند)\&. لطفاً توجه داشته باشید که یک فایل دستور نمی‌تواند شامل فایل دستور دیگری باشد\&. این رویکرد ساده اما مؤثر اجازه می‌دهد تا ترکیب‌های متداول گزینه‌ها/پارامترها خلاصه شده و از طولانی و گیج‌کننده شدن خط فرمان جلوگیری شود (یک نمونه در فایل \fI/dumppat\&.txt\fP ارائه شده است)\&. .SH "محیط (ENVIRONMENT)" .PP ابزار \fBdrtdump\fP تلاش می‌کند تا دیکشنری‌های داده DICOM مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. به طور پیش‌فرض، یعنی اگر متغیر محیطی \fIDCMDICTPATH\fP تنظیم نشده باشد، فایل \fI/dicom\&.dic\fP بارگذاری خواهد شد مگر اینکه دیکشنری درون برنامه تعبیه شده باشد (پیش‌فرض در ویندوز)\&. .PP رفتار پیش‌فرض باید ترجیح داده شود و متغیر محیطی \fIDCMDICTPATH\fP فقط زمانی استفاده شود که دیکشنری‌های داده جایگزین مورد نیاز باشند\&. متغیر محیطی \fIDCMDICTPATH\fP قالبی مشابه متغیر \fIPATH\fP در شل یونیکس دارد که در آن دو نقطه (":") ورودی‌ها را جدا می‌کند\&. در سیستم‌های ویندوز، از نقطه ویرگول (";") به عنوان جداکننده استفاده می‌شود\&. کد دیکشنری داده تلاش می‌کند تا هر فایل مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. اگر هیچ دیکشنری داده‌ای نتواند بارگذاری شود، یک خطا رخ خواهد داد\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBdcmconv\fP(1), \fBdcmdump\fP(1) .SH "حق نشر (COPYRIGHT)" .PP Copyright (C) 2010-2025 by OFFIS e\&.V\&. and ICSMED AG, Escherweg 2, 26121 Oldenburg, Germany\&.