نام (NAME)

h2root - تبدیل فایل‌های PAW HBOOK به فایل‌های ROOT

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

h2root file.hbook file.root [compress] [tolower] [lrecl]

توضیحات (DESCRIPTION)

می‌توانید از h2root برای تبدیل فایل‌های بافت‌نگار (histogram) یا ntuple‌های HBOOK/PAW خود به فایل‌های ROOT استفاده کنید. برای استفاده از این برنامه، دستور زیر را در خط فرمان شل وارد کنید:

اگر پارامتر دوم را مشخص نکنید، یک نام فایل به‌طور خودکار برای شما تولید می‌شود. اگر hbookfile به‌صورت file.hbook باشد، فایل ROOT حاصل file.root نام‌گذاری خواهد شد.

این برنامه بافت‌نگارهای HBOOK را به اشیاء ROOT از کلاس TH1F تبدیل می‌کند. بافت‌نگارهای نمایه (profile) در HBOOK به بافت‌نگارهای نمایه در ROOT تبدیل می‌شوند (به کلاس TProfile مراجعه کنید). ntuple‌های ردیف‌محور و ستون‌محور در HBOOK به‌طور خودکار به درخت‌های (Trees) ROOT تبدیل می‌شوند (به TTree مراجعه کنید). برخی از ntuple‌های ستون‌محور HBOOK در حالتی که یکی از ستون‌ها آرایه‌ای با ابعاد ثابت (مثلاً ‘var[6]’) یا یک آرایهٔ چندبعدی باشد، ممکن است به‌طور کامل تبدیل نشوند.

شناسه‌های عدد صحیح در HBOOK با افزودن پیشوند ‘h’ (در صورتی که شناسه یک عدد صحیح مثبت باشد) و پیشوند ‘h_’ (در صورتی که یک عدد صحیح منفی باشد) به اشیاء نام‌دار در ROOT تبدیل می‌شوند.

در مورد ntuple‌های ردیف‌محور یا ستون‌محور، هر ستون به یک شاخه (branch) از یک Tree تبدیل می‌شود. توجه داشته باشید که h2root قادر است فایل‌های HBOOK حاوی چندین سطح از زیرپوشه‌ها را تبدیل کند. پس از تبدیل فایل، می‌توانید با استفاده از ماژول تعاملی ROOT آن را بررسی کرده و بافت‌نگارها را رسم کنید یا ntuple‌ها را پردازش نمایید. همچنین می‌توانید از مرورگر ROOT (به TBrowser مراجعه کنید) برای وارسی این فایل استفاده کنید.

فصل How to read a Tree دو روش را برای خواندن یک Tree توضیح می‌دهد. ابزار ROOT شامل تابع TTree::MakeCode است تا به‌طور خودکار کد اسکلت یک تابع تحلیلی را تولید کند. با

گزینه‌ها (OPTIONS)

compress

= ۱ به‌طور پیش‌فرض (برای عدم فشرده‌سازی از ۰ استفاده کنید)

tolower

= ۱ به‌طور پیش‌فرض (برای حفظ بزرگی و کوچکی حروف در نام ستون‌ها از ۰ استفاده کنید)

lrecl

= ۰ به‌طور پیش‌فرض (اگر بیشتر از ۸۰۹۲ باشد باید مشخص شود)

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

و

مستندات کامل h2root در نشانی زیر قرار دارد:

نویسندگان اصلی (ORIGINAL AUTHORS)

تیم ROOT (صفحه وب بالا را ببینید):

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

این کتابخانه یک نرم‌افزار آزاد است؛ شما می‌توانید تحت شرایط مجوز عمومی جامع‌تر کمتر گنو (GNU LGPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است؛ چه نسخه ۲٫۱ مجوز و چه (به انتخاب خودتان) هر نسخهٔ بعدی آن، این برنامه را بازتوزیع کرده یا تغییر دهید.

این کتابخانه با این امید که مفید باشد توزیع شده است، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی جامع‌تر کمتر گنو (GNU LGPL) مراجعه کنید.

شما باید به همراه این کتابخانه نسخه‌ای از مجوز عمومی جامع‌تر کمتر گنو را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر مکاتبه کنید: Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

نویسندگان (AUTHORS)

این صفحهٔ راهنما توسط Christian Holm Christensen <cholm@nbi.dk> برای سیستم گنو/لینوکس دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).