گزینه‌های عمومی (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 برای logger
-lc   --log-config  [f]ilename: string
        استفاده از فایل پیکربندی f برای logger

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

قالب فایل ورودی:
  +f    --read-file
          خواندن قالب فایل یا مجموعه داده (پیش‌فرض)
  +fo   --read-file-only
          فقط خواندن قالب فایل
  -f    --read-dataset
          خواندن مجموعه داده بدون اطلاعات فراداده‌ای فایل
سینتکس انتقال ورودی:
  -t=   --read-xfer-auto
          استفاده از تشخیص خودکار TS (پیش‌فرض)
  -td   --read-xfer-detect
          نادیده گرفتن TS مشخص‌شده در سرآیند فراداده فایل
  -te   --read-xfer-little
          خواندن با TS از نوع explicit VR little endian
  -tb   --read-xfer-big
          خواندن با TS از نوع explicit VR big endian
  -ti   --read-xfer-implicit
          خواندن با TS از نوع implicit VR little endian

تبدیل modality LUT:
  +M    --use-modality
          استفاده از تبدیل modality LUT (پیش‌فرض)
  -M    --no-modality
          نادیده‌گرفتن تبدیل modality LUT ذخیره‌شده
تبدیل VOI LUT:
  -W    --no-windowing
          بدون پنجره‌بندی VOI (پیش‌فرض)
  +Wi   --use-window  [n]umber: integer
          استفاده از n-امین پنجرهٔ VOI از فایل تصویر
  +Wl   --use-voi-lut  [n]umber: integer
          استفاده از n-امین جدول تبدیل (look up table) VOI از فایل تصویر
  +Wm   --min-max-window
          محاسبهٔ پنجرهٔ VOI با استفاده از الگوریتم min-max
          به‌طور جداگانه روی هر دو تصویر
  +Wn   --min-max-window-n
          محاسبهٔ پنجرهٔ VOI با استفاده از الگوریتم min-max
          به‌طور جداگانه روی هر دو تصویر، با نادیده‌گرفتن مقادیر حدی
  +Wr   --min-max-ref
          محاسبهٔ پنجرهٔ VOI با استفاده از الگوریتم min-max
          و استفاده از همان پنجره برای تصویر آزمایشی
  +Wq   --min-max-n-ref
          محاسبهٔ پنجرهٔ VOI با استفاده از الگوریتم min-max،
          با نادیده‌گرفتن مقادیر حدی
          و استفاده از همان پنجره برای تصویر آزمایشی
  +Ww   --set-window  [c]enter [w]idth: float
          محاسبهٔ پنجرهٔ VOI با استفاده از مرکز c و پهنای w
  +Wfl  --linear-function
          تنظیم تابع VOI LUT روی LINEAR
  +Wfs  --sigmoid-function
          تنظیم تابع VOI LUT روی SIGMOID
تبدیل presentation LUT:
  +Pid  --identity-shape
          تنظیم شکل presentation LUT روی IDENTITY
  +Piv  --inverse-shape
          تنظیم شکل presentation LUT روی INVERSE
  +Pod  --lin-od-shape
          تنظیم شکل presentation LUT روی LIN OD

گزینه‌های معیارهای مقایسه تصویر (image comparison metrics options)

+ce   --check-error  [l]imit: integer
        بررسی این‌که آیا حداکثر خطای مطلق <= limit است
# در صورتی که حداکثر خطای مطلق محاسبه‌شده بزرگ‌تر از حد تعیین‌شده باشد،
# کد خروج EXITCODE_LIMIT_EXCEEDED_MAX_ERROR برگردانده می‌شود.
+cm   --check-mae  [l]imit: float
        بررسی این‌که آیا میانگین خطای مطلق <= limit است
# در صورتی که میانگین خطای مطلق محاسبه‌شده بزرگ‌تر از حد تعیین‌شده باشد،
# کد خروج EXITCODE_LIMIT_EXCEEDED_MAE برگردانده می‌شود.
+cr   --check-rmse  [l]imit: float
        بررسی این‌که آیا ریشهٔ میانگین مربعات خطا <= limit است
# در صورتی که ریشهٔ میانگین مربعات خطای محاسبه‌شده بزرگ‌تر از حد تعیین‌شده باشد،
# کد خروج EXITCODE_LIMIT_EXCEEDED_RMSE برگردانده می‌شود.
+cp   --check-psnr  [l]imit: float
        بررسی این‌که آیا PSNR >= limit است
# در صورتی که نسبت بیشینه سیگنال به نویز (PSNR) محاسبه‌شده کمتر از حد تعیین‌شده باشد،
# کد خروج EXITCODE_LIMIT_EXCEEDED_PSNR برگردانده می‌شود
# (برای PSNR، مقادیر بالاتر به معنای کیفیت بهتر تصویر است)
+cs   --check-snr  [l]imit: float
        بررسی این‌که آیا SNR >= limit است
# در صورتی که نسبت سیگنال به نویز محاسبه‌شده کمتر از حد تعیین‌شده باشد،
# کد خروج EXITCODE_LIMIT_EXCEEDED_PSNR برگردانده می‌شود
# (برای SNR، مقادیر بالاتر به معنای کیفیت بهتر تصویر است)

+sd   --save-diff  [f]ilename: string
        نوشتن تصویر تفاضلی secondary capture
# ایجاد یک تصویر Multiframe Secondary Capture که شامل یک تصویر تفاضلی بین
# تصویر مرجع و آزمون است. برای تصاویر تک‌رنگ (monochrome)، یک فریم تفاضلی
# به ازای هر فریم در تصویر مرجع ایجاد می‌شود. برای تصاویر رنگی، سه فریم
# تک‌رنگ به ازای هر فریم در تصویر مرجع ایجاد می‌شود که متناظر با تفاوت‌ها در
# صفحات رنگی قرمز، سبز و آبی هستند. تصویر تفاضلی بر اساس ویژگی‌های تصویر
# مرجع، دارای BitsStored برابر با ۸ یا ۱۶ خواهد بود.
+a    --amplify  [f]actor: float
        ضرب مقادیر پیکسل تصویر تفاضلی در f
# این گزینه می‌تواند برای تقویت مقادیر مقیاس خاکستری (grayscale) در تصویر
# تفاضلی از طریق ضرب هر مقدار در ضریب داده‌شده استفاده شود. به عنوان
# روش جایگزین، ممکن است هنگام مصورسازی تصویر تفاضلی از یک پنجره DICOM VOI LUT
# استفاده شود.

خط لوله نمایش مقیاس خاکستری (grayscale display pipeline)

تصاویر تک‌رنگ DICOM نیازمند اجرای یک خط لوله نمایش چندمرحله‌ای هستند تا مقادیر خام پیکسل به مقادیر موسوم به مقادیر ارائه (p-values) که به نمایشگر (احتمالاً کالیبره‌شده) ارسال می‌شوند تبدیل گردند. هنگام مقایسه شباهت تصاویر پیش و پس از پس‌پردازش، فعال‌سازی برخی از مراحل این خط لوله نمایش پیش از محاسبه تصویر تفاضلی و معیارها می‌تواند سودمند باشد. گزینه‌های پردازش تصویر به فراخواننده اجازه می‌دهند تبدیلات Modality LUT، VOI LUT و Presentation LUT را فعال یا غیرفعال کند. در هر صورت، تبدیل یکسانی بر روی هر دو تصویر اعمال می‌شود، اگرچه ممکن است با پارامترهای متفاوت باشد؛ برای مثال اگر «اولین پنجره VOI LUT» ذخیره‌شده در هر تصویر اعمال گردد. این امر با این فرض صورت می‌گیرد که الگوریتم پس‌پردازش (مانند الگوریتم فشرده‌سازی) مقادیر چنین پنجره‌هایی را در حین فشرده‌سازی به‌گونه‌ای تطبیق داده است که نمایش تصویر پس از اعمال پنجره تا حد ممکن به مرجع نزدیک باشد. برای تصاویر با بیش از ۸ بیت در هر نمونه (bits/sample) ممکن است دانستن اینکه کدام تبدیل VOI LUT توسط کاربر هنگام مشاهده تصویر اعمال می‌شود اهمیت داشته باشد، زیرا این موضوع می‌تواند بر کیفیت ادراک‌شده تصویر اثر بگذارد. بنابراین، پارامترهای مطلق Window را نیز می‌توان با گزینه --set-window مشخص کرد که متعاقباً بر روی هر دو تصویر اعمال خواهند شد.

مناسب بودن تصاویر برای اهداف تشخیصی (suitability of images for diagnostic purposes)

کاربر همچنین باید توجه داشته باشد که معیارهای محاسبه‌شده توسط این ابزار نمی‌توانند مناسب بودن تصویر فشرده‌شده با اتلاف (lossy) را برای اهداف تشخیصی پیش‌بینی یا برآورد کنند. برای این منظور، پردازش تصویر بسیار پیچیده‌تر و درک محتوای تصویر (مانند اندام یا عضو بدن) مورد نیاز خواهد بود. معیارهای محاسبه‌شده صرفاً تخمینی از میزان اعوجاج ناشی از پس‌پردازش ارائه می‌دهند - نه بیشتر و نه کمتر.

عمومی (general)

EXITCODE_NO_ERROR                         0
EXITCODE_COMMANDLINE_SYNTAX_ERROR         1

خطاهای فایل ورودی/خروجی (input/output file errors)

EXITCODE_INVALID_INPUT_FILE              22
EXITCODE_CANNOT_WRITE_OUTPUT_FILE        40

EXITCODE_INITIALIZE_DIFF_IMAGE           80
EXITCODE_DISPLAY_PIPELINE                81
EXITCODE_IMAGE_COMPARISON                82

کدهای خطای فراتر رفتن از حد مجاز

EXITCODE_LIMIT_EXCEEDED_MAX_ERROR        90
EXITCODE_LIMIT_EXCEEDED_MAE              91
EXITCODE_LIMIT_EXCEEDED_RMSE             92
EXITCODE_LIMIT_EXCEEDED_PSNR             93
EXITCODE_LIMIT_EXCEEDED_SNR              94