.TH "dcmpschk" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" dcmpschk \- ابزار بررسی برای وضعیت‌های نمایش (presentation states) .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf dcmpschk [options] [dcmfile-in\&.\&.\&.] .fi .PP .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBdcmpschk\fP اشیاء وضعیت نمایش نرم مقیاس خاکستری دایکام (DICOM Grayscale Softcopy Presentation State) را از نظر مطابقت با استاندارد بررسی می‌کند\&. این آزمون در سه مرحله انجام می‌شود: .PP .IP "\(bu" 2 مرحله ۱ متاسرآیند (Meta-header) فایل DICOM را بررسی می‌کند\&. این مورد بررسی می‌شود که آیا همه مشخصه‌های (attributes) الزامی وجود دارند، آیا UIDهای SOP class و نمونه (instance) با UIDهای شیء اصلی مطابقت دارند یا خیر، و اینکه آیا مشخصه طول گروه (group length) حاوی مقدار صحیحی است یا نه\&. ساختار انتقال (Transfer Syntax) متاسرآیند نیز بررسی می‌شود\&. .IP "\(bu" 2 مرحله ۲ یک بررسی نحوی روی مقادیر، نمایش مقادیر (value representations یا VR) و چندگانگی مقادیر (value multiplicities یا VM) برای هر مشخصه در شیء انجام می‌دهد\&. مقادیر موجود در شیء تحت آزمایش با تعاریف فرهنگ داده (data dictionary) دایکام مقایسه می‌شوند\&. .IP "\(bu" 2 مرحله ۳ یک بررسی معنایی روی یکپارچگی Presentation State انجام می‌دهد\&. در صورت مواجهه با اشیایی از سایر SOP Classها، از این مرحله صرف‌نظر می‌شود\&. مراحل ۱ و ۲ را می‌توان برای سایر اشیاء DICOM از هر SOP class دلخواهی نیز اعمال کرد\&. لازم به ذکر است که \fBdcmpschk\fP از Presentation Stateهایی که حاوی Mask Module هستند پشتیبانی نمی‌کند\&. این موارد با پیامی مبنی بر اینکه Mask Module پشتیبانی نمی‌شود رد خواهند شد\&. .PP .SH "پارامترها (PARAMETERS)" .PP .PP .nf dcmfile-in فایل(های) presentation state برای بررسی .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 "گزینه‌های اعتبارسنجی (validation options)" .PP .nf --validate-std تصاویر ارجاع‌شده توسط GSPS باید متعلق به یک SOP class یکسان باشند (پیش‌فرض) --validate-related تصاویر ارجاع‌شده توسط GSPS می‌توانند متعلق به SOP classهای مرتبط 'for presentation' و 'for processing' باشند --validate-relaxed تصاویر ارجاع‌شده توسط GSPS می‌توانند از هر SOP class باشند .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 ابزار \fBdcmpschk\fP تلاش خواهد کرد فرهنگ‌های داده دایکام مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. به‌طور پیش‌فرض، یعنی در صورتی که متغیر محیطی \fIDCMDICTPATH\fP تنظیم نشده باشد، فایل \fI/dicom\&.dic\fP بارگذاری خواهد شد، مگر اینکه فرهنگ داده به صورت درونی در برنامه تعبیه شده باشد (پیش‌فرض برای ویندوز)\&. .PP رفتار پیش‌فرض ارجح است و از متغیر محیطی \fIDCMDICTPATH\fP فقط زمانی باید استفاده شود که فرهنگ‌های داده جایگزین مورد نیاز باشند\&. متغیر محیطی \fIDCMDICTPATH\fP ساختاری مشابه با متغیر \fIPATH\fP در شل یونیکس دارد که در آن دو نقطه (":") ورودی‌ها را از هم جدا می‌کند\&. در سیستم‌های ویندوز، نقطه ویرگول (";") به عنوان جداکننده به کار می‌رود\&. کد مربوط به فرهنگ داده تلاش می‌کند هر فایل مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. اگر هیچ فرهنگ داده‌ای بارگذاری نشود، این یک خطا محسوب می‌شود\&. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .PP Copyright (C) 2000-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.