نام (NAME)

dcmqridx - ثبت فایل تصویر DICOM در فایل نمایه پایگاه داده تصاویر

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

dcmqridx [options] index-out [dcmfile-in...]

توضیحات (DESCRIPTION)

ابزار dcmqridx فایل‌های تصویر DICOM را در فایل نمایه پایگاه داده که توسط برنامه‌های dcmqrscp و dcmqrti استفاده می‌شود، ثبت می‌کند. هیچ فایل تصویری کپی نمی‌شود. همچنین dcmqridx می‌تواند محتویات فایل نمایه پایگاه داده را فهرست کند.

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

index-out   ناحیه ذخیره‌سازی برای فایل نمایه (دایرکتوری)
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 برای ثبت‌کننده وقایع
-p   --print
       فهرست کردن محتویات فایل نمایه پایگاه داده
-n   --not-new
       تنظیم وضعیت بازبینی‌شده نمونه به 'not new'

نکات (NOTES)

dcmqridx تلاش می‌کند برای هر فایل تصویری ارائه‌شده در خط فرمان، یک ارجاع به فایل نمایه پایگاه داده اضافه کند.

dcmqridx سامانه سهمیه‌بندی بخش پسین (back-end) پایگاه داده را غیرفعال می‌کند تا هیچ فایل تصویری حذف نشود.

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

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

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

خط فرمان (COMMAND LINE)

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

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

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

محیط (ENVIRONMENT)

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

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

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

dcmqrscp(1), dcmqrti(1)

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