نام (NAME)

dcmdspfn - برون‌ریزی منحنی‌های استاندارد نمایش به یک فایل متنی

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

dcmdspfn [options]

توضیحات (DESCRIPTION)

این برنامهٔ خط فرمانی، فایل مشخصات مانیتور / دوربین / چاپگر / اسکنر DCMTK را به یک فایل متنی با ستون‌بندی تب (tabbed) تبدیل می‌کند که منحنی مشخصه (CC)، تابع نمایش و منحنی پس‌استانداردسازی (PSC) را برای یک نمایشگر ۸ بیتی شرح می‌دهد. ۲۵۶ مقدار هر منحنی را می‌توان با یک برنامهٔ معمول صفحه گسترده مصورسازی کرد. علاوه‌بر این، منحنی نمایش (بدون CC و PSC) را می‌توان برای یک محدودهٔ مشخص درخشندگی/OD (حداقل/حداکثر) و تعداد معینی از سطوح محرک دیجیتال (DDL) نیز محاسبه کرد.

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

dcmfile-in  نام فایل DICOM ورودی جهت تخلیه

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

گزینه‌های ورودی (مانعةالجمع)

+Im  --monitor-file  [f]ilename: string
       فایل متنی توصیف‌کنندهٔ مشخصات مانیتور
+Ic  --camera-file  [f]ilename: string
       فایل متنی توصیف‌کنندهٔ مشخصات دوربین
+Ip  --printer-file  [f]ilename: string
       فایل متنی توصیف‌کنندهٔ مشخصات چاپگر
+Is  --scanner-file  [f]ilename: string
       فایل متنی توصیف‌کنندهٔ مشخصات اسکنر
+Il  --lum-range  [m]in max: float
       حداقل و حداکثر درخشندگی (cd/m^2)
+Io  --od-range  [m]in max: float
       حداقل و حداکثر چگالی نوری (OD)،
       تبدیل خودکار به درخشندگی

گزینه‌های ایجاد

+Ca  --ambient-light  [a]mbient light: float
       مقدار نور محیط (cd/m^2، پیش‌فرض: فایل f)
+Ci  --illumination  [i]llumination: float
       مقدار روشنایی (cd/m^2، پیش‌فرض: فایل f)
+Dn  --min-density  [m]inimum optical density: float
       مقدار Dmin (پیش‌فرض: غیرفعال، فقط با +Ip و +Io)
+Dx  --max-density  [m]aximum optical density: float
       مقدار Dmax (پیش‌فرض: غیرفعال، فقط با +Ip و +Io)
+Cd  --ddl-count  [n]umber of DDLs: integer
       تعداد سطوح محرک دیجیتال (DDL)
       (پیش‌فرض: 256، فقط با --lum/od-range)
+Cf  --curve-fitting  [n]umber: integer
       استفاده از الگوریتم برازش منحنی چندجمله‌ای با مرتبهٔ n
       (0..99، پیش‌فرض: تنظیم فایل یا cubic spline)

گزینه‌های خروجی

+Og  --gsdf  [f]ilename: string
       نوشتن داده‌های منحنی GSDF در فایل f
+Oc  --cielab  [f]ilename: string
       نوشتن داده‌های منحنی CIELAB در فایل f

نکات (NOTES)

فایل خروجی که CC، GSDF یا CIELAB و PSC را برای یک سامانهٔ نمایش ۸ بیتی (مانیتور، دوربین، چاپگر یا اسکنر) توصیف می‌کند، یک فایل متنی ساده است. خطوطی که با «#» شروع می‌شوند به‌عنوان توضیح در نظر گرفته شده و در نتیجه، به همراه خطوط خالی نادیده گرفته می‌شوند. یک فایل ورودی می‌تواند به‌عنوان نمونه توسط ابزار خط فرمانی dconvlum ایجاد شود.

مقدار نور محیطی که احتمالاً در فایل مشخصات تعریف شده است نیز برای محاسبات استفاده می‌شود. در این حالت این مقدار، و همچنین تعداد مقادیر DDL (سطح محرک دیجیتال)، محدودهٔ مطلق درخشندگی (اندازه‌گیری‌شده بر حسب کاندلا بر متر مربع) و در صورت استفاده از GSDF محدودهٔ شاخص JND (کمترین تفاوت محسوس)، بخشی از سرآیند توضیحات فایل خواهند بود. از سوی دیگر، مقدار نور محیط می‌تواند به‌صورت یک گزینهٔ خط فرمان مشخص شود. هنگام تنظیم دو مقدار درخشندگی به‌جای خواندن یک فایل مشخصات مانیتور به‌عنوان ورودی، محدودهٔ درخشندگی به‌صورت خطی بر تعداد DDLها تقسیم می‌شود.

برای چاپگرها و اسکنرها، علاوه بر نور محیطی بازتاب‌شده، روشنایی (illumination) را نیز می‌توان تعیین کرد (هم در فایل مشخصات و هم در خط فرمان). سرآیند فایل خروجی به‌جای محدودهٔ درخشندگی، شامل حداقل و حداکثر چگالی نوری (OD) است. لطفاً توجه داشته باشید که مقادیر OD در فایل ورودی باید به ترتیب نزولی مرتب شده باشند (برخلاف مقادیر درخشندگی که برای مانیتورها و دوربین‌ها استفاده می‌شوند). مقدار DDL برابر با 0 همواره به معنای سیاه (تاریک‌ترین مقدار) و حداکثر مقدار DDL به معنای سفید (روشن‌ترین مقدار، فیلم شفاف) است.

پوشهٔ data حاوی فایل‌های مشخصات نمونه برای مانیتورها، دوربین‌ها، چاپگرها و اسکنرها است. برای جزئیات بیشتر دربارهٔ کالیبراسیون صفحهٔ نمایش و مدل بارتن (از جمله GSDF)، به بخش ۱۴ استاندارد DICOM مراجعه کنید.

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

سطح خروجی گزارش‌گیری ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی را کاربر می‌تواند مشخص کند. به‌طور پیش‌فرض، فقط خطاها و هشدارها در جریان خطای استاندارد نوشته می‌شوند. با استفاده از گزینهٔ --verbose پیام‌های اطلاع‌رسانی مانند جزئیات پردازش نیز گزارش می‌شوند. گزینهٔ --debug می‌تواند برای دریافت جزئیات بیشتر دربارهٔ فعالیت داخلی، برای نمونه جهت اهداف اشکال‌زدایی استفاده شود. سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینهٔ --log-level انتخاب کرد. در حالت --quiet فقط خطاهای مهلک گزارش می‌شوند. در رخدادهای خطای بسیار شدید، برنامه معمولاً متوقف خواهد شد. برای جزئیات بیشتر دربارهٔ سطوح مختلف گزارش‌گیری، به مستندات ماژول «oflog» مراجعه کنید.

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

خط فرمان (COMMAND LINE)

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

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

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

فایل‌ها (FILES)

<datadir>/camera.lut - فایل مشخصات نمونه برای یک دوربین
<datadir>/monitor.lut - فایل مشخصات نمونه برای یک مانیتور
<datadir>/printer.lut - فایل مشخصات نمونه برای یک چاپگر
<datadir>/scanner.lut - فایل مشخصات نمونه برای یک اسکنر

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

dconvlum(1), dcod2lum(1)

کپی‌رایت و تکثیر (COPYRIGHT)