'\" t
.\"     Title: gpsplot
.\"    Author: Gary E. Miller
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD 3.27.5
.\"  Language: Persian
.\"
.TH "GPSPLOT" "1" "2025-11-04" "GPSD 3.27.5" "مستندات GPSD"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
gpsplot \- ابزاری برای استخراج و رسم پویای داده‌ها از gpsd
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgpsplot\fP [OPTIONS] [server[:port[:device]]]
.sp
\fBgpsplot\fP \-h
.sp
\fBgpsplot\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
\fBgpsplot\fP ابزاری برای اتصال به \fBgpsd\fP و رسم پویای داده‌ها بر روی صفحه نمایش کاربر است. انواع نمودارها شامل نمودارهای پراکندگی (scatterplots) و نمودارهای نواری پیوسته (stripcharts) هستند.
.sp
رسم نمودار نیازمند نصب ماژول Matplotlib در پایتون و وابستگی‌های متعدد آن روی میزبان نمایشگر است. اگر میزبان نمایشگر، همان میزبان \fBgpsd\fP نباشد، در این صورت نیازی به نصب بودن Matplotlib روی میزبان \fBgpsd\fP نیست.
.sp
\fBgpsplot\fP به دسترسی‌های ریشه (root) نیازی ندارد، اما می‌تواند با دسترسی root اجرا شود. اجرای آن با sudo باعث از دست رفتن برخی عملکردهای آن خواهد شد. این ابزار را می‌توان به‌طور همزمان با ابزارهای دیگری که به \fBgpsd\fP محلی متصل هستند بدون ایجاد مشکل اجرا کرد.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
چاپ پیام راهنمای نحوه استفاده و خروج.
.RE
.sp
\fB\-b BACKEND\fP, \fB\-\-backend BACKEND\fP
.RS 4
تنظیم بک‌اند تعاملی Matplotlib به BACKEND.
.RE
.sp
\fB\-B\fP, \fB\-\-backends\fP
.RS 4
چاپ بک‌اندهای تعاملی در دسترس Matplotlib و سپس خروج. بک‌اندهای Matplotlib از نظر سرعت اجرا و ظاهر بصری بسیار متفاوت هستند. برای مشاهده تفاوت‌ها همه آنها را امتحان کنید.
.RE
.sp
\fB\-d LVL\fP, \fB\-\-debug LVL\fP
.RS 4
تنظیم سطح اشکال‌زدایی (debug) به LVL.
.RE
.sp
\fB\-\-device DEVICE\fP
.RS 4
دستگاه (DEVICE) روی \fBgpsd\fP برای اتصال. پیش‌فرض همه دستگاه‌ها است.
.RE
.sp
\fB\-\-exit\fP
.RS 4
خروج پس از اتمام اجرای \-\-count، \-\-file یا \-\-seconds.
.RE
.sp
\fB\-\-fields FIELDS\fP
.RS 4
کد فیلدهای مورد نظر برای رسم نمودار. مقدار FIELDS یکی از این موارد است: llh (عرض‌جغرافیایی/طول‌جغرافیایی/ارتفاع از بیضوی مبنا altHAE) یا llm (عرض‌جغرافیایی/طول‌جغرافیایی/ارتفاع از سطح متوسط دریا altMSL).
.RE
.sp
\fB\-\-file FILE\fP
.RS 4
خواندن داده‌های JSON از FILE به جای \fBgpsd\fP.
.RE
.sp
\fB\-\-host HOST\fP
.RS 4
اتصال به \fBgpsd\fP روی HOST (سرور). پیش‌فرض localhost است.
.RE
.sp
\fB\-\-image IMAGE.EXT\fP
.RS 4
ذخیره نمودار به صورت IMAGE.EXT. پسوند EXT نوع تصویر (.jpg، .png و غیره) را تعیین می‌کند. پسوندهای پشتیبانی‌شده به نصب سیستم بستگی دارند.
.RE
.sp
\fB\-n COUNT\fP, \fB\-\-count COUNT\fP
.RS 4
توقف پس از COUNT پیام نمودار. مقدار 0 برای غیرفعال کردن. پیش‌فرض 0.
.RE
.sp
\fB\-\-plottype PLOTTYPE\fP
.RS 4
نوع نمودار مورد نظر برای رسم. مقدار PLOTTYPE یکی از \*(Aqscatterplot\*(Aq یا \*(Aqstripchart\*(Aq است.
.RE
.sp
\fB\-p PORT\fP, \fB\-\-port PORT\fP
.RS 4
استفاده از PORT برای اتصال به \fBgpsd\fP. پیش‌فرض 2947 است.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ نسخه برنامه و خروج.
.RE
.sp
\fB\-x SECONDS\fP, \fB\-\-seconds SECONDS\fP
.RS 4
توقف پس از SECONDS ثانیه. مقدار 0 برای غیرفعال کردن. پیش‌فرض 0.
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی \fBgpsd\fP که روی localhost در حال اجراست و با استفاده از پورت پیش‌فرض GPSD یعنی 2947 جمع‌آوری می‌کنند. آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را لغو کند: \fB[server[:port[:device]]]\fP
.sp
برای توضیحات بیشتر و مثال‌ها، بخش \fBARGUMENTS\fP را در صفحه راهنمای \fBgps\fP(1) ببینید.
.SH "محیط (ENVIRONMENT)"
.sp
می‌توانید متغیر محیطی \fBMPLBACKEND\fP را روی بک‌اند دلخواه Matplotlib تنظیم کنید. این کار شما را از استفاده مکرر از \fB\-b BACKEND\fP در هر بار اجرای \fBgpsplot\fP بی‌نیاز می‌کند.
.SH "مثال‌ها (EXAMPLES)"
.sp
تولید یک نمودار پراکندگی از عرض جغرافیایی، طول جغرافیایی و ارتفاع از سطح متوسط دریا (altMSL). توقف پس از ۶۰ ثانیه:
.sp
.if n .RS 4
.nf
.fam C
gpsplot \-\-seconds 60 \-\-fields llm
.fam
.fi
.if n .RE
.sp
تولید یک نمودار پراکندگی از عرض جغرافیایی، طول جغرافیایی و ارتفاع از بیضوی مبنا (altHAE). توقف پس از ۶۰ فیکس موقعیت:
.sp
.if n .RS 4
.nf
.fam C
gpsplot \-\-count 60 \-\-plottype stripchart
.fam
.fi
.if n .RE
.sp
استفاده از بک‌اند \fBWXAgg\fP برای تکرار آزمایش قبلی به منظور بررسی سرعت یا ظاهر بهتر:
.sp
.if n .RS 4
.nf
.fam C
export MPLBACKEND=WX
gpsplot \-\-count 60 \-\-plottype stripchart
.fam
.fi
.if n .RE
.sp
تولید محلی نمودار پراکندگی عرض جغرافیایی، طول جغرافیایی و altMSL از یک نمونه دوردست \fBgpsd\fP روی میزبان "example.com" و دستگاه دوردست "/dev/ttyS0". جمع‌آوری ۶۰ فیکس موقعیت، توقف، ذخیره نمودار در "save.jpg" و خروج:
.sp
.if n .RS 4
.nf
.fam C
gpsplot \-\-count 60 \-\-exit \-\-fields llm \-\-image save.jpg example.com::/dev/ttyS0
.fam
.fi
.if n .RE
.SH "کدهای بازگشتی (RETURN VALUES)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgpsd\fP(8), \fBgpsprof\fP(1), \fBgpsfake\fP(1).
.SH "منابع (RESOURCES)"
.sp
\fBتارنمای پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق نشر این فایل متعلق به پروژه GPSD در سال 2020 است.
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسنده (AUTHOR)"
.sp
Gary E. Miller