.TH "dsrdump" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" dsrdump \- برون‌ریزی و نمایش متنی فایل و مجموعه داده DICOM SR .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf dsrdump [options] dsrfile-in\&.\&.\&. .fi .PP .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBdsrdump\fP محتویات یک سند گزارش‌دهی ساختاریافته دایکام (DICOM Structured Reporting یا SR) را (در قالب فایل یا مجموعه داده خام) به صورت متنی در stdout برون‌ریزی می‌کند\&. خروجی محتوای سند از قالب پیشنهادشده در کتاب «DICOM Structured Reporting» نوشته David Clunie (انتشارات PixelMed Publishing، ۲۰۰۰) پیروی می‌کند\&. .PP اگر \fBdsrdump\fP یک مجموعه داده خام (داده‌های DICOM فاقد فراته‌سرآیند قالب فایل) را بخواند، تلاش خواهد کرد با بررسی چند بایت اول فایل، سینتکس انتقال (transfer syntax) را حدس بزند\&. حدس زدن درست سینتکس انتقال همیشه ممکن نیست و بهتر است در صورت امکان، مجموعه داده به یک قالب فایل تبدیل شود (با استفاده از ابزار \fBdcmconv\fP)\&. همچنین می‌توان از گزینه‌های \fI-f\fP و \fI-t[ieb]\fP استفاده کرد تا \fBdsrdump\fP وادار به خواندن یک مجموعه داده با سینتکس انتقال مشخصی شود\&. .SH "پارامترها (PARAMETERS)" .PP .PP .nf dsrfile-in نام فایل ورودی DICOM SR برای برون‌ریزی ("-" برای 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: string constant (fatal, error, warn, info, debug, trace) استفاده از سطح l برای ثبت‌کننده لاگ -lc --log-config [f]ilename: string استفاده از فایل پیکربندی 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 از نوع explicit VR little endian -tb --read-xfer-big خواندن با TS از نوع explicit VR big endian -ti --read-xfer-implicit خواندن با TS از نوع implicit VR little endian .fi .PP .SS "گزینه‌های پردازش (processing options)" .PP .nf اطلاعات تکمیلی: -Ip --processing-details نمایش آیتم محتوایی که در حال حاضر پردازش می‌شود مدیریت خطا: -Er --unknown-relationship پذیرش نوع رابطه ناشناخته/ناموجود -Ev --invalid-item-value پذیرش مقدار نامعتبر آیتم محتوا (مثلاً نقض تعریف VR یا VM) -Ec --ignore-constraints نادیده گرفتن محدودیت‌های محتوایی رابطه -Ee --ignore-item-errors عدم توقف در صورت خطای آیتم محتوا، تنها هشدار داده شود (مثلاً ویژگی‌های از دست رفته مختص به نوع مقدار) -Ei --skip-invalid-items نادیده گرفتن آیتم‌های محتوای نامعتبر (شامل زیردرخت آن) -Dv --disable-vr-checker غیرفعال کردن بررسی سازگاری مقادیر رشته‌ای با VR مجموعه نویسه‌های خاص: +U8 --convert-to-utf8 تبدیل تمامی مقادیر عناصری که تحت تأثیر Specific Character Set (0008,0005) هستند به UTF-8 # نیازمند پشتیبانی از سوی کتابخانه کدگذاری نویسه زیربنایی است # (برای مشاهده موارد در دسترس، خروجی --version را ببینید) .fi .PP .SS "گزینه‌های خروجی (output options)" .PP .nf چاپ عمومی: +Pf --print-filename چاپ سرآیند به همراه نام فایل برای هر سند -Ph --no-document-header عدم چاپ اطلاعات عمومی سند +Pn --number-nested-items چاپ رشته موقعیت در ابتدای هر خط -Pn --indent-nested-items تودرتوسازی آیتم‌های وابسته با فاصله (پیش‌فرض) چاپ مقادیر: +Pl --print-long-values چاپ کامل مقادیر طولانی آیتم‌ها -Pl --shorten-long-values چاپ کوتاه‌شده مقادیر طولانی آیتم‌ها (پیش‌فرض) +Pu --print-instance-uid چاپ SOP Instance UID اشیاء ارجاع‌شده -Ps --print-sopclass-short چاپ نام کوتاه SOP Class اشیاء تصویری ارجاع‌شده، مانند "CT image" (پیش‌فرض) +Ps --print-sopclass-long چاپ نام کامل SOP Class اشیاء ارجاع‌شده +Psu --print-sopclass-uid چاپ SOP Class UID اشیاء ارجاع‌شده +Pc --print-all-codes چاپ تمام کدها (شامل کدهای concept name) +Pi --print-invalid-codes چاپ کدهای نامعتبر (جهت اهداف اشکال‌زدایی) -Pi --no-invalid-codes چاپ عبارت "invalid code" به جای آن (پیش‌فرض) +Pt --print-template-id چاپ اطلاعات شناسایی الگو (template) حالت کدگذاری پیشرفته: +Pe --indicate-enhanced مشخص کردن استفاده از حالت پیشرفته برای کدها -Pe --no-enhanced-mode عدم مشخص کردن حالت پیشرفته (پیش‌فرض) رنگ: +C --print-color استفاده از کدهای گریز ANSI برای خروجی رنگی -C --no-color عدم استفاده از کدهای گریز ANSI (پیش‌فرض) .fi .PP .SH "نکات (NOTES)" .PP .SS "انطباق با دایکام (DICOM Conformance)" ابزار \fBdsrdump\fP از SOP Classهای زیر پشتیبانی می‌کند: .PP .PP .nf SpectaclePrescriptionReportStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.78\&.6 MacularGridThicknessAndVolumeReportStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.79\&.1 BasicTextSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.11 EnhancedSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.22 ComprehensiveSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.33 Comprehensive3DSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.34 ProcedureLogStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.40 MammographyCADSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.50 KeyObjectSelectionDocumentStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.59 ChestCADSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.65 XRayRadiationDoseSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.67 RadiopharmaceuticalRadiationDoseSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.68 ColonCADSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.69 ImplantationPlanSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.70 AcquisitionContextSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.71 SimplifiedAdultEchoSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.72 PatientRadiationDoseSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.73 PlannedImagingAgentAdministrationSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.74 PerformedImagingAgentAdministrationSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.75 WaveformAnnotationSRStorage 1\&.2\&.840\&.10008\&.5\&.1\&.4\&.1\&.1\&.88\&.77 RenditionSelectionDocumentRealTimeCommunication 1\&.2\&.840\&.10008\&.10\&.4 (*) .fi .PP .PP (*) این یک Storage SOP Class نیست، بلکه برای Real-Time Communication (ارتباط بلادرنگ) استفاده می‌شود\&. .SH "لاگ‌گیری (LOGGING)" .PP سطح خروجی لاگ‌گیری ابزارهای گوناگون خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر تعیین شود\&. به‌طور پیش‌فرض، تنها خطاها و هشدارها در جریان خطای استاندارد (stderr) نوشته می‌شوند\&. با استفاده از گزینه \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 ابزار \fBdsrdump\fP تلاش خواهد کرد فرهنگ‌داده‌های دایکام (DICOM data dictionaries) مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. به‌طور پیش‌فرض، یعنی در صورتی که متغیر محیطی \fIDCMDICTPATH\fP تنظیم نشده باشد، فایل \fI/dicom\&.dic\fP بارگذاری خواهد شد مگر اینکه فرهنگ‌داده درون برنامه تعبیه شده باشد (پیش‌فرض در ویندوز)\&. .PP رفتار پیش‌فرض ارجح است و متغیر محیطی \fIDCMDICTPATH\fP تنها باید زمانی استفاده شود که به فرهنگ‌داده‌های جایگزین نیاز باشد\&. متغیر محیطی \fIDCMDICTPATH\fP ساختاری مشابه متغیر \fIPATH\fP در پوسته یونیکس دارد که در آن علامت دونقطه (":") ورودی‌ها را جدا می‌کند\&. در سیستم‌های ویندوز، علامت نقطه ویرگول (";") به عنوان جداکننده به کار می‌رود\&. کد فرهنگ‌داده تلاش خواهد کرد هر فایل مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری نماید\&. در صورتی که هیچ فرهنگ‌داده‌ای بارگذاری نشود، یک وضعیت خطا رخ خواهد داد\&. .PP بسته به گزینه‌های خط فرمان تعیین‌شده، ابزار \fBdsrdump\fP ممکن است برای بارگذاری جدول‌های نگاشت مجموعه نویسه (character set) تلاش کند\&. این حالت زمانی رخ می‌دهد که DCMTK با کتابخانه oficonv (که پیش‌فرض است) کامپایل شده باشد و جدول‌های نگاشت درون کتابخانه تعبیه نشده باشند (پیش‌فرض زمانی که DCMTK از کتابخانه‌های مشترک استفاده می‌کند)\&. .PP فایل‌های جدول نگاشت در پوشه \fI\fP مربوط به DCMTK مورد انتظار هستند\&. متغیر محیطی \fIDCMICONVPATH\fP می‌تواند برای مشخص کردن مکانی دیگر استفاده شود\&. در صورت تعیین مکانی دیگر، آن جدول‌های نگاشت جایگزین جدول‌های تعبیه‌شده داخلی نیز خواهند شد\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBdcmconv\fP(1) .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .PP Copyright (C) 2000-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.