نام (NAME)

dcmdjpls - رمزگشایی فایل DICOM فشرده‌شده با JPEG-LS

خلاصه دستور (SYNOPSIS)

dcmdjpls [options] dcmfile-in dcmfile-out

توضیحات (DESCRIPTION)

ابزار dcmdjpls یک تصویر دایکام فشرده‌شده با JPEG-LS (dcmfile-in) را می‌خواند، داده‌های JPEG-LS را از حالت فشرده خارج می‌کند (یعنی تبدیل به نحو انتقال بومی دایکام) و تصویر تبدیل‌شده را در یک فایل خروجی (dcmfile-out) می‌نویسد.

پارامترها (PARAMETERS)

dcmfile-in   نام فایل ورودی DICOM برای تبدیل ("-" برای ورودی استاندارد stdin)
dcmfile-out  نام فایل خروجی DICOM ("-" برای خروجی استاندارد stdout)

گزینه‌ها (OPTIONS)

گزینه‌های عمومی (general options)

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

گزینه‌های ورودی (input options)

قالب فایل ورودی:
  +f   --read-file
         خواندن قالب فایل یا مجموعه داده (پیش‌فرض)
  +fo  --read-file-only
         فقط خواندن قالب فایل
  -f   --read-dataset
         خواندن مجموعه داده بدون متاداده‌های فایل
  # این گزینه امکان باز کردن اشیای DICOM فشرده‌شده با JPEG-LS را که به عنوان
  # مجموعه داده بدون هدر ذخیره شده‌اند فراهم می‌کند.

گزینه‌های پردازش (processing options)

پیکربندی سطوح رنگی (planar configuration):
  +pr  --planar-restore
         بازیابی پیکربندی سطحی اصلی (پیش‌فرض)
  # اگر تصویر فشرده‌شده یک تصویر رنگی باشد، پیکربندی سطحی را همان‌طور
  # که در ویژگی Planar Configuration توصیف شده بازیابی می‌کند.
  +pa  --planar-auto
         تعیین خودکار پیکربندی سطحی از روی کلاس SOP و فضای رنگی
  # اگر تصویر رنگی باشد، در صورت نیاز کلاس SOP و تفسیر نورسنجی،
  # آن را با پیکربندی color-by-plane ذخیره می‌کند.
  +px  --color-by-pixel
         ذخیره همیشگی به صورت رنگ به ازای هر پیکسل (color-by-pixel)
  +pl  --color-by-plane
         ذخیره همیشگی به صورت رنگ به ازای هر صفحه (color-by-plane)
شناسه نمونه SOP (SOP Instance UID):
  +ud  --uid-default
         حفظ همان شناسه نمونه SOP (پیش‌فرض)
  +ua  --uid-always
         همیشه شناسه جدید تخصیص داده شود
گزینه‌های اصلاحی برای انکودینگ‌های نادرست JPEG-LS:
  +wi  --workaround-incpl
         فعال‌سازی راهکار اصلاحی برای داده‌های ناقص JPEG-LS
سایر گزینه‌های پردازش:
  +io  --ignore-offsettable
         نادیده گرفتن جدول آفست هنگام خروج از فشرده‌سازی

گزینه‌های خروجی (output options)

قالب فایل خروجی:
  +F   --write-file
         نوشتن در قالب فایل (پیش‌فرض)
  -F   --write-dataset
         نوشتن مجموعه داده بدون متاداده‌های فایل
نحو انتقال خروجی:
  +te  --write-xfer-little
         نوشتن با نحو صریح VR و ترتیب بایت little endian (پیش‌فرض)
  +tb  --write-xfer-big
         نوشتن با نحو صریح VR و ترتیب بایت big endian
  +ti  --write-xfer-implicit
         نوشتن با نحو ضمنی VR و ترتیب بایت little endian
نمایش مقادیر بعد از سال ۱۹۹۳ (VR):
  +u   --enable-new-vr
         فعال‌سازی پشتیبانی از VRهای جدید (UN/UT) (پیش‌فرض)
  -u   --disable-new-vr
         غیرفعال کردن پشتیبانی از VRهای جدید، تبدیل به OB
کدگذاری طول گروه:
  +g=  --group-length-recalc
         محاسبه مجدد طول گروه‌ها در صورت وجود (پیش‌فرض)
  +g   --group-length-create
         همیشه با عناصر طول گروه نوشته شود
  -g   --group-length-remove
         همیشه بدون عناصر طول گروه نوشته شود
کدگذاری طول در توالی‌ها و آیتم‌ها:
  +e   --length-explicit
         نوشتن با طول‌های صریح (پیش‌فرض)
  -e   --length-undefined
         نوشتن با طول‌های تعریف‌نشده
پدینگ انتهای مجموعه داده (نه با --write-dataset):
  -p=  --padding-retain
         عدم تغییر پدینگ (پیش‌فرض بدون --write-dataset)
  -p   --padding-off
         بدون پدینگ (ضمنی در صورت استفاده از --write-dataset)
  +p   --padding-create  [f]ile-pad [i]tem-pad: integer
         تراز کردن فایل مضربی از f بایت و آیتم‌ها مضربی از i بایت

نحوهای انتقال (TRANSFER SYNTAXES)

ابزار dcmdjpls از نحوهای انتقال زیر برای ورودی (dcmfile-in) پشتیبانی می‌کند:

LittleEndianImplicitTransferSyntax             1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax             1.2.840.10008.1.2.1
DeflatedExplicitVRLittleEndianTransferSyntax   1.2.840.10008.1.2.1.99 (*)
BigEndianExplicitTransferSyntax                1.2.840.10008.1.2.2
JPEGLSLosslessTransferSyntax                   1.2.840.10008.1.2.4.80
JPEGLSLossyTransferSyntax                      1.2.840.10008.1.2.4.81

(*) در صورت کامپایل با پشتیبانی از zlib

ابزار dcmdjpls از نحوهای انتقال زیر برای خروجی (dcmfile-out) پشتیبانی می‌کند:

LittleEndianImplicitTransferSyntax             1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax             1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntax                1.2.840.10008.1.2.2

گزارش‌گیری (LOGGING)

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

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

خط فرمان (COMMAND LINE)

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

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

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

متغیرهای محیطی (ENVIRONMENT)

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

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

همچنین ببینید (SEE ALSO)

dcmcjpls(1)