'\" t
.\"     Title: gpsrinex
.\"    Author: Gary E. Miller
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-22
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: Persian
.\"
.TH "GPSRINEX" "1" "2025-11-22" "GPSD, Version 3.27.5" "GPSD Documentation"
.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)"
gpsrinex \- خواندن داده‌ها از gpsd، تبدیل به RINEX و ذخیره در یک پرونده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBgpsrinex\fP [OPTIONS] [server[:port[:device]]]
.sp
\fBgpsrinex\fP \-h
.sp
\fBgpsrinex\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBgpsrinex\fP برای اتصال به \fBgpsd\fP و خروجی دادن سنجش‌های خام دریافت‌شده در قالب یک پرونده مشاهدات RINEX به کار می‌رود. این قابلیت برای ارسال سنجش‌های خام (pseudorange و carrierphase) از \fBgpsd\fP به یک برنامه یا سرویس تعیین موقعیت دقیق نقطه (PPP) مفید است.
.sp
دستور \fBgpsrinex\fP نیازی به دسترسی ریشه ندارد، اما می‌تواند با دسترسی ریشه نیز اجرا شود. برخی از مثال‌های این صفحه ممکن است هنگام اجرا تحت \fBsudo\fP کار نکنند. این ابزار می‌تواند هم‌زمان با سایر ابزارهایی که به یک \fBgpsd\fP محلی یا ریموت متصل هستند، بدون ایجاد مشکل اجرا شود.
.sp
ابزار \fBgpsrinex\fP نیاز دارد که گیرنده GNSS سنجش‌های خام را به \fBgpsd\fP ارسال کند. تنها تعداد کمی از گیرنده‌های GNSS این قابلیت را دارند. علاوه بر این، درایور \fBgpsd\fP برای آن GNSS باید از حالت خام پشتیبانی کند. در حال حاضر فقط درایور u\-blox این پشتیبانی را دارد. تنها برخی از گیرنده‌های u\-blox سری 8، 9 و 10 پیام مورد نیاز UBX\-RXM\-RAWX را پیاده‌سازی می‌کنند. گیرنده NEO\-M8T به کارکرد درست شناخته شده است، اما نیاز به پیکربندی با \fBubxtool\fP دارد.
.sp
پیش از استفاده از \fBubxtool\fP، حتماً متغیر محیطی UBXOPTS را با نسخه پروتکل صحیح گیرنده u\-blox خود تنظیم کنید. اگر نسخه پروتکل شما 32.00 است، این کار را انجام دهید:
.sp
.if n .RS 4
.nf
.fam C
export UBXOPTS="\-P 32.00"
.fam
.fi
.if n .RE
.sp
فرمت RINEX تعاریف و اختصارات خاص خود را دارد؛ حتماً به مستندات آن مراجعه کنید. یک پرونده مشاهدات (.obs) شامل مجموعه‌داده‌هایی به نام مبدأ زمانی (epoch) است که حاوی pseudorange و carrierphase برای هر ماهواره مشاهده‌شده است.
.sp
دستور \fBgpsrinex\fP به صورت پیش‌فرض ۲۰ مبدأ زمانی (epoch) با فاصله زمانی ۳۰ ثانیه از یکدیگر دریافت می‌کند. این فرآیند ۱۰ دقیقه طول خواهد کشید. بیشتر کاربران بازه ۳۰ ثانیه‌ای را بهینه می‌دانند. بسیاری از برنامه‌های PPP به دست‌کم ۱ یا ۲ ساعت داده نیاز دارند، اما نباید بیش از ۲۴ یا ۴۸ ساعت داده ارسال شود. بیشتر کاربران ۴ تا ۶ ساعت داده را حداقل میزان لازم برای دقت مناسب می‌دانند. ساعت‌های بیشتر بهبود چندانی ایجاد نخواهد کرد.
.sp
خروجی شامل یک پرونده مشاهدات RINEX خواهد بود که آماده خوانده شدن توسط برنامه PPP شما است. نام پرونده پیش‌فرض به این شکل خواهد بود:
\fIgpsrinexYYYYjjjHHMMSS.obs\fP. می‌توانید این نام پرونده را با گزینه \fB\-f\fP تغییر دهید.
.sp
به صورت اختیاری می‌توان سرور، شماره پورت TCP/IP و دستگاه ریموت را مشخص کرد. در صورت عدم ذکر، \fBgpsrinex\fP به localhost روی پورت پیش‌فرض (2947) متصل می‌شود و تمام دستگاه‌های باز شده توسط \fBgpsd\fP را رصد می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش پیام راهنمای نحوه استفاده و خروج.
.RE
.sp
\fB\-D LVL\fP, \fB\-debug LVL\fP
.RS 4
تنظیم سطح اشکال‌زدایی روی LVL.
.RE
.sp
\fB\-f OUTFILE\fP, \fB\-\-fileout OUTFILE\fP
.RS 4
ذخیره خروجی RINEX در پرونده OUTFILE.
.RE
.sp
\fB\-F INFILE\fP, \fB\-\-filein INFILE\fP
.RS 4
خواندن JSON جی‌پی‌اس از پرونده، به جای خواندن مستقیم از یک \fIgpsd\fP زنده.
.RE
.sp
\fB\-g CODES\fP, \fB\-\-gnss CODES\fP
.RS 4
خروجی دادن سامانه GNSS تنها در صورتی که کد RINEX آن در CODES موجود باشد.
کدها عبارتند از: C = BeiDou, E = Galileo, G = GPS, I = IRNSS, J = QZSS, R = GLONASS, S = SBAS.
.RE
.sp
\fB\-i SECS\fP, \fB\-\-interval SECS\fP
.RS 4
مکث به مدت [interval] ثانیه بین هر مبدأ زمانی (epoch). این بازه زمانی را می‌توان تا دقت میلی‌ثانیه مشخص کرد. سرویس OPUS بازه‌های ۱، ۲، ۳، ۵، ۱۰، ۱۵ یا ۳۰ ثانیه‌ای را می‌پذیرد. سپس OPUS داده‌ها را به بازه‌های ۳۰ ثانیه‌ای کاهش می‌دهد. مقدار پیش‌فرض 30.000 است.
.RE
.sp
\fB\-n COUNT\fP, \fB\-\-count COUNT\fP
.RS 4
تعیین تعداد COUNT مبدأ زمانی (epoch) در خروجی. سرویس OPUS حداقل به ۱۵ دقیقه و حداکثر به ۴۸ ساعت داده نیاز دارد.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
چاپ نسخه \fBgpsrinex\fP و خروج.
.RE
.sp
گزینه‌های زیر رشته‌هایی را تعیین می‌کنند که در پرونده مشاهدات RINEX 3 تولیدشده قرار می‌گیرند. این گزینه‌ها تغییری در نحوه محاسبات \fBgpsrinex\fP ایجاد نمی‌کنند.
.sp
\fB\-\-agency AGENCY\fP
.RS 4
نام سازمانی که پرونده جاری را ایجاد می‌کند.
.RE
.sp
\fB\-\-ant_num NUMBER\fP
.RS 4
شماره سریال آنتن.
.RE
.sp
\fB\-\-ant_type TYPE\fP
.RS 4
نوع آنتن.
.RE
.sp
\fB\-\-comment CMT\fP
.RS 4
توضیحات یا یادداشت دلخواه.
.RE
.sp
\fB\-\-marker_name NAME\fP
.RS 4
نام نشانگر (marker).
.RE
.sp
\fB\-\-marker_type TYPE\fP
.RS 4
نوع نشانگر (marker).
.RE
.sp
\fB\-\-observer OBSERVER\fP
.RS 4
نام مشاهده‌کننده (شما).
.RE
.sp
\fB\-\-rec_num NUM\fP
.RS 4
شماره سریال گیرنده.
.RE
.sp
\fB\-\-rec_type TYPE\fP
.RS 4
نوع گیرنده.
.RE
.sp
\fB\-\-rec_vers VERS\fP
.RS 4
نسخه گیرنده.
.RE
.sp
گزینه‌های زیر مقادیر اعشاری شناوری را تعیین می‌کنند که در پرونده مشاهدات RINEX تولیدشده قرار می‌گیرند. این گزینه‌ها تغییری در محاسبات \fBgpsrinex\fP ایجاد نمی‌کنند.
.sp
\fB\-\-ant_e EASTING\fP
.RS 4
فاصله شرقی آنتن از نشانگر به متر.
.RE
.sp
\fB\-\-ant_h HEIGHT\fP
.RS 4
ارتفاع آنتن از نشانگر به متر.
.RE
.sp
\fB\-\-ant_n NORTHING\fP
.RS 4
فاصله شمالی آنتن از نشانگر به متر.
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
به صورت پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی \fBgpsd\fP که روی localhost در حال اجراست و با استفاده از پورت پیش‌فرض 2947 مربوط به GPSD جمع‌آوری می‌کنند. آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را لغو کند: \fB[server[:port[:device]]]\fP
.sp
برای توضیحات و مثال‌های بیشتر، بخش \fBARGUMENTS\fP را در صفحه راهنمای \fBgps\fP(1) مشاهده کنید.
.SH "مثال‌ها (EXAMPLES)"
.sp
مثال ۱:
.sp
ایجاد یک پرونده .obs چهار ساعته. با یک \fBgpsd\fP در حال اجرا که روی localhost قابل دسترسی است، تمام موارد زیر را به ترتیب انجام دهید. ترتیب مراحل اهمیت دارد.
.sp
پیام‌های سنجش خام طولانی هستند. مطمئن شوید سرعت درگاه سریال به اندازه کافی بالا باشد:
.sp
.if n .RS 4
.nf
.fam C
gpsctl \-s 115200
.fam
.fi
.if n .RE
.sp
غیرفعال کردن تمام پیام‌های NMEA و فعال کردن پیام‌های دودویی:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-d NMEA
ubxtool \-e BINARY
.fam
.fi
.if n .RE
.sp
گیرنده NEO\-M8N تنها زمانی سنجش‌های خام را به طور پایدار خروجی می‌دهد که فقط منظومه‌های ماهواره‌ای GPS و QZSS فعال باشند. اگر سرویس PPP شما می‌تواند از GLONASS استفاده کند، آن را نیز فعال کنید. حتماً قبل از فعال‌سازی، ابتدا غیرفعال کنید تا موقتاً منظومه‌های زیادی انتخاب نشده باشند. ابزار \fBubxtool\fP طبق توصیه u\-blox، منظومه QZSS را به همراه GPS فعال می‌کند. تمام منظومه‌ها به جز GPS (و QZSS) را غیرفعال کنید:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-d BEIDOU
ubxtool \-d GALILEO
ubxtool \-d GLONASS
ubxtool \-d SBAS
ubxtool \-e GPS
.fam
.fi
.if n .RE
.sp
بررسی منظومه‌های فعال‌شده:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-p CFG\-GNSS
.fam
.fi
.if n .RE
.sp
فعال کردن پیام‌های سنجش خام:
.sp
.if n .RS 4
.nf
.fam C
ubxtool \-e RAWX
.fam
.fi
.if n .RE
.sp
بررسی اینکه پیام‌های داده خام در حال ارسال هستند:
.sp
.if n .RS 4
.nf
.fam C
ubxtool | fgrep RAWX
.fam
.fi
.if n .RE
.sp
باید این خروجی را مشاهده کنید:
.sp
.if n .RS 4
.nf
.fam C
UBX\-RXM\-RAWX:
UBX\-RXM\-RAWX:
.fam
.fi
.if n .RE
.sp
جمع‌آوری ۴ ساعت نمونه در بازه‌های ۳۰ ثانیه‌ای و ذخیره مشاهدات RINEX در پرونده today.obs:
.sp
.if n .RS 4
.nf
.fam C
gpsrinex \-i 30 \-n 480 \-f today.obs
.fam
.fi
.if n .RE
.sp
۴ ساعت صبر کنید. یک وعده غذا میل کنید یا کمی ورزش کنید. هنگامی که \fBgpsrinex\fP به پایان رسید، پرونده today.obs را در سرویس PPP مورد علاقه خود بارگذاری کنید.
.sp
مثال ۲:
.sp
جمع‌آوری داده‌های سنجش خام از یک \fBgpsd\fP ریموت و سپس پردازش بعدی آن با \fBgpsrinex\fP و \fBgpsprof\fP.
.sp
مطمئن شوید گیرنده همان‌طور که در مثال ۱ نشان داده شد، به درستی پیکربندی شده باشد.
.sp
دریافت ۴ ساعت داده خام زنده از \fBgpsd\fP ریموت در آدرس 10.168.1.2:
.sp
.if n .RS 4
.nf
.fam C
gpspipe \-x 14400 \-R 10.168.1.2 > 4h\-raw.ubx
.fam
.fi
.if n .RE
.sp
پس از اتمام gpspipe، پرونده 4h\-raw.ubx حاوی ۴ ساعت پیام دودویی خام UBX خواهد بود. آن داده‌های خام را با \fBgpsdecode\fP به فرمت JSON جی‌پی‌اس‌دی تبدیل کنید:
.sp
.if n .RS 4
.nf
.fam C
gpsdecode < 4h\-raw.ubx > 4h\-raw.json
.fam
.fi
.if n .RE
.sp
پرونده 4h\-raw.json اکنون حاوی داده‌های کدگذاری‌شده به عنوان JSON جی‌پی‌اس‌دی است. با استفاده از \fBgpsrinex\fP آن پرونده را بخوانید و یک پرونده RINEX ایجاد کنید:
.sp
.if n .RS 4
.nf
.fam C
gpsrinex \-F 4h\-raw.json
.fam
.fi
.if n .RE
.sp
پرونده RINEX در دایرکتوری جاری با نامی مشابه gpsrinexYYYYjjjHHMMSS.obs قرار خواهد گرفت. برای نحوه قالب‌بندی تاریخ، strftime(1) را مشاهده کنید.
.sp
اکنون می‌توانید از پرونده JSON برای تولید نمودار قطبی ماهواره‌های استفاده‌شده بهره ببرید:
.sp
.if n .RS 4
.nf
.fam C
gpsprof \-f polarused \-T jpeg \-r < 4h\-raw.json > 4h\-raw.plot
gnuplot < 4h\-raw.plot > 4h\-raw.png
.fam
.fi
.if n .RE
.sp
از نمایشگر تصویر دلخواه خود برای مشاهده وضعیت آسمان در 4h\-raw.png استفاده کنید.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت بروز خطا.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
یک سرویس شناخته‌شده که با خروجی gpsrinex کار می‌کند:
.URL "https://webapp.geod.nrcan.gc.ca/geod/tools\-outils/ppp.php" "" ""
.sp
سرویس OPUS به پرونده‌های مشاهدات ۲ فرکانسه نیاز دارد:
.URL "https://www.ngs.noaa.gov/OPUS" "" ""
.sp
علاقه‌مندان می‌توانند توضیحات قالب RINEX 3.04 را در اینجا بیابند:
.URL "ftp://igs.org/pub/data/format/rinex304.pdf" "" ""
.sp
قالب RINEX 4.02 در اینجا قرار دارد:
.URL "https://files.igs.org/pub/data/format/rinex_4.02.pdf" "" ""
.sp
\fBgpsd\fP(8), \fBgps\fP(1), \fBgpsprof\fP(1), \fBgpsfake\fP(1), \fBubxtool\fP(1), \fBgpsd_json\fP(5),
\fBstrftime\fP(1)
.SH "منابع (RESOURCES)"
.sp
\fBتارنمای پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق نشر این پرونده متعلق به پروژه GPSD است.
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسنده (AUTHOR)"
.sp
Gary E. Miller