GPSPLOT(1)                       مستندات GPSD                       GPSPLOT(1)

نام (NAME)
       gpsplot - ابزاری برای استخراج و رسم پویای داده‌ها از gpsd

خلاصه دستور (SYNOPSIS)
       gpsplot [OPTIONS] [server[:port[:device]]]

       gpsplot -h

       gpsplot -V

توضیحات (DESCRIPTION)
       gpsplot ابزاری برای اتصال به gpsd و رسم پویای داده‌ها بر روی صفحه نمایش
       کاربر است. انواع نمودارها شامل نمودارهای پراکندگی (scatterplots) و
       نمودارهای نواری پیوسته (stripcharts) هستند.

       رسم نمودار نیازمند نصب ماژول Matplotlib در پایتون و وابستگی‌های متعدد آن
       روی میزبان نمایشگر است. اگر میزبان نمایشگر، همان میزبان gpsd نباشد، در
       این صورت نیازی به نصب بودن Matplotlib روی میزبان gpsd نیست.

       gpsplot به دسترسی‌های ریشه (root) نیازی ندارد، اما می‌تواند با دسترسی
       root اجرا شود. اجرای آن با sudo باعث از دست رفتن برخی عملکردهای آن
       خواهد شد. این ابزار را می‌توان به‌طور همزمان با ابزارهای دیگری که به gpsd
       محلی متصل هستند بدون ایجاد مشکل اجرا کرد.

گزینه‌ها (OPTIONS)
       -?, -h, --help
           چاپ پیام راهنمای نحوه استفاده و خروج.

       -b BACKEND, --backend BACKEND
           تنظیم بک‌اند تعاملی Matplotlib به BACKEND.

       -B, --backends
           چاپ بک‌اندهای تعاملی در دسترس Matplotlib و سپس خروج. بک‌اندهای
           Matplotlib از نظر سرعت اجرا و ظاهر بصری بسیار متفاوت هستند. برای
           مشاهده تفاوت‌ها همه آنها را امتحان کنید.

       -d LVL, --debug LVL
           تنظیم سطح اشکال‌زدایی (debug) به LVL.

       --device DEVICE
           دستگاه (DEVICE) روی gpsd برای اتصال. پیش‌فرض همه دستگاه‌ها است.

       --exit
           خروج پس از اتمام اجرای --count، --file یا --seconds.

       --fields FIELDS
           کد فیلدهای مورد نظر برای رسم نمودار. مقدار FIELDS یکی از این موارد
           است: llh (عرض‌جغرافیایی/طول‌جغرافیایی/ارتفاع از بیضوی مبنا altHAE) یا
           llm (عرض‌جغرافیایی/طول‌جغرافیایی/ارتفاع از سطح متوسط دریا altMSL).

       --file FILE
           خواندن داده‌های JSON از FILE به جای gpsd.

       --host HOST
           اتصال به gpsd روی HOST (سرور). پیش‌فرض localhost است.

       --image IMAGE.EXT
           ذخیره نمودار به صورت IMAGE.EXT. پسوند EXT نوع تصویر (.jpg، .png و
           غیره) را تعیین می‌کند. پسوندهای پشتیبانی‌شده به نصب سیستم بستگی
           دارند.

       -n COUNT, --count COUNT
           توقف پس از COUNT پیام نمودار. مقدار 0 برای غیرفعال کردن. پیش‌فرض 0.

       --plottype PLOTTYPE
           نوع نمودار مورد نظر برای رسم. مقدار PLOTTYPE یکی از 'scatterplot'
           یا 'stripchart' است.

       -p PORT, --port PORT
           استفاده از PORT برای اتصال به gpsd. پیش‌فرض 2947 است.

       -V, --version
           چاپ نسخه برنامه و خروج.

       -x SECONDS, --seconds SECONDS
           توقف پس از SECONDS ثانیه. مقدار 0 برای غیرفعال کردن. پیش‌فرض 0.

آرگومان‌ها (ARGUMENTS)
       به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی gpsd که روی localhost در
       حال اجراست و با استفاده از پورت پیش‌فرض GPSD یعنی 2947 جمع‌آوری می‌کنند.
       آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را لغو کند:
       [server[:port[:device]]]

       برای توضیحات بیشتر و مثال‌ها، بخش ARGUMENTS را در صفحه راهنمای gps(1)
       ببینید.

محیط (ENVIRONMENT)
       می‌توانید متغیر محیطی MPLBACKEND را روی بک‌اند دلخواه Matplotlib تنظیم
       کنید. این کار شما را از استفاده مکرر از -b BACKEND در هر بار اجرای
       gpsplot بی‌نیاز می‌کند.

مثال‌ها (EXAMPLES)
       تولید یک نمودار پراکندگی از عرض جغرافیایی، طول جغرافیایی و ارتفاع از
       سطح متوسط دریا (altMSL). توقف پس از ۶۰ ثانیه:

           gpsplot --seconds 60 --fields llm

       تولید یک نمودار پراکندگی از عرض جغرافیایی، طول جغرافیایی و ارتفاع از
       بیضوی مبنا (altHAE). توقف پس از ۶۰ فیکس موقعیت:

           gpsplot --count 60 --plottype stripchart

       استفاده از بک‌اند WXAgg برای تکرار آزمایش قبلی به منظور بررسی سرعت یا
       ظاهر بهتر:

           export MPLBACKEND=WX
           gpsplot --count 60 --plottype stripchart

       تولید محلی نمودار پراکندگی عرض جغرافیایی، طول جغرافیایی و altMSL از یک
       نمونه دوردست gpsd روی میزبان "example.com" و دستگاه دوردست
       "/dev/ttyS0". جمع‌آوری ۶۰ فیکس موقعیت، توقف، ذخیره نمودار در "save.jpg"
       و خروج:

           gpsplot --count 60 --exit --fields llm --image save.jpg example.com::/dev/ttyS0

کدهای بازگشتی (RETURN VALUES)
       0
           در صورت موفقیت.

       1
           در صورت بروز خطا.

همچنین ببینید (SEE ALSO)
       gpsd(8), gpsprof(1), gpsfake(1).

منابع (RESOURCES)
       تارنمای پروژه:  <https://gpsd.io>

کپی‌رایت و تکثیر (COPYING)
       حق نشر این فایل متعلق به پروژه GPSD در سال 2020 است.
       SPDX-License-Identifier: BSD-2-clause

نویسنده (AUTHOR)
       Gary E. Miller

GPSD 3.27.5                       2025-11-04                        GPSPLOT(1)