نام (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