نام (NAME)

gpsprof - تحلیل و پروفایل کارایی GPS و gpsd و رسم نمودار اطلاعات تاخیر

خلاصه دستور (SYNOPSIS)

gpsprof [OPTIONS] [server[:port[:device]]]

gpsprof -h

gpsprof -V

توضیحات (DESCRIPTION)

دستور gpsprof مشخصات دقت، تاخیر، نمای آسمان (skyview) و انحراف زمانی (time drift) یک GPS را پروفایل و ارزیابی می‌کند. این ابزار برنامه‌ای برای GNUPLOT را در خروجی استاندارد تولید می‌کند که یکی از چندین نمودار توصیفی را رسم می‌نماید. همچنین می‌توان آن را طوری تنظیم کرد که داده‌های خام پروفایل را ارسال کند.

اطلاعات ارائه‌شده توسط نمودار مکانی پیش‌فرض می‌تواند برای تعیین مشخصات و سنجش دقت موقعیت‌یابی GPS مفید باشد.

دستور gpsprof از ابزارسنجی‌های (instrumentation) تعبیه‌شده در gpsd استفاده می‌کند. این ابزار می‌تواند داده‌ها را از یک نسخهٔ در حال اجرای gpsd به‌صورت محلی یا از راه دور بخواند؛ یا اینکه داده‌ها را از یک فایل لاگ (logfile) ذخیره‌شده بازیابی کند.

دستور gpsprof سبک طراحی شده است و حداقل منابع میزبان را مصرف می‌کند. نیازی به نصب زیرسیستم گرافیکی بر روی میزبان اجراکنندهٔ gpsprof نیست. کافی است فایل نمودار حاصل را به میزبان دیگری منتقل کرده تا با gnuplot(1) رندر و رسم شود.

دستور gpsprof نیازی به مجوزهای دسترسی ریشه (root) ندارد، اما با دسترسی ریشه نیز بدون مشکل اجرا می‌شود.

گزینه‌ها (OPTIONS)

گزینهٔ -f, --formatter نوع نمودار را تعیین می‌کند. در حال حاضر انواع نمودار زیر تعریف شده‌اند:

space

polar

polarunused

polarused

time

instrumented

به منظور توضیحات زیر، مفهوم «آغاز چرخهٔ گزارش» یا SORC (سرنام start-of-reporting-cycle) زمانی است که چرخهٔ گزارش‌دهی یک دستگاه آغاز می‌شود. این زمان با زیر نظر گرفتن در دسترس بودن داده پس از یک دورهٔ سکوت به اندازهٔ کافی طولانی تشخیص داده می‌شود، به طوری که بتوان اطمینان حاصل کرد شکاف پایان چرخهٔ ارسال گزارش قبلی حسگر مشاهده شده است. تشخیص این شکاف نیازمند دستگاهی است که با نرخ 9600bps یا سریع‌تر کار کند.

به همین ترتیب، EORC یا «پایان چرخهٔ گزارش» (سرنام end-of-reporting-cycle) زمانی است که دیمن آخرین جملهٔ مورد نیازش در چرخهٔ گزارش را مشاهده کرده و آمادهٔ ارسال تثبیت به کلاینت است.

مؤلفه‌های نمودار ابزارسنجی‌شده به شرح زیر هستند:

Fix latency (تاخیر تثبیت)

RS232 time (زمان RS232)

Analysis time (زمان تحلیل)

Reception time (زمان دریافت)

به دلیل اثرات بافرینگ RS232، گاهی اوقات پروفایلر درست در ابتدای نشست گزارش‌هایی با تاخیرهای بسیار بالا و غیرعادی تولید می‌کند. گزینهٔ -m به شما امکان می‌دهد آستانه‌ای برای تاخیر (به عنوان مضربی از زمان چرخه) تعیین کنید که گزارش‌های بالاتر از آن نادیده گرفته شوند.

uninstrumented

-?, -h, --help

-d FILE, --dumpfile FILE

-d LVL, --debug LVL

-l FILE, --logfile FILE

gnuplot -e "set terminal"

آرگومان‌ها (ARGUMENTS)

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

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

سیگنال‌ها (SIGNALS)

ارسال SIGUSR1 به یک نمونهٔ در حال اجرا باعث می‌شود یک پیام اتمام در خروجی خطای استاندارد بنویسد و پردازش را ادامه دهد. اولین عدد در پیام راه‌اندازی، شناسه فرآیند (process ID) برای ارسال سیگنال است.

مثال‌ها (EXAMPLES)

برای نمایش نمودار، از gnuplot(1) استفاده کنید. بنابراین، به عنوان مثال برای نمایش نمودار پراکندگی فضایی پیش‌فرض روی نمایشگر x11 خود، این دستور را اجرا کنید:

gpsprof | gnuplot -p

برای تولید یک فایل تصویری:

gpsprof -T png | gnuplot > image.png

برای تولید یک نمودار قطبی، و ذخیرهٔ داده‌های GPS برای نمودارهای بعدی:

gpsprof -f polar -T jpeg -l polar.json | gnuplot > polar.png

سپس برای ساخت نمودارها و تصاویر PNG متناظر polarused و polarunused از داده‌های GPS که به‌تازگی ذخیره شده‌اند:

gpsprof -f polarused -T jpeg -r < polar.json > polarused.plot
gnuplot < polarused.plot > polarused.png
gpsprof -f polarunused -T jpeg -r < polar.json > polarunused.plot
gnuplot < polarunused.plot  > polarunused.png

می‌توانید مراحل را تفکیک کنید، تا نیازی به اجرای کل زنجیره به صورت هم‌زمان نباشد. برای اینکه بتوانید بدون نیاز به جمع‌آوری مجدد تمام داده‌ها تنظیمات را تغییر دهید. به این صورت:

gpspipe -w -x 3600 ::/dev/ttyS0 > MY.raw
gpsdecode  < MY.raw > MY.json
gpsprof -r -T pngcairo -t "MY Title" < MY.json > MY.plt
gnuplot MY.plt > MY.png
display MY.png

دستور gpspipe یک ساعت از داده‌های خام دستگاه محلی gpsd در مسیر /dev/ttyS0 را در MY.raw ذخیره می‌کند. تکمیل آن یک ساعت زمان خواهد برد.

دستور gpsdecode داده‌های خام موجود در MY.raw را به یک فایل JSON متعلق به gpsd به نام MY.json تبدیل می‌کند.

دستور gpsprof فایل MY.json را می‌خواند و یک برنامهٔ gnuplot در MY.plt ایجاد می‌کند.

دستور gnuplot برنامهٔ موجود در MY.plt را اجرا کرده و فایل تصویری MY.png را تولید می‌کند.

برنامهٔ display فایل MY.png را روی میزکار شما نمایش می‌دهد..SH "مقادیر بازگشتی (RETURN VALUES)"

0

1

همچنین ببینید (SEE ALSO)

gpsd(8), display(1), gnuplot(1), gpsctl(1), gps(1), libgps(3), libgpsmm(3), gpsprof(1), gpsfake(1).

منابع (RESOURCES)

وبگاه پروژه: https://gpsd.io

کپی‌رایت و تکثیر (COPYING)

حق نشر این فایل در سال 2013 متعلق به پروژهٔ GPSD است
SPDX-License-Identifier: BSD-2-clause

نویسنده (AUTHOR)

Eric S. Raymond