dcmmkdir(1) OFFIS DCMTK dcmmkdir(1)

dcmmkdir - ایجاد یک پرونده DICOMDIR

dcmmkdir [options] [dcmfile-in...]

ابزار dcmmkdir یک پرونده DICOMDIR از روی پرونده‌های دایکام ارجاع‌شده طبق پروفایل‌های کاربردی ذخیره‌سازی رسانه در بخش ۱۱ دایکام (DICOM Part 11) ایجاد می‌کند.

در حال حاضر پروفایل‌های زیر پشتیبانی می‌شوند (ممکن است موارد دیگر بعداً اضافه شوند):

  • General Purpose CD-R Interchange (STD-GEN-CD)
  • General Purpose Interchange on DVD-RAM Media (STD-GEN-DVD-RAM)
  • General Purpose Interchange on BD Media (STD-GEN-BD)
  • General Purpose DVD Interchange with JPEG (STD-GEN-DVD-JPEG)
  • General Purpose DVD Interchange with JPEG 2000 (STD-GEN-DVD-J2K)
  • General Purpose BD Interchange with JPEG (STD-GEN-BD-JPEG)
  • General Purpose BD Interchange with JPEG 2000 (STD-GEN-BD-J2K)
  • General Purpose BD Interchange with MPEG2 MP@ML (STD-GEN-BD-MPEG2-MPML)
  • General Purpose BD Interchange with MPEG2 MP@HL (STD-GEN-BD-MPEG2-MPHL)
  • General Purpose BD Interchange with MPEG-4 AVC/H.264 HiP@Level4.1 (STD-GEN-BD-MPEG4-HPLV41)
  • General Purpose BD Interchange with MPEG-4 AVC/H.264 BD-Compatible HiP@Level4.1 (STD-GEN-BD-MPEG4-HPLV41BD)
  • General Purpose BD Interchange with MPEG-4 AVC/H.264 HiP@Level4.2 for 2D video (STD-GEN-BD-MPEG4-HPLV42-2D)
  • General Purpose BD Interchange with MPEG-4 AVC/H.264 HiP@Level4.2 for 3D video (STD-GEN-BD-MPEG4-HPLV42-3D)
  • General Purpose BD Interchange with MPEG-4 AVC/H.264 Stereo HiP@Level4.2 (STD-GEN-BD-MPEG4-SHPLV42)
  • General Purpose USB and Flash Memory Interchange with JPEG (STD-GEN-USB/MMC/CF/SD-JPEG)
  • General Purpose USB and Flash Memory Interchange with JPEG 2000 (STD-GEN-USB/MMC/CF/SD-J2K)
  • General Purpose MIME Interchange (STD-GEN-MIME)
  • DVD Interchange with MPEG2 MP@ML (STD-DVD-MPEG2-MPML)
  • Basic Cardiac X-Ray Angiographic Studies on CD-R Media (STD-XABC-CD)
  • 1024 X-Ray Angiographic Studies on CD-R Media (STD-XA1K-CD)
  • 1024 X-Ray Angiographic Studies on DVD Media (STD-XA1K-DVD)
  • Dental Radiograph Interchange (STD-DEN-CD)
  • CT/MR Studies on various Media (STD-CTMR-xxxx)
  • Ultrasound Single Frame for Image Display (STD-US-ID-SF-xxxx)
  • Ultrasound Single Frame with Spatial Calibration (STD-US-SC-SF-xxxx)
  • Ultrasound Single Frame with Combined Calibration (STD-US-CC-SF-xxxx)
  • Ultrasound Single & Multi-Frame for Image Display (STD-US-ID-MF-xxxx)
  • Ultrasound Single & Multi-Frame with Spatial Calibration (STD-US-SC-MF-xxxx)
  • Ultrasound Single & Multi-Frame with Combined Calibration (STD-US-CC-MF-xxxx)
  • 12-lead ECG Interchange on Diskette (STD-WVFM-ECG-FD)
  • Hemodynamic Waveform Interchange on Diskette (STD-WVFM-HD-FD)

این ابزار قابلیت‌های dcmgpdir را گسترش می‌دهد؛ ابزاری که فقط می‌تواند پرونده‌های DICOMDIR با کاربرد عمومی (General Purpose) بسازد. رفتار پیش‌فرض dcmmkdir (با گزینه --general-purpose) معادل با رفتار dcmgpdir است.

dcmfile-in  پرونده ارجاع‌شده دایکام (یا پوشه‌ای که باید پیمایش شود)

-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 برای ثبت‌کننده وقایع

شناسه‌های 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)
          الگو برای تطابق نام پرونده (کاراکترهای عام)
          # احتمالاً در همه سیستم‌ها در دسترس نیست

بررسی سازگاری:
  -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 مشخص در صورت عدم امکان ایجاد
          خودکار آیکون (پیش‌فرض: تصویر سیاه)

پرونده 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
          نوشتن با طول‌های نامشخص

تمام پرونده‌های مشخص‌شده در خط فرمان (یا پرونده‌هایی که با پیمایش بازگشتی در پوشه‌ها از طریق گزینه +r یافت می‌شوند) ابتدا از نظر سازگاری با پروفایل کاربردی ذخیره‌سازی رسانه مشخص‌شده (Part 11) ارزیابی می‌شوند. تنها پرونده‌های مناسبی که با یکی از نحوهای مجاز انتقال (Transfer Syntaxes) کدگذاری شده باشند پذیرفته خواهند شد. پرونده‌هایی با نام نامعتبر رد خواهند شد (این قوانین با گزینه +m تسهیل می‌شوند). پرونده‌های فاقد ویژگی‌های الزامی رد می‌شوند (گزینه +I می‌تواند این رفتار را منعطف‌تر کند).

پرونده DICOMDIR تنها در صورتی ایجاد خواهد شد که همه پرونده‌ها آزمایش‌های اولیه را با موفقیت پشت سر بگذارند.

ابزار dcmmkdir همچنین امکان افزودن ورودی‌های جدید به پرونده DICOMDIR و به‌روزرسانی رکوردهای موجود را فراهم می‌کند. با استفاده از گزینه +A ورودی‌های جدید تنها به DICOMDIR الحاق می‌شوند، یعنی رکوردهای موجود مانند اطلاعات بیمار (PATIENT) به‌روزرسانی نمی‌شوند. با استفاده از گزینه +U رکوردهای موجود نیز طبق اطلاعات موجود در پرونده‌های دایکام ارجاع‌شده به‌روزرسانی خواهند شد. لطفاً توجه داشته باشید که این فرآیند به‌روزرسانی ممکن است کندتر از الحاق صرف ورودی‌های جدید باشد. با این حال تضمین می‌کند اطلاعات اضافی مورد نیاز برای پروفایل کاربردی انتخابی به رکوردهای موجود نیز افزوده شود.

پشتیبانی از تصاویر آیکون در حال حاضر به تصاویر تک‌رنگ (سیاه و سفید) محدود است. این محدودیت ممکن است در آینده تغییر کند. تا آن زمان تصاویر رنگی به طور خودکار به حالت مقیاس خاکستری تبدیل می‌شوند. اندازه آیکون برای پروفایل‌های قلبی ۱۲۸*۱۲۸ پیکسل (طبق الزام استاندارد دایکام) و برای سایر موارد ۶۴*۶۴ است.

افزودن پرونده‌ها از داخل پوشه‌ها با استفاده از گزینه --recurse امکان‌پذیر است. اگر پارامتر خط فرمان دیگری مشخص نشود، پوشه تعیین‌شده با گزینه --input-directory (پیش‌فرض: پوشه جاری) برای یافتن پرونده‌ها پیمایش می‌شود. اگر پارامترهایی داده شوند، می‌توانند نام یک پرونده یا پوشه را تعیین کنند؛ پوشه ورودی همیشه به ابتدای آن‌ها اضافه می‌شود. اگر پرونده‌های موجود در پوشه‌ها باید طبق الگوی نام مشخصی انتخاب شوند (مثلاً با کاراکترهای عام)، باید از گزینه --pattern استفاده شود. لطفاً توجه داشته باشید که این الگوی پرونده تنها بر پرونده‌های درون پوشه‌های پیمایش‌شده اعمال می‌شود و الگوهای مشخص‌شده دیگر در خط فرمان خارج از گزینه --input-directory (مثلاً برای انتخاب پرونده‌های بیشتر) بر پوشه‌های مذکور اعمال نخواهند شد.

سطح گزارش‌گیری خروجی ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر مشخص شود. به طور پیش‌فرض تنها خطاها و هشدارها در جریان خطای استاندارد (standard error) نوشته می‌شوند. با استفاده از گزینه --verbose پیام‌های اطلاعاتی مانند جزئیات پردازش نیز گزارش می‌شوند. گزینه --debug می‌تواند برای دریافت جزئیات بیشتر درباره فعالیت‌های داخلی استفاده شود (مثلاً برای اشکال‌زدایی). سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینه --log-level انتخاب کرد. در حالت --quiet تنها خطاهای مهلک گزارش می‌شوند. در چنین رویدادهای خطای شدیدی، برنامه معمولاً متوقف خواهد شد. برای جزئیات بیشتر درباره سطوح مختلف گزارش‌گیری، مستندات ماژول "oflog" را ببینید.

در صورتی که خروجی گزارش‌گیری باید در پرونده نوشته شود (اختیاراً با چرخش پرونده لاگ)، به syslog (در یونیکس) یا event log (در ویندوز) ارسال شود، می‌توان از گزینه --log-config استفاده کرد. این پرونده پیکربندی همچنین اجازه می‌دهد تنها پیام‌های خاصی به جریان خروجی مشخصی هدایت شوند و فیلتر کردن پیام‌ها بر اساس ماژول یا برنامه‌ای که در آن تولید شده‌اند انجام گیرد. نمونه‌ای از این پرونده پیکربندی در <etcdir>/logger.cfg ارائه شده است.

تمام ابزارهای خط فرمان از نمادگذاری زیر برای پارامترها استفاده می‌کنند: براکت‌ها مقادیر اختیاری را در بر می‌گیرند (۰-۱)، سه نقطه پایانی نشان می‌دهد چند مقدار مجاز است (۱-n)، و ترکیب هر دو به معنای ۰ تا n مقدار است.

گزینه‌های خط فرمان با علامت پیشوند '+' یا '-' از پارامترها متمایز می‌شوند. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان اختیاری است (یعنی می‌توانند در هر جایی ظاهر شوند). با این حال اگر گزینه‌ها ناسازگار با یکدیگر باشند، آخرین مورد سمت راست اعمال می‌شود. این رفتار مطابق با قواعد ارزیابی استاندارد در پوسته‌های رایج یونیکس است.

علاوه بر این، می‌توان یک یا چند پرونده دستور را با استفاده از علامت '@' به عنوان پیشوند نام پرونده مشخص کرد (مانند @command.txt). چنین آرگومان دستوری قبل از هرگونه پردازش بیشتر، با محتوای پرونده متنی مربوطه جایگزین می‌شود (چندین فاصله خالی مانند یک فاصله جداکننده عمل می‌کنند مگر اینکه درون علامت نقل قول باشند). لطفاً توجه داشته باشید که یک پرونده دستور نمی‌تواند شامل پرونده دستور دیگری باشد. این رویکرد ساده اما مؤثر امکان خلاصه کردن ترکیب‌های رایج گزینه‌ها/پارامترها را فراهم کرده و از طولانی شدن و پیچیدگی خط فرمان جلوگیری می‌کند (یک نمونه در پرونده <datadir>/dumppat.txt ارائه شده است).

ابزار dcmmkdir تلاش خواهد کرد فرهنگ داده‌های دایکام مشخص‌شده در متغیر محیطی DCMDICTPATH را بارگذاری کند. به طور پیش‌فرض، یعنی در صورتی که متغیر محیطی DCMDICTPATH تنظیم نشده باشد، پرونده <datadir>/dicom.dic بارگذاری خواهد شد مگر اینکه فرهنگ داده به صورت توکار در برنامه گنجانده شده باشد (پیش‌فرض در ویندوز).

رفتار پیش‌فرض ارجح است و متغیر محیطی DCMDICTPATH تنها باید زمانی استفاده شود که فرهنگ داده‌های جایگزین مورد نیاز باشد. متغیر محیطی DCMDICTPATH قالب مشابه متغیر PATH پوسته یونیکس دارد که در آن دو نقطه (":") ورودی‌ها را جدا می‌کند. در سیستم‌های ویندوز از نقطه ویرگول (";") به عنوان جداکننده استفاده می‌شود. کد فرهنگ داده تلاش می‌کند هر پرونده مشخص‌شده در متغیر محیطی DCMDICTPATH را بارگذاری کند. عدم امکان بارگذاری هرگونه فرهنگ داده یک خطا محسوب می‌شود.

dcmgpdir(1)

Copyright (C) 2001-2025 by OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany.

Thu Jul 9 2026 18:43:40 Version 3.7.0