.\" dummy line
.TH GNUPLOT 1 "February 2020"
.UC 4
.SH "نام (NAME)"
gnuplot \- یک برنامه رسم نمودار تعاملی
.SH "خلاصه دستور (SYNOPSIS)"
.B gnuplot
[X11 options] [options] [file ...]
.br
.SH "توضیحات (DESCRIPTION)"
.B Gnuplot
یک برنامه رسم نمودار تعاملی و مبتنی بر خط فرمان است.
.PP
اگر نام‌های فایل در خط فرمان مشخص شوند،
gnuplot هر فایل را به ترتیب تعیین‌شده بارگذاری و اجرا می‌کند،
و پس از پردازش آخرین فایل خارج می‌شود.
اگر هیچ فایلی مشخص نشود، \fBgnuplot\fP اعلان دریافت دستورات تعاملی را نمایش می‌دهد.
.PP
برخی از ویژگی‌های آن عبارتند از:
.PP
رسم هر تعداد تابع، متشکل از عملگرهای C، توابع کتابخانه ریاضی C
و برخی مواردی که C فاقد آن‌هاست، مانند **، ()sgn و غیره.
.PP
ثوابت و توابع تعریف‌شده توسط کاربر.
.PP
انجام تمامی محاسبات در دامنه اعداد مختلط. به‌طور پیش‌فرض تنها
بخش حقیقی رسم می‌شود، اما توابعی مانند ()imag و ()abs و ()arg
برای تغییر این رفتار در دسترس هستند.
.PP
سبک‌های نمایش گوناگون برای رسم داده‌های کاربر از فایل‌ها، شامل
برازش سطح، میله‌های خطا، نمودارهای جعبه‌ای، بافت‌نگارها، نقشه‌های حرارتی و دستکاری
ساده داده‌های تصویر. مجموعه‌ای از نمونه‌های برخط در نشانی زیر موجود است:
.br
.I http://www.gnuplot.info/demo
.PP
برازش حداقل مربعات غیرخطی.
.PP
نمودارهای دوبعدی و سه‌بعدی با قابلیت بزرگ‌نمایی، چرخش و فرامتنِ قابل کنترل با ماوس.
.PP
گریز به پوسته و جایگزینی خط فرمان.
.PP
قابلیت بارگذاری و ذخیره‌سازی.
.PP
پشتیبانی از تنوع بسیار گسترده‌ای از دستگاه‌های خروجی و قالب‌های فایل.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-p, \-\-persist\fP اجازه می‌دهد پنجره‌های نمودار پس از خروج برنامه اصلی gnuplot باز بمانند.
.PP
\fB\-c scriptname ARG1 ARG2 ...\fP، بارگذاری اسکریپت با استفاده از سازوکار «call» در gnuplot و ارسال باقی‌مانده خط فرمان به آن به عنوان آرگومان.
.PP
\fB\-d, \-\-default-settings\fP در هنگام ورود، تنظیمات از gnuplotrc، ~/.gnuplot و $XDG_CONFIG_HOME/gnuplot/gnuplotrc خوانده نشود.
.PP
\fB\-e "command list"\fP دستورات درخواست‌شده را پیش از بارگذاری فایل ورودی بعدی اجرا می‌کند.
.PP
\fB\-s, \-\-slow\fP منتظر مقداردهی اولیه آهسته قلم‌ها بماند به جای آنکه با خطا ادامه دهد.
.PP
\fB\-h, \-\-help\fP چاپ خلاصه کاربرد
.PP
\fB\-V, \-\-version\fP نمایش نسخه فعلی
.SH "گزینه‌های X11 (X11 OPTIONS)"
برای نوع پایانه x11، برنامه \fIgnuplot\fP
گزینه‌ها و منابع استاندارد X Toolkit مانند geometry، font و background را می‌پذیرد.
برای شرح گزینه‌های متداول، صفحه راهنمای X(1) را ببینید.
برای گزینه‌های اضافی X مخصوص gnuplot، عبارت \fIhelp x11\fP را در خط فرمان
gnuplot وارد کنید. این گزینه‌ها روی سایر انواع پایانه تأثیری ندارند.
.SH "محیط (ENVIRONMENT)"
تعدادی از متغیرهای محیطی پوسته توسط
gnuplot شناسایی می‌شوند. هیچ‌یک از این موارد الزامی نیستند.
.TP
.B GNUTERM
نام نوع پایانه‌ای که به‌طور پیش‌فرض استفاده می‌شود. این مقدار می‌تواند
توسط فایل‌های راه‌اندازی gnuplotrc، .gnuplot یا $XDG_CONFIG_HOME/gnuplot/gnuplotrc
و البته بعداً با دستورات صریح «set terminal» لغو شود.
.TP
.B GNUHELP 
مسیر فایل راهنما (gnuplot.gih).
.TP
.B HOME
نام پوشه‌ای که برای یافتن فایل .gnuplot در آن جستجو می‌شود.
.TP
.B PAGER
یک پالایه خروجی برای پیام‌های راهنما.
.TP
.B SHELL
برنامه‌ای که برای دستور «shell» استفاده می‌شود.
.TP
.B FIT_SCRIPT
یک دستور gnuplot را مشخص می‌کند که هنگام وقفه در
برازش (fit) اجرا شود \(hy به «help fit» مراجعه کنید.
.TP
.B FIT_LOG
نام فایل گزارش نگهداری‌شده توسط fit.
.TP
.B GNUPLOT_LIB
پوشه‌های جستجوی اضافی برای فایل‌های داده و فرمان. این متغیر
می‌تواند شامل نام یک پوشه واحد، یا فهرستی از پوشه‌ها باشد که با
':' از هم جدا شده‌اند. محتویات GNUPLOT_LIB به متغیر «loadpath»
افزوده می‌شود، اما با دستورهای «save» و «save set» ذخیره نمی‌شود.
.TP
.B GDFONTPATH
چندین گرداننده پایانه gnuplot از طریق کتابخانه gd به قلم‌های TrueType دسترسی دارند.
این متغیر مسیر جستجوی قلم را برای این گرداننده‌ها مشخص می‌کند.
.TP
.B GNUPLOT_DEFAULT_GDFONT
قلم پیش‌فرض برای گرداننده‌های پایانه‌ای که از طریق کتابخانه gd
به قلم‌های TrueType دسترسی دارند.
.TP
.B GNUPLOT_FONTPATH
مسیر جستجوی قلم مورد استفاده پایانه postscript. قالب آن
مشابه GNUPLOT_LIB است. محتویات GNUPLOT_FONTPATH به متغیر
«fontpath» اضافه می‌شود، اما با دستورات «save» و «save set»
ذخیره نمی‌شود.
.TP
.B GNUPLOT_PS_DIR
توسط درایور postscript برای یافتن فایل‌های پیش‌درآمد (prologue)
خارجی استفاده می‌شود. بسته به فرایند ساخت، gnuplot شامل یک نسخه توکار
از آن فایل‌هاست یا صرفاً یک مسیر پیش‌فرضِ ثابت (hardcoded) دارد. از
این متغیر برای آزمایش پایانه postscript با فایل‌های پیش‌درآمد سفارشی استفاده کنید.
راهنمای «help postscript prologue» را ببینید.
.SH "فایل‌ها (FILES)"
.TP
.I gnuplotrc
هنگام اجرای gnuplot، این برنامه ابتدا به دنبال یک فایل راه‌اندازی در سطح سیستم
به نام gnuplotrc می‌گردد. مکان پیش‌فرضی که برنامه برای این فایل در نظر دارد
توسط دستور «show loadpath» گزارش می‌شود.
.TP
.I .gnuplot
پس از بارگذاری فایل راه‌اندازی در سطح سیستم (در صورت وجود)،
Gnuplot به دنبال یک فایل راه‌اندازی شخصی در دایرکتوری HOME می‌گردد.
این فایل می‌تواند حاوی هر دستور مجاز gnuplot باشد، اما معمولاً به
تنظیم پایانه و انواع خطوط ترجیحی و تعریف توابع یا متغیرهای پرکاربرد
محدود می‌شود.
.TP
.I $XDG_CONFIG_HOME/gnuplot/gnuplotrc
پس از بارگذاری سایر فایل‌های راه‌اندازی، Gnuplot بررسی می‌کند که آیا فایلی
به نام gnuplotrc در زیرشاخه gnuplot درون $XDG_CONFIG_HOME (پیش‌فرض
~/.config) وجود دارد یا خیر. محدودیت‌های مشابه .gnuplot در اینجا نیز اعمال می‌شوند.
.TP 
.I fit.log
نام پیش‌فرض فایل گزارش خروجی توسط دستور «fit».
.SH "نویسندگان (AUTHORS)"
نویسندگان اصلی: Thomas Williams و Colin Kelley.
از نسخه ۳٫۸ gnuplot به بعد، کد منبع پروژه به‌صورت مشارکتی
توسط تعداد زیادی از مشارکت‌کنندگان در SourceForge نگهداری می‌شود.
.SH "گزارش باگ‌ها (BUGS)"
لطفاً باگ‌ها را از طریق سامانه ردیابی اشکالات پروژه در SourceForge گزارش دهید.
.SH "همچنین ببینید (SEE ALSO)"
برای جزئیات درباره دستورات خاص، به راهنمای چاپی یا راهنمای برخط مراجعه کنید.
وب‌گاه پروژه در http://www.gnuplot.info