hadd(1) General Commands Manual hadd(1)

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

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...

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

افزودن به خروجی.
اجبار به بازنویسی فایل خروجی.
امکان تعیین الگوریتم فشرده‌سازی 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 مراجعه کنید.
تنظیم فایل هدف برای نگهداری سبدها (baskets) با همان فشرده‌سازی فایل‌های ورودی (مگر اینکه -O مشخص شده باشد). فراداده‌ها را با استفاده از سطح فشرده‌سازی مشخص‌شده در اولین فایل ورودی یا تنظیمات فشرده‌سازی پس از fk (برای مثال 206 در صورت استفاده از -fk206) فشرده می‌کند.
استفاده از سطح فشرده‌سازی مشخص‌شده در اولین فایل ورودی.
نادیده گرفتن فایل‌های خراب یا ناموجود، بدون خروج از برنامه.
خواندن فهرست اشیاء از FILE و سپس ادغام انحصاری یا نادیده گرفتن آن اشیاء بسته به مقدار -Ltype. فایل FILE باید در هر خط شامل نام یک شیء باشد و نباید حاوی نویسه فاصله یا «/» باشد. همچنین می‌توانید نام‌های TDirectory را ارسال کنید که بر کل محتوای دایرکتوری اعمال می‌شوند. خطوطی که با «#» شروع می‌شوند نادیده گرفته می‌شوند. اگر این گزینه مشخص شود، گزینهٔ -Ltype نیز باید الزاماً ارسال شود.
تعیین نوع عملیات انجام‌شده بر روی اشیاء فهرست‌شده در FILE که با گزینهٔ -L ارائه شده است. مقدار «SkipListed» همه اشیاء فهرست‌شده را نادیده می‌گیرد؛ مقدار «OnlyListed» فقط آن اشیاء را ادغام می‌کند. در صورت استفاده از این گزینه، گزینهٔ -L نیز باید الزاماً مشخص شود.
بهینه‌سازی مجدد اندازه سبدها (basket size) هنگام ادغام TTree.
عدم ادغام درخت‌ها (Trees).
تعیین صریح سطح پرگویی (verbosity): مقدار 0 بدون خروجی است و 99 مقدار پیش‌فرض است.
موازی‌سازی اجرا در J فرایند. اگر تعداد فرایندها مشخص نشود، از حداکثر توان سیستم استفاده می‌شود.
فعال‌سازی حالت پرگویی و اشکال‌زدایی. اگر گزینهٔ -j مشخص شده باشد، فایل‌های جزئی ذخیره‌شده در دایرکتوری کاری حذف نخواهند شد.
انجام اجرای چندفرایندی جزئی در دایرکتوری مشخص‌شده.
باز کردن حداکثر N فایل به‌طور همزمان (برای درخواست استفاده از حداکثر توان سیستم از 0 استفاده کنید).
تغییر اندازه حافظهٔ نهان پیش‌واکشی (prefetching cache) به کار رفته برای افزایش سرعت عملیات ورودی/خروجی (برای غیرفعال کردن از 0 استفاده کنید).
در صورت ارائه همراه با یک آرگومان، ویژگی آزمایشی متناظر را برای درخت‌های خروجی فعال می‌کند. به ROOT::Experimental::EIOFeatures مراجعه کنید.
فایل هدف (مقصد).
فایل‌های منبع.