.TH "dcmmkdir" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" dcmmkdir \- ایجاد یک پرونده DICOMDIR .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf dcmmkdir [options] [dcmfile-in\&.\&.\&.] .fi .PP .SH "توضیحات (DESCRIPTION)" .PP ابزار .B dcmmkdir یک پرونده .I DICOMDIR از روی پرونده‌های دایکام ارجاع‌شده طبق پروفایل‌های کاربردی ذخیره‌سازی رسانه در بخش ۱۱ دایکام (DICOM Part 11) ایجاد می‌کند. .PP در حال حاضر پروفایل‌های زیر پشتیبانی می‌شوند (ممکن است موارد دیگر بعداً اضافه شوند): .PP .IP "\(bu" 2 General Purpose CD-R Interchange (STD-GEN-CD) .IP "\(bu" 2 General Purpose Interchange on DVD-RAM Media (STD-GEN-DVD-RAM) .IP "\(bu" 2 General Purpose Interchange on BD Media (STD-GEN-BD) .IP "\(bu" 2 General Purpose DVD Interchange with JPEG (STD-GEN-DVD-JPEG) .IP "\(bu" 2 General Purpose DVD Interchange with JPEG 2000 (STD-GEN-DVD-J2K) .IP "\(bu" 2 General Purpose BD Interchange with JPEG (STD-GEN-BD-JPEG) .IP "\(bu" 2 General Purpose BD Interchange with JPEG 2000 (STD-GEN-BD-J2K) .IP "\(bu" 2 General Purpose BD Interchange with MPEG2 MP@ML (STD-GEN-BD-MPEG2-MPML) .IP "\(bu" 2 General Purpose BD Interchange with MPEG2 MP@HL (STD-GEN-BD-MPEG2-MPHL) .IP "\(bu" 2 General Purpose BD Interchange with MPEG-4 AVC/H\&.264 HiP@Level4\&.1 (STD-GEN-BD-MPEG4-HPLV41) .IP "\(bu" 2 General Purpose BD Interchange with MPEG-4 AVC/H\&.264 BD-Compatible HiP@Level4\&.1 (STD-GEN-BD-MPEG4-HPLV41BD) .IP "\(bu" 2 General Purpose BD Interchange with MPEG-4 AVC/H\&.264 HiP@Level4\&.2 for 2D video (STD-GEN-BD-MPEG4-HPLV42-2D) .IP "\(bu" 2 General Purpose BD Interchange with MPEG-4 AVC/H\&.264 HiP@Level4\&.2 for 3D video (STD-GEN-BD-MPEG4-HPLV42-3D) .IP "\(bu" 2 General Purpose BD Interchange with MPEG-4 AVC/H\&.264 Stereo HiP@Level4\&.2 (STD-GEN-BD-MPEG4-SHPLV42) .IP "\(bu" 2 General Purpose USB and Flash Memory Interchange with JPEG (STD-GEN-USB/MMC/CF/SD-JPEG) .IP "\(bu" 2 General Purpose USB and Flash Memory Interchange with JPEG 2000 (STD-GEN-USB/MMC/CF/SD-J2K) .IP "\(bu" 2 General Purpose MIME Interchange (STD-GEN-MIME) .IP "\(bu" 2 DVD Interchange with MPEG2 MP@ML (STD-DVD-MPEG2-MPML) .IP "\(bu" 2 Basic Cardiac X-Ray Angiographic Studies on CD-R Media (STD-XABC-CD) .IP "\(bu" 2 1024 X-Ray Angiographic Studies on CD-R Media (STD-XA1K-CD) .IP "\(bu" 2 1024 X-Ray Angiographic Studies on DVD Media (STD-XA1K-DVD) .IP "\(bu" 2 Dental Radiograph Interchange (STD-DEN-CD) .IP "\(bu" 2 CT/MR Studies on various Media (STD-CTMR-xxxx) .IP "\(bu" 2 Ultrasound Single Frame for Image Display (STD-US-ID-SF-xxxx) .IP "\(bu" 2 Ultrasound Single Frame with Spatial Calibration (STD-US-SC-SF-xxxx) .IP "\(bu" 2 Ultrasound Single Frame with Combined Calibration (STD-US-CC-SF-xxxx) .IP "\(bu" 2 Ultrasound Single & Multi-Frame for Image Display (STD-US-ID-MF-xxxx) .IP "\(bu" 2 Ultrasound Single & Multi-Frame with Spatial Calibration (STD-US-SC-MF-xxxx) .IP "\(bu" 2 Ultrasound Single & Multi-Frame with Combined Calibration (STD-US-CC-MF-xxxx) .IP "\(bu" 2 12-lead ECG Interchange on Diskette (STD-WVFM-ECG-FD) .IP "\(bu" 2 Hemodynamic Waveform Interchange on Diskette (STD-WVFM-HD-FD) .PP .PP این ابزار قابلیت‌های .B dcmgpdir را گسترش می‌دهد؛ ابزاری که فقط می‌تواند پرونده‌های .I DICOMDIR با کاربرد عمومی (General Purpose) بسازد. رفتار پیش‌فرض .B dcmmkdir (با گزینه .IR --general-purpose ) معادل با رفتار .B dcmgpdir است. .SH "پارامترها (PARAMETERS)" .PP .PP .nf dcmfile-in پرونده ارجاع‌شده دایکام (یا پوشه‌ای که باید پیمایش شود) .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 شناسه‌های DICOMDIR: +F --fileset-id [i]d: string استفاده از شناسه مشخص برای مجموعه پرونده (پیش‌فرض: DCMTK_MEDIA_DEMO، مقدار "" برای هیچ‌کدام) +R --descriptor [f]ilename: string افزودن شناسه پرونده توصیف‌کننده مجموعه (مثلاً README، پیش‌فرض: بدون توصیف‌کننده) +C --char-set [c]harset: string افزودن مجموعه نویسه مشخص برای توصیف‌کننده (پیش‌فرض: "ISO_IR 100" در صورت وجود توصیف‌کننده) خواندن: +id --input-directory [d]irectory: string خواندن پرونده‌های ارجاع‌شده دایکام از پوشه d (پیش‌فرض برای --recurse: پوشه جاری) -m --keep-filenames انتظار قرار داشتن نام پرونده‌ها در قالب دایکام (پیش‌فرض) +m --map-filenames نگاشت به نام پرونده‌های دایکام (تبدیل حروف کوچک به بزرگ و حذف نقطه پایانی) -r --no-recurse عدم پیمایش بازگشتی در پوشه‌ها (پیش‌فرض) +r --recurse پیمایش بازگشتی در پوشه‌های سیستم فایل +p --pattern [p]attern: string (تنها همراه با --recurse) الگو برای تطابق نام پرونده (کاراکترهای عام) # احتمالاً در همه سیستم‌ها در دسترس نیست .fi .PP .SS "گزینه‌های پردازش (processing options)" .PP .nf بررسی سازگاری: -W --no-consistency-check عدم بررسی سازگاری پرونده‌ها +W --warn-inconsist-files هشدار در مورد پرونده‌های ناسازگار (پیش‌فرض) -a --abort-inconsist-file توقف در اولین پرونده ناسازگار ویژگی‌های نوع ۱ (type 1 attributes): -I --strict خروج با خطا در صورت مفقود بودن ویژگی‌های نوع ۱ DICOMDIR در پرونده دایکام (پیش‌فرض) +I --invent تولید خودکار ویژگی‌های نوع ۱ DICOMDIR در صورت مفقود بودن در پرونده دایکام +Ipi --invent-patient-id تولید خودکار PatientID جدید در صورت ناسازگاری ویژگی‌های PatientName سایر بررسی‌ها: +Nrs --allow-retired-sop مجاز دانستن کلاس‌های منسوخ SOP تعریف‌شده در ویرایش‌های قبلی استاندارد دایکام -Nxc --no-xfer-check عدم رد تصاویر دارای نحو انتقال غیراستاندارد (تنها هشدار داده می‌شود) -Nec --no-encoding-check عدم رد تصاویر دارای کدگذاری پیکسل غیراستاندارد (تنها هشدار داده می‌شود) -Nrc --no-resolution-check عدم رد تصاویر دارای تفکیک‌پذیری مکانی غیراستاندارد (تنها هشدار داده می‌شود) تصاویر آیکون: +X --add-icon-image افزودن تصویر آیکون تک‌رنگ در سطح IMAGE (پیش‌فرض برای پروفایل‌های قلبی) -Xs --icon-image-size [s]ize: integer (1\&.\&.128) عرض و ارتفاع تصویر آیکون (به پیکسل) (ثابت: ۱۲۸ برای XA، ۶۴ برای پروفایل CT/MR) -Xi --icon-file-prefix [p]refix: string استفاده از تصویر PGM با نام 'prefix'+'dcmfile-in' به‌عنوان آیکون (پیش‌فرض: ایجاد آیکون از تصویر دایکام) -Xd --default-icon [f]ilename: string استفاده از تصویر PGM مشخص در صورت عدم امکان ایجاد خودکار آیکون (پیش‌فرض: تصویر سیاه) .fi .PP .SS "گزینه‌های خروجی (output options)" .PP .nf پرونده DICOMDIR: +D --output-file [f]ilename: string تولید پرونده مشخص DICOMDIR (پیش‌فرض: DICOMDIR در پوشه جاری) پروفایل‌ها: -Pgp --general-purpose تبادل چندمنظوره روی رسانه‌های CD-R، DVD-RAM یا BD (STD-GEN-CD/DVD-RAM/BD، پیش‌فرض) -Pdv --general-dvd-jpeg تبادل چندمنظوره DVD با JPEG (STD-GEN-DVD-JPEG) -Pd2 --general-dvd-j2k تبادل چندمنظوره DVD با JPEG 2000 (STD-GEN-DVD-J2K) -Pbd --general-bd-jpeg تبادل چندمنظوره BD با JPEG (STD-GEN-BD-JPEG) -Pb2 --general-bd-j2k تبادل چندمنظوره BD با JPEG 2000 (STD-GEN-BD-J2K) -Pbm --general-bd-mpeg2-mpml تبادل چندمنظوره BD با MPEG2 MP@ML (STD-GEN-BD-MPEG2-MPML) -Pbh --general-bd-mpeg2-mphl تبادل چندمنظوره BD با MPEG2 MP@HL (STD-GEN-BD-MPEG2-MPHL) -Pba --general-bd-mpeg4-hp تبادل چندمنظوره BD با MPEG-4 AVC/H\&.264 HiP@Level4\&.1 (STD-GEN-BD-MPEG4-HPLV41) -Pbb --general-bd-mpeg4-hpbd تبادل چندمنظوره BD با MPEG-4 AVC/H\&.264 سازگار با BD در HiP@Level4\&.1 (STD-GEN-BD-MPEG4-HPLV41BD) --general-bd-mpeg4-hp2d تبادل چندمنظوره BD با MPEG-4 AVC/H\&.264 HiP@Level4\&.2 برای ویدیوی دو‌بعدی (STD-GEN-BD-MPEG4-HPLV42-2D) --general-bd-mpeg4-hp3d تبادل چندمنظوره BD با MPEG-4 AVC/H\&.264 HiP@Level4\&.2 برای ویدیوی سه‌بعدی (STD-GEN-BD-MPEG4-HPLV42-3D) --general-bd-mpeg4-hpst تبادل چندمنظوره BD با MPEG-4 AVC/H\&.264 استریو HiP@Level4\&.2 (STD-GEN-BD-MPEG4-SHPLV42) -Pfl --usb-and-flash-jpeg تبادل چندمنظوره حافظه فلش و USB با JPEG (STD-GEN-USB/MMC/CF/SD-JPEG) -Pf2 --usb-and-flash-j2k تبادل چندمنظوره حافظه فلش و USB با JPEG 2000 (STD-GEN-USB/MMC/CF/SD-J2K) -Pmi --general-mime تبادل چندمنظوره MIME (STD-GEN-MIME) -Pmp --mpeg2-mpml-dvd تبادل DVD با MPEG2 Main Profile @ Main Level (STD-DVD-MPEG2-MPML) -Pbc --basic-cardiac مطالعات آنژیوگرافی پایه اشعه ایکس قلب روی دیسک CD-R (STD-XABC-CD) -Pxa --xray-angiographic مطالعات آنژیوگرافی اشعه ایکس ۱۰۲۴ روی دیسک CD-R (STD-XA1K-CD) -Pxd --xray-angiographic-dvd مطالعات آنژیوگرافی اشعه ایکس ۱۰۲۴ روی دیسک DVD (STD-XA1K-DVD) -Pde --dental-radiograph تبادل رادیوگرافی دندان (STD-DEN-CD) -Pcm --ct-and-mr مطالعات CT/MR (STD-CTMR-xxxx) -Pus --ultrasound-id-sf تک‌فریم سونوگرافی برای نمایش تصویر (STD-US-ID-SF-xxxx) --ultrasound-sc-sf تک‌فریم سونوگرافی با کالیبراسیون مکانی (STD-US-SC-SF-xxxx) --ultrasound-cc-sf تک‌فریم سونوگرافی با کالیبراسیون ترکیبی (STD-US-CC-SF-xxxx) -Pum --ultrasound-id-mf تک‌فریم و چندفریم سونوگرافی برای نمایش تصویر (STD-US-ID-MF-xxxx) --ultrasound-sc-mf تک‌فریم و چندفریم سونوگرافی با کالیبراسیون مکانی (STD-UD-SC-MF-xxxx) --ultrasound-cc-mf تک‌فریم و چندفریم سونوگرافی با کالیبراسیون ترکیبی (STD-UD-CC-MF-xxxx) -Pec --12-lead-ecg تبادل الکتروکاردیوگرام ۱۲ لید روی فلاپی دیسک (STD-WVFM-ECG-FD) -Phd --hemodynamic-waveform تبادل شکل‌موج همودینامیک روی فلاپی دیسک (STD-WVFM-HD-FD) نوشتن: -A --replace جایگزینی پرونده DICOMDIR موجود (پیش‌فرض) +A --append الحاق به پرونده DICOMDIR موجود +U --update به‌روزرسانی پرونده DICOMDIR موجود -w --discard عدم نوشتن DICOMDIR روی دیسک پشتیبان‌گیری: --create-backup ایجاد نسخه پشتیبان از پرونده DICOMDIR موجود (پیش‌فرض) -nb --no-backup عدم ایجاد نسخه پشتیبان از پرونده DICOMDIR موجود نمایش مقادیر بعد از ۱۹۹۳ (post-1993 value representations): +u --enable-new-vr فعال‌سازی پشتیبانی از VRهای جدید (UN/UT) (پیش‌فرض) -u --disable-new-vr غیرفعال‌سازی پشتیبانی از VRهای جدید، تبدیل به OB کدگذاری طول گروه (group length encoding): -g --group-length-remove نوشتن بدون عناصر طول گروه (پیش‌فرض) +g --group-length-create نوشتن همراه با عناصر طول گروه کدگذاری طول در دنباله‌ها و آیتم‌ها: +e --length-explicit نوشتن با طول‌های صریح (پیش‌فرض) -e --length-undefined نوشتن با طول‌های نامشخص .fi .PP .SH "نکات (NOTES)" .PP تمام پرونده‌های مشخص‌شده در خط فرمان (یا پرونده‌هایی که با پیمایش بازگشتی در پوشه‌ها از طریق گزینه .I +r یافت می‌شوند) ابتدا از نظر سازگاری با پروفایل کاربردی ذخیره‌سازی رسانه مشخص‌شده (Part 11) ارزیابی می‌شوند. تنها پرونده‌های مناسبی که با یکی از نحوهای مجاز انتقال (Transfer Syntaxes) کدگذاری شده باشند پذیرفته خواهند شد. پرونده‌هایی با نام نامعتبر رد خواهند شد (این قوانین با گزینه .I +m تسهیل می‌شوند). پرونده‌های فاقد ویژگی‌های الزامی رد می‌شوند (گزینه .I +I می‌تواند این رفتار را منعطف‌تر کند). .PP پرونده .I DICOMDIR تنها در صورتی ایجاد خواهد شد که همه پرونده‌ها آزمایش‌های اولیه را با موفقیت پشت سر بگذارند. .PP ابزار .B dcmmkdir همچنین امکان افزودن ورودی‌های جدید به پرونده .I DICOMDIR و به‌روزرسانی رکوردهای موجود را فراهم می‌کند. با استفاده از گزینه .I +A ورودی‌های جدید تنها به DICOMDIR الحاق می‌شوند، یعنی رکوردهای موجود مانند اطلاعات بیمار (PATIENT) به‌روزرسانی نمی‌شوند. با استفاده از گزینه .I +U رکوردهای موجود نیز طبق اطلاعات موجود در پرونده‌های دایکام ارجاع‌شده به‌روزرسانی خواهند شد. لطفاً توجه داشته باشید که این فرآیند به‌روزرسانی ممکن است کندتر از الحاق صرف ورودی‌های جدید باشد. با این حال تضمین می‌کند اطلاعات اضافی مورد نیاز برای پروفایل کاربردی انتخابی به رکوردهای موجود نیز افزوده شود. .PP پشتیبانی از تصاویر آیکون در حال حاضر به تصاویر تک‌رنگ (سیاه و سفید) محدود است. این محدودیت ممکن است در آینده تغییر کند. تا آن زمان تصاویر رنگی به طور خودکار به حالت مقیاس خاکستری تبدیل می‌شوند. اندازه آیکون برای پروفایل‌های قلبی ۱۲۸*۱۲۸ پیکسل (طبق الزام استاندارد دایکام) و برای سایر موارد ۶۴*۶۴ است. .SS "پیمایش پوشه‌ها" افزودن پرونده‌ها از داخل پوشه‌ها با استفاده از گزینه .I --recurse امکان‌پذیر است. اگر پارامتر خط فرمان دیگری مشخص نشود، پوشه تعیین‌شده با گزینه .I --input-directory (پیش‌فرض: پوشه جاری) برای یافتن پرونده‌ها پیمایش می‌شود. اگر پارامترهایی داده شوند، می‌توانند نام یک پرونده یا پوشه را تعیین کنند؛ پوشه ورودی همیشه به ابتدای آن‌ها اضافه می‌شود. اگر پرونده‌های موجود در پوشه‌ها باید طبق الگوی نام مشخصی انتخاب شوند (مثلاً با کاراکترهای عام)، باید از گزینه .I --pattern استفاده شود. لطفاً توجه داشته باشید که این الگوی پرونده تنها بر پرونده‌های درون پوشه‌های پیمایش‌شده اعمال می‌شود و الگوهای مشخص‌شده دیگر در خط فرمان خارج از گزینه .I --input-directory (مثلاً برای انتخاب پرونده‌های بیشتر) بر پوشه‌های مذکور اعمال نخواهند شد. .SH "گزارش‌گیری (LOGGING)" .PP سطح گزارش‌گیری خروجی ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر مشخص شود. به طور پیش‌فرض تنها خطاها و هشدارها در جریان خطای استاندارد (standard error) نوشته می‌شوند. با استفاده از گزینه .I --verbose پیام‌های اطلاعاتی مانند جزئیات پردازش نیز گزارش می‌شوند. گزینه .I --debug می‌تواند برای دریافت جزئیات بیشتر درباره فعالیت‌های داخلی استفاده شود (مثلاً برای اشکال‌زدایی). سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینه .I --log-level انتخاب کرد. در حالت .I --quiet تنها خطاهای مهلک گزارش می‌شوند. در چنین رویدادهای خطای شدیدی، برنامه معمولاً متوقف خواهد شد. برای جزئیات بیشتر درباره سطوح مختلف گزارش‌گیری، مستندات ماژول "oflog" را ببینید. .PP در صورتی که خروجی گزارش‌گیری باید در پرونده نوشته شود (اختیاراً با چرخش پرونده لاگ)، به syslog (در یونیکس) یا event log (در ویندوز) ارسال شود، می‌توان از گزینه .I --log-config استفاده کرد. این پرونده پیکربندی همچنین اجازه می‌دهد تنها پیام‌های خاصی به جریان خروجی مشخصی هدایت شوند و فیلتر کردن پیام‌ها بر اساس ماژول یا برنامه‌ای که در آن تولید شده‌اند انجام گیرد. نمونه‌ای از این پرونده پیکربندی در .I /logger\&.cfg ارائه شده است. .SH "خط فرمان (COMMAND LINE)" .PP تمام ابزارهای خط فرمان از نمادگذاری زیر برای پارامترها استفاده می‌کنند: براکت‌ها مقادیر اختیاری را در بر می‌گیرند (۰-۱)، سه نقطه پایانی نشان می‌دهد چند مقدار مجاز است (۱-n)، و ترکیب هر دو به معنای ۰ تا n مقدار است. .PP گزینه‌های خط فرمان با علامت پیشوند '+' یا '-' از پارامترها متمایز می‌شوند. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان اختیاری است (یعنی می‌توانند در هر جایی ظاهر شوند). با این حال اگر گزینه‌ها ناسازگار با یکدیگر باشند، آخرین مورد سمت راست اعمال می‌شود. این رفتار مطابق با قواعد ارزیابی استاندارد در پوسته‌های رایج یونیکس است. .PP علاوه بر این، می‌توان یک یا چند پرونده دستور را با استفاده از علامت '@' به عنوان پیشوند نام پرونده مشخص کرد (مانند .IR @command\&.txt ). چنین آرگومان دستوری قبل از هرگونه پردازش بیشتر، با محتوای پرونده متنی مربوطه جایگزین می‌شود (چندین فاصله خالی مانند یک فاصله جداکننده عمل می‌کنند مگر اینکه درون علامت نقل قول باشند). لطفاً توجه داشته باشید که یک پرونده دستور نمی‌تواند شامل پرونده دستور دیگری باشد. این رویکرد ساده اما مؤثر امکان خلاصه کردن ترکیب‌های رایج گزینه‌ها/پارامترها را فراهم کرده و از طولانی شدن و پیچیدگی خط فرمان جلوگیری می‌کند (یک نمونه در پرونده .I /dumppat\&.txt ارائه شده است). .SH "محیط (ENVIRONMENT)" .PP ابزار .B dcmmkdir تلاش خواهد کرد فرهنگ داده‌های دایکام مشخص‌شده در متغیر محیطی .I DCMDICTPATH را بارگذاری کند. به طور پیش‌فرض، یعنی در صورتی که متغیر محیطی .I DCMDICTPATH تنظیم نشده باشد، پرونده .I /dicom\&.dic بارگذاری خواهد شد مگر اینکه فرهنگ داده به صورت توکار در برنامه گنجانده شده باشد (پیش‌فرض در ویندوز). .PP رفتار پیش‌فرض ارجح است و متغیر محیطی .I DCMDICTPATH تنها باید زمانی استفاده شود که فرهنگ داده‌های جایگزین مورد نیاز باشد. متغیر محیطی .I DCMDICTPATH قالب مشابه متغیر .I PATH پوسته یونیکس دارد که در آن دو نقطه (":") ورودی‌ها را جدا می‌کند. در سیستم‌های ویندوز از نقطه ویرگول (";") به عنوان جداکننده استفاده می‌شود. کد فرهنگ داده تلاش می‌کند هر پرونده مشخص‌شده در متغیر محیطی .I DCMDICTPATH را بارگذاری کند. عدم امکان بارگذاری هرگونه فرهنگ داده یک خطا محسوب می‌شود. .SH "همچنین ببینید (SEE ALSO)" .PP .BR dcmgpdir (1) .SH "حق نشر (COPYRIGHT)" .PP Copyright (C) 2001-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.