.\" Text automatically generated by txt2man
.TH fio2gnuplot 1 "August 2013"
.SH "نام (NAME)"
fio2gnuplot \- رسم و نمایش پرونده‌های خروجی fio با ابزار gnuplot
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.fam C
\fBfio2gnuplot\fP [\fB-ghbiodvk\fP] [\fB-t\fP \fItitle\fP] [\fB-o\fP \fIoutputfile\fP]
               [\fB-d\fP \fIoutput_dir\fP] [\fB-p\fP \fIpattern\fP]
               [\fB-G\fP \fItype\fP] [\fB-m\fP \fImin_time\fP] [\fB-M\fP \fImax_time\fP]

.fam T
.fi
.fam T
.fi
.SH "توضیحات (DESCRIPTION)"
دستور
\fBfio2gnuplot\fP
مجموعه‌ای از فایل‌های گزارش (لاگ) برنامه fio را تحلیل کرده و آنها را با ابزار gnuplot به مجموعه‌ای از نمودارهای گرافیکی تبدیل می‌کند.
انواع مختلفی از رسم نمودار تولید می‌شوند:
.TP
.B
نمودار دوبعدی انفرادی (Individual 2D Graph)
هر فایل در یک فایل تصویری جداگانه با چندین گزینه رسم می‌شود:
.RS
.IP \(bu 3
raw (خام): رسم کارایی دقیق گزارش‌شده. خواندن این نمودار ممکن است دشوار باشد.
.IP \(bu 3
smooth (هموار): نسخه‌ای هموارتر از خروجی خام. با استفاده از گزینه csplines ابزار gnuplot، رندرینگ فیلتر می‌شود تا نموداری با خوانایی بهتر حاصل شود.
.IP \(bu 3
trend (روند): نسخه‌ای حتی هموارتر از چاپ خام جهت مشاهده روندها. منحنی‌های بزیر (Bezier) نمودارهای بسیار فیلترشده‌تری ایجاد می‌کنند. نمودار حاصل به درک روندها کمک می‌کند.
.RE
.TP
.B
نمودار دوبعدی گروهی (Grouped 2D graph)
همه فایل‌ها در یک تصویر واحد برای مقایسه آسان‌تر رسم می‌شوند. گزینه‌های رندرینگ مشابه با نمودار دوبعدی انفرادی به کار می‌روند:
.RS
.IP \(bu 3
raw (خام)
.IP \(bu 3
smooth (هموار)
.IP \(bu 3
trend (روند)
.RE
.TP
.B
نمودار سه‌بعدی گروهی (Grouped 3D graph)
همه فایل‌ها در یک نمودار سه‌بعدی واحد رسم می‌شوند.
رسم سه‌بعدی یک 'سطح' ایجاد می‌کند تا برآورد کند که کارایی‌ها تا چه اندازه به یکدیگر نزدیک بوده‌اند.
یک سطح صاف نشان‌دهنده یکپارچگی و همخوانی خوب بین داده‌ها است.
یک سطح ناهموار نشان‌دهنده عدم همخوانی و پراکندگی بین داده‌ها است.
.TP
.B
رسم ریاضی (Mathematical Plotting)
.RS
.TP
.B
نمودار میانگین (Average graph)
یک نمودار میله‌ای برای نمایش میانگین کارایی هر فایل.
یک خط سبز برای نمایش میانگین سراسری کارایی اضافه شده است.
این خط سبز کمک می‌کند تا فاصله هر فایل جداگانه از میانگین سنجیده شود.
.TP
.B
نمودار حداقل (Min graph)
یک خط سبز برای نمایش میانگین سراسری حداقل کارایی اضافه شده است.
این خط سبز به درک فاصله هر فایل جداگانه از میانگین کمک می‌کند.
.TP
.B
نمودار حداکثر (Max graph)
یک نمودار میله‌ای برای نمایش حداکثر کارایی هر فایل.
یک خط سبز برای نمایش میانگین سراسری حداکثر کارایی اضافه شده است.
این خط سبز به درک فاصله هر فایل جداگانه از میانگین کمک می‌کند.
.TP
.B
انحراف معیار (Standard Deviation)
یک نمودار میله‌ای برای نمایش انحراف معیار هر فایل.
یک خط سبز برای نمایش میانگین سراسری انحراف معیار اضافه شده است.
این خط سبز کمک می‌کند تا فاصله هر فایل جداگانه از میانگین انحراف معیار مشخص شود.
.RE
.SH "گزینه‌ها (OPTIONS)"
.TP
.B
\fB-h\fP یا \fB--help\fP
گزینه \fB-h\fP راهنما را نمایش می‌دهد.
.TP
.B
\fB-p\fP '\fIpattern\fP' یا --\fIpattern\fP '\fIpattern\fP'
یک \fIpattern\fP به صورت عبارات باقاعده (regex) برای انتخاب فایل‌های ورودی fio.
برای جلوگیری از تداخل شل، کوتیشن‌های تکی (') را فراموش نکنید.
.TP
.B
\fB-b\fP یا \fB--bandwidth\fP
یک \fIpattern\fP از پیش تعریف‌شده برای انتخاب فایل‌های *_bw.log.
.TP
.B
\fB-i\fP یا \fB--iops\fP
یک \fIpattern\fP از پیش تعریف‌شده برای انتخاب فایل‌های *_iops.log.
.TP
.B
\fB-g\fP یا \fB--gnuplot\fP
رندر کردن نمودارهای gnuplot قبل از خروج.
.TP
.B
\fB-o\fP file یا --\fIoutputfile\fP file
نام پایه (basename) برای نمودارهای gnuplot (در صورت تعریف الگو، با \fIpattern\fP تنظیم می‌شود).
.TP
.B
\fB-d\fP dir یا \fB--outputdir\fP dir
دایرکتوری‌ای که gnuplot فایل‌ها را در آن رندر می‌کند.
.TP
.B
\fB-t\fP \fItitle\fP یا --\fItitle\fP \fItitle\fP
عنوان (\fItitle\fP) نمودارهای gnuplot.
عنوان با اندازه بلوک شناسایی‌شده در لاگ fio تنظیم می‌شود.
.TP
.B
\fB-G\fP \fItype\fP یا \fB--Global\fP \fItype\fP
جستجو برای '\fItype\fP' در فایل‌های .global منطبق با \fIpattern\fP.
انواع مجاز عبارتند از: min، max، avg، stddev.
پسوند .global به طور خودکار به \fIpattern\fP اضافه می‌شود.
.TP
.B
\fB-m\fP time یا --\fImin_time\fP time
تنها در نظر گرفتن داده‌ها از زمان 'time' ثانیه به بعد. مقدار پیش‌فرض 0 است.
.TP
.B
\fB-M\fP time یا --\fImax_time\fP time
تنها در نظر گرفتن داده‌های پایان‌یافته قبل از زمان 'time' ثانیه. مقدار پیش‌فرض \fB-1\fP (بدون محدودیت) است.
.TP
.B
\fB-v\fP یا \fB--verbose\fP
افزایش پرگویی خروجی (جزئیات بیشتر).
.TP
.B
\fB-k\fP یا \fB--keep\fP
نگه‌داشتن تمامی فایل‌های موقت در دایرکتوری خروجی gnuplot.
.SH "مثال‌ها (EXAMPLES)"
.TP
برای رسم تمام نمودارهای با نامی مشابه 'host*_read_4k_iops.log':
.nf
$ \fBfio2gnuplot\fP \fB-p\fP 'host*_read_4k_iops.log' \fB-g\fP
.fi
.TP
برای رسم تمامی فایل‌های لاگ مرتبط با IO از دایرکتوری جاری:
.nf
$ \fBfio2gnuplot\fP \fB-g\fP \fB-i\fP
.fi
.TP
برای رسم تمامی فایل‌های لاگ مرتبط با پهنای باند از دایرکتوری جاری:
.nf
$ \fBfio2gnuplot\fP \fB-g\fP \fB-b\fP
.fi
.TP
برای رسم تمامی فایل‌های لاگ مرتبط با پهنای باند در پوشه‌ای با نام 'outdir':
.nf
$ \fBfio2gnuplot\fP \fB-g\fP \fB-b\fP \fB-d\fP outdir
.fi
.SH "نویسنده (AUTHOR)"
Erwan Velu <erwan@enovance.com>