.TH "dcmencap" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" dcmencap \- کپسوله‌سازی سند در قالب DICOM .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf dcmencap [options] docfile-in dcmfile-out .fi .PP .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBdcmencap\fP یک فایل سند را در یکی از قالب‌های پشتیبانی‌شده می‌خواند، آن را به یک نمونهٔ SOP از DICOM Encapsulated Storage SOP Class مربوطه تبدیل می‌کند و داده‌های تبدیل‌شده را در یک فایل خروجی (\fIdcmfile-out\fP) ذخیره می‌نماید\&. .SH "پارامترها (PARAMETERS)" .PP .PP .nf docfile-in نام فایل ورودی جهت تبدیل dcmfile-out نام فایل خروجی DICOM (مقدار "-" برای stdout) .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 قالب فایل ورودی: +fa --filetype-auto تشخیص خودکار نوع فایل (پیش‌فرض) +fp --filetype-pdf انتظار فایل PDF +fc --filetype-cda انتظار فایل CDA +fs --filetype-stl انتظار فایل STL +fm --filetype-mtl انتظار فایل MTL +fo --filetype-obj انتظار فایل OBJ .fi .PP .SS "گزینه‌های سند DICOM (DICOM document options)" .PP .nf عنوان سند: +t --title [t]itle: string (default: empty) عنوان سند +cn --concept-name [CSD] [CV] [CM]: string (default: empty) نمایش کدگذاری‌شده عنوان سند که توسط طراح طرح‌واره کدگذاری CSD، مقدار کد CV و معنای کد CM تعریف می‌شود اطلاعات بیمار: +pn --patient-name [n]ame: string نام بیمار با نحو PN در DICOM +pi --patient-id [i]d: string شناسه بیمار +pb --patient-birthdate [d]ate: string (YYYYMMDD) تاریخ تولد بیمار +ps --patient-sex [s]ex: string (M, F or O) جنسیت بیمار اطلاعات دستگاه: +mn --manufacturer [n]ame: string نام سازنده +mm --manufacturer-model [n]ame: string نام مدل سازنده +ds --device-serial [n]umber: string شماره سریال دستگاه +sv --software-versions [v]ersions: string نسخه‌های نرم‌افزار داده‌های مدل سه‌بعدی ساخت (تنها STL/MTL/OBJ): +mu --measurement-units [CSD] [CV] [CM]: string واحدهای اندازه‌گیری با طراح طرح‌واره کدگذاری CSD، مقدار کد CV و معنای کد CM (پیش‌فرض: UCUM, um, um) مطالعه و سری: +sg --generate تولید UIDهای جدید برای مطالعه و سری (پیش‌فرض) +st --study-from [f]ilename: string خواندن داده‌های بیمار/مطالعه از فایل DICOM +se --series-from [f]ilename: string خواندن داده‌های بیمار/مطالعه/سری از فایل DICOM شماره نمونه: +i1 --instance-one استفاده از شماره نمونه ۱ (پیش‌فرض، نه با +se) +ii --instance-inc افزایش شماره نمونه (تنها با +se) +is --instance-set [i]nstance number: integer استفاده از شماره نمونه i حاشیه‌نویسی حک‌شده: +an --annotation-yes سند حاوی داده‌های شناسایی بیمار است (پیش‌فرض) -an --annotation-no سند حاوی داده‌های شناسایی بیمار نیست .fi .PP .SS "گزینه‌های پردازش (processing options)" .PP .nf گزینه‌های پردازش CDA: -ov --no-override داده‌های بیمار و سند CDA باید با اطلاعات مطالعه، سری یا اطلاعات دستی واردشده مطابقت داشته باشند (پیش‌فرض) +ov --override داده‌های CDA با اطلاعات مطالعه، سری یا اطلاعات دستی واردشده بازنویسی خواهند شد سایر گزینه‌های پردازش: -k --key [k]ey: gggg,eeee="str", path or dictionary name="str" افزودن صفت بیشتر .fi .PP .SS "گزینه‌های خروجی (output options)" .PP .nf نحو انتقال خروجی: +te --write-xfer-little نوشتن با explicit VR little endian (پیش‌فرض) +tb --write-xfer-big نوشتن با TS از نوع explicit VR big endian +ti --write-xfer-implicit نوشتن با TS از نوع implicit VR little endian کدگذاری طول گروه: -g --group-length-remove نوشتن بدون عناصر طول گروه (پیش‌فرض) +g --group-length-create نوشتن با عناصر طول گروه کدگذاری طول در دنباله‌ها و آیتم‌ها: +e --length-explicit نوشتن با طول‌های صریح (پیش‌فرض) -e --length-undefined نوشتن با طول‌های تعریف‌نشده پدینگ انتهایی مجموعه داده (نه با --write-dataset): -p --padding-off بدون پدینگ (در صورت --write-dataset ضمنی است) +p --padding-create [f]ile-pad [i]tem-pad: integer تراز کردن فایل روی مضربی از f بایت و آیتم‌ها روی مضربی از i بایت .fi .PP .SH "نکات (NOTES)" .PP .SS "منابع صفت‌ها (Attribute Sources)" این برنامه می‌تواند ورودی‌های اضافی را برای پر کردن صفت‌های اجباری (و اختیاری) در فایل DICOM جدید، مانند اطلاعات بیمار، مطالعه و سری، دریافت کند: .PP .IP "\(bu" 2 گزینهٔ \fI--key\fP می‌تواند برای افزودن صفت‌های بیشتر به فایل خروجی DICOM استفاده شود\&. .IP "\(bu" 2 همچنین امکان مشخص کردن دنباله‌ها (sequences)، آیتم‌ها و صفت‌های تودرتو با استفاده از گزینهٔ \fI--key\fP وجود دارد\&. در این موارد، باید از قالب نشانه‌گذاری ویژهٔ "مسیر" (path) استفاده شود\&. جزئیات این نشانه‌گذاری مسیر در مستندات \fBdcmodify\fP یافت می‌شود\&. .IP "\(bu" 2 گزینهٔ \fI--key\fP می‌تواند بیش از یک بار مشخص شود\&. .IP "\(bu" 2 بخش مقدار (پس از علامت '=') ممکن است وجود نداشته باشد که در این حالت صفت با طول صفر تنظیم می‌شود\&. .IP "\(bu" 2 لطفاً توجه داشته باشید که گزینهٔ \fI--key\fP در پایان‌ترین مرحله، دقیقاً پیش از ذخیره فایل DICOM، اعمال می‌شود؛ بنابراین هیچ‌گونه اعتبارسنجی مقداری انجام نمی‌گیرد\&. .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 "وضعیت خروج (EXIT STATUS)" .PP ابزار \fBdcmencap\fP هنگام خاتمه از کدهای خروج زیر استفاده می‌کند\&. این به کاربر امکان می‌دهد تا دلیل خاتمه برنامه را بررسی کند\&. .SS "عمومی (general)" .PP .nf EXITCODE_NO_ERROR 0 .fi .PP .SS "خطاهای فایل ورودی (input file errors)" .PP .nf EXITCODE_INVALID_INPUT_FILE 22 .fi .PP .SS "خطاهای فایل خروجی (output file errors)" .PP .nf EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40 .fi .PP .SH "محیط (ENVIRONMENT)" .PP ابزار \fBdcmencap\fP تلاش خواهد کرد تا فرهنگ‌نامه‌های داده‌های DICOM مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. به‌طور پیش‌فرض، یعنی در صورتی که متغیر محیطی \fIDCMDICTPATH\fP تنظیم نشده باشد، فایل \fI/dicom\&.dic\fP بارگذاری خواهد شد مگر اینکه فرهنگ‌نامه درون برنامه تعبیه شده باشد (پیش‌فرض در ویندوز)\&. .PP رفتار پیش‌فرض باید ترجیح داده شود و متغیر محیطی \fIDCMDICTPATH\fP تنها در صورتی که فرهنگ‌نامه‌های دادهٔ جایگزین مورد نیاز باشند استفاده گردد\&. متغیر محیطی \fIDCMDICTPATH\fP قالبی مشابه متغیر \fIPATH\fP در شل یونیکس دارد و دونقطه (":") ورودی‌ها را از یکدیگر جدا می‌کند\&. در سیستم‌های ویندوز، نقطه ویرگول (";") به‌عنوان جداکننده استفاده می‌شود\&. کد فرهنگ‌نامهٔ داده تلاش خواهد کرد تا هر فایلی را که در متغیر محیطی \fIDCMDICTPATH\fP مشخص شده است بارگذاری نماید\&. بارگذاری نشدن هیچ فرهنگ‌نامهٔ داده‌ای یک خطا محسوب می‌شود\&. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .PP Copyright (C) 2018-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.