hadd(1)                     General Commands Manual                    hadd(1)

نام (NAME)
       hadd - ادغام اشیاء، هیستوگرام‌ها و درخت‌های فایل‌های ROOT

خلاصه دستور (SYNOPSIS)
       hadd [-a] [-f] [-f[0-9]] [-fk] [-ff] [-k] [-L] [-Ltype] [-O] [-T] [-v
       V] [-j J] [-dbg] [-d D] [-n N] [-cachesize CACHESIZE]
       [-experimental-io-features EXPERIMENTAL_IO_FEATURES] TARGET SOURCES...

توضیحات (DESCRIPTION)
       این برنامه هیستوگرام‌ها، درخت‌ها (trees) و سایر اشیاء را از فهرستی از
       فایل‌های ROOT جمع‌آوری و ادغام کرده و در یک فایل ROOT هدف می‌نویسد. فایل
       هدف به صورت جدید ایجاد می‌شود و نباید از قبل وجود داشته باشد، یا اگر
       گزینهٔ -f («اجبار») مشخص شده باشد، نباید یکی از فایل‌های منبع باشد.

گزینه‌ها (OPTIONS)
       -a     افزودن به خروجی.

       -f     اجبار به بازنویسی فایل خروجی.

       -f[0-9]
              امکان تعیین الگوریتم فشرده‌سازی i و سطح فشرده‌سازی j برای فایل هدف
              با ارسال عدد i*100 + j (مانند -f505).  آخرین رقم (j) می‌تواند از
              0 (بدون فشرده‌سازی) تا 9 (بسیار فشرده) تنظیم شود. اولین رقم (i)
              برای ZLIB برابر با 1، برای LZMA برابر با 2، برای LZ4 برابر با 4
              و برای ZSTD برابر با 5 است. مقادیر پیشنهادی عبارتند از: 101
              (ZLIB)، 207 (LZMA)، 404 (LZ4) و 505 (ZSTD). مقدار پیش‌فرض این
              گزینه 101 (kDefaultZLIB) است. برای جزئیات بیشتر به مستندات
              ROOT::RCompressionSetting و TFile::TFile مراجعه کنید.

       -fk    تنظیم فایل هدف برای نگهداری سبدها (baskets) با همان فشرده‌سازی
              فایل‌های ورودی (مگر اینکه -O مشخص شده باشد). فراداده‌ها را با
              استفاده از سطح فشرده‌سازی مشخص‌شده در اولین فایل ورودی یا تنظیمات
              فشرده‌سازی پس از fk (برای مثال 206 در صورت استفاده از -fk206)
              فشرده می‌کند.

       -ff    استفاده از سطح فشرده‌سازی مشخص‌شده در اولین فایل ورودی.

       -k     نادیده گرفتن فایل‌های خراب یا ناموجود، بدون خروج از برنامه.

       -L     خواندن فهرست اشیاء از FILE و سپس ادغام انحصاری یا نادیده گرفتن
              آن اشیاء بسته به مقدار -Ltype.  فایل FILE باید در هر خط شامل نام
              یک شیء باشد و نباید حاوی نویسه فاصله یا «/» باشد. همچنین
              می‌توانید نام‌های TDirectory را ارسال کنید که بر کل محتوای
              دایرکتوری اعمال می‌شوند. خطوطی که با «#» شروع می‌شوند نادیده گرفته
              می‌شوند. اگر این گزینه مشخص شود، گزینهٔ -Ltype نیز باید الزاماً
              ارسال شود.

       -Ltype تعیین نوع عملیات انجام‌شده بر روی اشیاء فهرست‌شده در FILE که با
              گزینهٔ -L ارائه شده است. مقدار «SkipListed» همه اشیاء فهرست‌شده را
              نادیده می‌گیرد؛ مقدار «OnlyListed» فقط آن اشیاء را ادغام می‌کند.
              در صورت استفاده از این گزینه، گزینهٔ -L نیز باید الزاماً مشخص شود.

       -O     بهینه‌سازی مجدد اندازه سبدها (basket size) هنگام ادغام TTree.

       -T     عدم ادغام درخت‌ها (Trees).

       -v     تعیین صریح سطح پرگویی (verbosity): مقدار 0 بدون خروجی است و 99
              مقدار پیش‌فرض است.

       -j     موازی‌سازی اجرا در J فرایند. اگر تعداد فرایندها مشخص نشود، از
              حداکثر توان سیستم استفاده می‌شود.

       -dbg   فعال‌سازی حالت پرگویی و اشکال‌زدایی. اگر گزینهٔ -j مشخص شده باشد،
              فایل‌های جزئی ذخیره‌شده در دایرکتوری کاری حذف نخواهند شد.

       -d     انجام اجرای چندفرایندی جزئی در دایرکتوری مشخص‌شده.

       -n     باز کردن حداکثر N فایل به‌طور همزمان (برای درخواست استفاده از
              حداکثر توان سیستم از 0 استفاده کنید).

       -cachesize
              تغییر اندازه حافظهٔ نهان پیش‌واکشی (prefetching cache) به کار رفته
              برای افزایش سرعت عملیات ورودی/خروجی (برای غیرفعال کردن از 0
              استفاده کنید).

       -experimental-io-features
              در صورت ارائه همراه با یک آرگومان، ویژگی آزمایشی متناظر را برای
              درخت‌های خروجی فعال می‌کند. به ROOT::Experimental::EIOFeatures
              مراجعه کنید.

       TARGET فایل هدف (مقصد).

       SOURCES
              فایل‌های منبع.

                                                                       hadd(1)