.TH hadd 1
.SH "نام (NAME)"
hadd \- ادغام اشیاء، هیستوگرام‌ها و درخت‌های فایل‌های ROOT
.SH "خلاصه دستور (SYNOPSIS)"
.B hadd
[\fB\-a\fR] [\fB\-f\fR] [\fB\-f\fR[\fI0\-9\fR]] [\fB\-fk\fR] [\fB\-ff\fR] [\fB\-k\fR] [\fB\-L\fR] [\fB\-Ltype\fR] [\fB\-O\fR] [\fB\-T\fR]
[\fB\-v\fR \fIV\fR] [\fB\-j\fR \fIJ\fR] [\fB\-dbg\fR] [\fB\-d\fR \fID\fR] [\fB\-n\fR \fIN\fR] [\fB\-cachesize\fR \fICACHESIZE\fR]
[\fB\-experimental\-io\-features\fR \fIEXPERIMENTAL_IO_FEATURES\fR]
\fITARGET\fR \fISOURCES\fR...
.SH "توضیحات (DESCRIPTION)"
این برنامه هیستوگرام‌ها، درخت‌ها (trees) و سایر اشیاء را از فهرستی از فایل‌های ROOT جمع‌آوری و ادغام کرده و در یک فایل ROOT هدف می‌نویسد. فایل هدف به صورت جدید ایجاد می‌شود و نباید از قبل وجود داشته باشد، یا اگر گزینهٔ
.B \-f
(«اجبار») مشخص شده باشد، نباید یکی از فایل‌های منبع باشد.
.SH "گزینه‌ها (OPTIONS)"
.IP \-a
افزودن به خروجی.
.IP \-f
اجبار به بازنویسی فایل خروجی.
.IP \-f[0-9]
امکان تعیین الگوریتم فشرده‌سازی
.I i
و سطح فشرده‌سازی
.I j
برای فایل هدف با ارسال عدد
.IR i *100\ +\ j
(مانند
.BR \-f505 ).
آخرین رقم
.RI ( j )
می‌تواند از 0 (بدون فشرده‌سازی) تا 9 (بسیار فشرده) تنظیم شود. اولین رقم
.RI ( i )
برای ZLIB برابر با 1، برای LZMA برابر با 2، برای LZ4 برابر با 4 و برای ZSTD برابر با 5 است. مقادیر پیشنهادی عبارتند از: 101 (ZLIB)، 207 (LZMA)، 404 (LZ4) و 505 (ZSTD). مقدار پیش‌فرض این گزینه 101
.RI ( kDefaultZLIB )
است. برای جزئیات بیشتر به مستندات
.B ROOT::RCompressionSetting
و
.B TFile::TFile
مراجعه کنید.
.IP \-fk
تنظیم فایل هدف برای نگهداری سبدها (baskets) با همان فشرده‌سازی فایل‌های ورودی (مگر اینکه
.B \-O
مشخص شده باشد). فراداده‌ها را با استفاده از سطح فشرده‌سازی مشخص‌شده در اولین فایل ورودی یا تنظیمات فشرده‌سازی پس از
.B fk
(برای مثال 206 در صورت استفاده از
.BR \-fk206 )
فشرده می‌کند.
.IP \-ff
استفاده از سطح فشرده‌سازی مشخص‌شده در اولین فایل ورودی.
.IP \-k
نادیده گرفتن فایل‌های خراب یا ناموجود، بدون خروج از برنامه.
.IP \-L
خواندن فهرست اشیاء از
.I FILE
و سپس ادغام انحصاری یا نادیده گرفتن آن اشیاء بسته به مقدار
.BR \-Ltype .
فایل
.I FILE
باید در هر خط شامل نام یک شیء باشد و نباید حاوی نویسه فاصله یا «/» باشد. همچنین می‌توانید نام‌های
.B TDirectory
را ارسال کنید که بر کل محتوای دایرکتوری اعمال می‌شوند. خطوطی که با «#» شروع می‌شوند نادیده گرفته می‌شوند. اگر این گزینه مشخص شود، گزینهٔ
.B \-Ltype
نیز باید الزاماً ارسال شود.
.IP \-Ltype
تعیین نوع عملیات انجام‌شده بر روی اشیاء فهرست‌شده در
.I FILE
که با گزینهٔ
.B \-L
ارائه شده است. مقدار «SkipListed» همه اشیاء فهرست‌شده را نادیده می‌گیرد؛ مقدار «OnlyListed» فقط آن اشیاء را ادغام می‌کند. در صورت استفاده از این گزینه، گزینهٔ
.B \-L
نیز باید الزاماً مشخص شود.
.IP \-O
بهینه‌سازی مجدد اندازه سبدها (basket size) هنگام ادغام
.BR TTree .
.IP \-T
عدم ادغام درخت‌ها
.RI ( Trees ).
.IP \-v
تعیین صریح سطح پرگویی (verbosity): مقدار 0 بدون خروجی است و 99 مقدار پیش‌فرض است.
.IP \-j
موازی‌سازی اجرا در
.I J
فرایند. اگر تعداد فرایندها مشخص نشود، از حداکثر توان سیستم استفاده می‌شود.
.IP \-dbg
فعال‌سازی حالت پرگویی و اشکال‌زدایی. اگر گزینهٔ
.B \-j
مشخص شده باشد، فایل‌های جزئی ذخیره‌شده در دایرکتوری کاری حذف نخواهند شد.
.IP \-d
انجام اجرای چندفرایندی جزئی در دایرکتوری مشخص‌شده.
.IP \-n
باز کردن حداکثر
.I N
فایل به‌طور همزمان (برای درخواست استفاده از حداکثر توان سیستم از 0 استفاده کنید).
.IP \-cachesize
تغییر اندازه حافظهٔ نهان پیش‌واکشی (prefetching cache) به کار رفته برای افزایش سرعت عملیات ورودی/خروجی (برای غیرفعال کردن از 0 استفاده کنید).
.IP \-experimental-io-features
در صورت ارائه همراه با یک آرگومان، ویژگی آزمایشی متناظر را برای درخت‌های خروجی فعال می‌کند. به
.B ROOT::Experimental::EIOFeatures
مراجعه کنید.
.IP TARGET
فایل هدف (مقصد).
.IP SOURCES
فایل‌های منبع.