'\" t .\" Title: GPSCORRELATE .\" Author: Stefano Zacchiroli .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 13 Feb 2025 .\" Manual: gpscorrelate 2.3 .\" Source: gpscorrelate 2.3 .\" Language: English .\" .TH "GPSCORRELATE" "1" "13 Feb 2025" "gpscorrelate 2\&.3" "gpscorrelate 2.3" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" gpscorrelate \- تطبیق تصاویر دیجیتال با داده‌های GPS و پر کردن فیلدهای EXIF .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBgpscorrelate\fR\ 'u \fBgpscorrelate\fR [{\-g\ \fIfile\&.gpx\fR} | {[\-l\ |\ \-\-latlong\ \fIlatitude,longitude\fR\fI[,elevation]\fR\ ]}] [\-z | \-\-timeadd\ +/\-\fIHH\fR[:\fIMM\fR]] [\-\-no\-photo\-tz] [\-O | \-\-photooffset\ \fIseconds\fR] [\-i | \-\-no\-interpolation] [\-v | \-\-verbose] [\-d | \-\-datum\ \fIdatum\fR] [\-n | \-\-no\-write] [\-R | \-\-replace] [\-m | \-\-max\-dist\ \fItime\fR] [\-t | \-\-ignore\-tracksegs] [\-\-heading] [\-B | \-\-max\-heading\ \fIdegrees\fR] [\-b | \-\-direction\ \fIdegrees\fR] [\-M | \-\-no\-mtime] [\-\-degmins] \fIimage\&.jpg\fR... .HP \w'\fBgpscorrelate\fR\ 'u \fBgpscorrelate\fR {\-s | \-\-show | \-o | \-\-machine} \fIimage\&.jpg\fR... .HP \w'\fBgpscorrelate\fR\ 'u \fBgpscorrelate\fR {\-x | \-\-show\-gpx} [\-z | \-\-timeadd\ +/\-\fIHH\fR[:\fIMM\fR]] [\-\-no\-photo\-tz] [\-O | \-\-photooffset\ \fIseconds\fR] \fIimage\&.jpg\fR... .HP \w'\fBgpscorrelate\fR\ 'u \fBgpscorrelate\fR {\-r | \-\-remove} [\-M | \-\-no\-mtime] \fIimage\&.jpg\fR... .HP \w'\fBgpscorrelate\fR\ 'u \fBgpscorrelate\fR {\-f | \-\-fix\-datestamps} {\-z | \-\-timeadd\ +/\-\fIHH\fR[:\fIMM\fR]} \fIimage\&.jpg\fR... .HP \w'\fBgpscorrelate\fR\ 'u \fBgpscorrelate\fR \-V | \-\-version | \-h | \-\-help .SH "توضیحات (DESCRIPTION)" .PP این صفحه راهنما دستور \fBgpscorrelate\fR را مستند می‌کند. مستندات گسترده‌تری در قالب HTML موجود است؛ به انتهای این راهنما مراجعه فرمایید. .PP دستور \fBgpscorrelate\fR برنامه‌ای است که روی تصاویر دیجیتال با فرمت JPEG عمل می‌کند و فیلدهای EXIF (قالب فایل تصویری قابل تعویض) مربوط به اطلاعات سامانه موقعیت‌یاب جهانی (GPS) را تکمیل می‌نماید. منبع داده‌های GPS یک فایل با قالب GPX (فرمت تبادل GPS) است که اطلاعات مکان را بر پایه XML ذخیره می‌کند. عمل پر کردن این فیلدها با عنوان \fIتطبیق\fR (correlation) شناخته می‌شود. .PP اگر داده‌های GPS در لحظه دقیق ثبت عکس (با دقت ۱ ثانیه) موجود باشند، به صورت دست‌نخورده در فیلدهای EXIF ذخیره می‌شوند. در غیر این صورت، می‌توان از درونیابی خطی (linear interpolation) داده‌های GPS ثبت‌شده در لحظات قبل و بعد از عکس‌برداری استفاده کرد. اگر تصویر دارای وضوح زمانی کسری از ثانیه باشد، برای تخمین دقیق‌تر موقعیت بین دو نقطه به کار گرفته می‌شود. درونیابی خطی هنگامی که فاصله‌ها نزدیک باشد نتایج بسیار خوبی می‌دهد؛ اما اگر فاصله‌شان چندین کیلومتر باشد (مانند مسیر پرواز یک هواپیما با فواصل زمانی طولانی)، در مقایسه با مسیر دایره بزرگ (great circle) که هواپیماها معمولاً پرواز می‌کنند مقداری خطا پدید خواهد آمد. معیاری از دقت تقریبی خوانش مکان GPS (بر پایه تعداد ارقام اعشار ثبت‌شده در نقطه مسیر) از طریق مخرج فیلدهای مقادیر گویا در تصویر ذخیره و حفظ می‌شود. همچنین در صورت وجود اطلاعات HDOP ماهواره‌ها برای تطبیق دقیق نقطه‌ای، برچسب \fBGPSDOP\fR نیز نوشته می‌شود که برآوردی مطمئن‌تر از دقت مکان ارائه می‌دهد. .PP الگوریتم درونیابی فرض می‌کند که مقادیر زمانی در فایل‌های GPX اکیداً صعودی هستند، که در حالت عادی نیز چنین است. اگر فایلی با این فرض مغایرت داشته باشد، پیام \fBWarning: track points are not ordered by time\fR به همراه نخستین مقدار زمانی نامنظم در خروجی خطای استاندارد (stderr) نوشته می‌شود. هر مقدار مکانی ثبت‌شده در تصاویر با چنین فایلی ممکن است دقیق‌ترین مختصات ممکن نباشد (اگر عکس‌ها در حوالی زمان این ناهمخوانی زمانی گرفته شده باشند). در صورتی که زمان میان بخش‌های مسیر (track segments) به عقب بازگردد هشداری داده نمی‌شود؛ این موضوع تنها زمانی بر تطبیق اثر دارد که از گزینه \fB\-\-ignore\-tracksegs\fR استفاده شود. گزینه \fB\-\-max\-dist\fR می‌تواند برای تعیین حد مجاز شکاف زمانی استفاده شود تا در صورت بروز این مشکل، اثرات منفی آن مهار گردد. .SH "گزینه‌ها (OPTIONS)" .PP این برنامه‌ها از ساختار معمول خط فرمان GNU پیروی می‌کنند که در آن گزینه‌های طولانی با دو خط تیره (`\-\*(Aq) آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در ادامه آمده است: .PP \fB\-g\fR, \fB\-\-gps\fR \fIfile\&.gpx\fR .RS 4 تطبیق تصاویر با استفاده از فایل GPX مشخص‌شده که حاوی نقاط مسیر GPS است. این گزینه می‌تواند چندین بار برای تعیین چندین فایل GPX داده شود. برای هر عکسی که تطبیق داده می‌شود، اولین فایلی که حاوی مسیری پوشش‌دهنده زمان ثبت عکس باشد استفاده خواهد شد. تمام بخش‌های \fB\fR در هر فایل به کار گرفته می‌شوند. .RE .PP \fB\-l\fR, \fB\-\-latlong\fR \fIlatitude,longitude[,elevation]\fR .RS 4 تعیین یک مختصات جغرافیایی مشخص برای تمام عکس‌ها به جای تطبیق در امتداد یک مسیر در فایل GPX. ساختار باید به شکل کلی \fBlatitude,longitude,elevation\fR باشد که در آن عرض جغرافیایی (latitude) و طول جغرافیایی (longitude) باید هر کدام به صورت اعشاری مانند \fB\-123\&.45678\fR یا بر حسب درجه/دقیقه/ثانیه مانند \fB\-123\(de45\*(Aq67\&.8"\fR یا \fB\-123d45m67s\fR باشند. تعیین ارتفاع (elevation) اختیاری است. هر جزء می‌تواند با کاما، فاصله یا تب جدا شود. .sp توجه داشته باشید که این گزینه یک محدودیت شناخته‌شده دارد و در محلی‌سازی‌هایی (locales) که از کاراکتری جز "\&." برای ممیز استفاده می‌کنند، نماد اعشار محلی را در نظر نمی‌گیرد. .RE .PP \fB\-s\fR, \fB\-\-show\fR .RS 4 تنها نمایش داده‌های GPS موجود در برچسب‌های EXIF تصویر داده‌شده به جای تطبیق آن‌ها. زمان نمایش‌داده‌شده مستقیماً و بدون تغییر از تصویر خوانده می‌شود. .RE .PP \fB\-x\fR, \fB\-\-show\-gpx\fR .RS 4 تنها نمایش داده‌های GPS تصاویر داده‌شده در قالب GPX. توجه داشته باشید که نقاط به ترتیبی که تصاویر در خط فرمان قرار گرفته‌اند نوشته می‌شوند، بنابراین حتماً آن‌ها را به ترتیب زمان عکس‌برداری وارد کنید. گزینه‌های \fB\-z\fR/\fB\-\-timeadd\fR و \fB\-O\fR/\fB\-\-photooffset\fR دقیقاً مانند فرآیند تطبیق برای تعیین منطقه زمانی صحیح تصاویر رعایت می‌شوند. تصاویری که قابل خواندن نیستند یا برچسب GPS ندارند نادیده گرفته می‌شوند. اگر زمان عکس‌های داده‌شده در خط فرمان اکیداً صعودی نباشد، پیام \fBWarning: image files are not ordered by time\&.\fR در stderr نوشته می‌شود. .RE .PP \fB\-o\fR, \fB\-\-machine\fR .RS 4 تنها نمایش داده‌های GPS تصاویر داده‌شده در قالب ماشین‌خوان CSV. زمان نشان‌داده‌شده مستقیماً و بدون تغییر از تصویر استخراج می‌شود. تصاویر بدون برچسب GPS نادیده گرفته می‌شوند. فیلدهای خروجی عبارتند از: نام فایل، تاریخ و زمان، عرض جغرافیایی، طول جغرافیایی و ارتفاع؛ که مقدار اول نام فایل ورودی، مقدار دوم برچسب زمانی و سه مقدار آخر اعدادی ممیز شناور همراه با علامت مثبت یا منفی اختیاری هستند. .RE .PP \fB\-r\fR, \fB\-\-remove\fR .RS 4 حذف تمامی داده‌های GPS EXIF از تصاویر مشخص‌شده. توجه داشته باشید که این گزینه تنها برچسب‌های GPSای را حذف می‌کند که برنامه توانایی افزودن آن‌ها را دارد؛ بنابراین همه برچسب‌های ممکن GPS EXIF را پاک نمی‌کند. سایر برچسب‌ها دست‌نخورده باقی می‌مانند. .RE .PP \fB\-z\fR, \fB\-\-timeadd\fR \fB+/\-\fR\fIHH\fR[\fB:\fR\fIMM\fR] .RS 4 زمانی که باید به نقاط GPS اضافه شود تا با برچسب‌های زمانی عکس‌ها همخوانی پیدا کند. برچسب‌های زمانی GPS به وقت UTC هستند؛ در حالی که زمان تصاویر معمولاً به وقت محلی ذخیره می‌شود. منطقه زمانی استفاده‌شده هنگام ثبت عکس‌ها را وارد کنید؛ مثلاً \fB+8\fR برای پرث در استرالیای غربی یا \fB\-2:30\fR برای سنت جان در نیوفاندلند. این مقدار به صورت پیش‌فرض برابر با منطقه زمانی تعبیه‌شده در عکس است، یا اگر موجود نباشد (یا هنگامی که \fB\-\-no\-photo\-tz\fR داده شده باشد)، اختلاف UTC منطقه زمانی محلی در هنگام پردازش نخستین تصویر خواهد بود (نسخه‌های پیش از ۱.۷ به صورت پیش‌فرض 00:00 بودند). .RE .PP \fB\-\-no\-photo\-tz\fR .RS 4 نادیده گرفتن هرگونه برچسب EXIF از نوع \fBOffsetTimeOriginal\fR در عکس‌ها که منطقه زمانی عکس‌برداری را تعیین می‌کند. اگر این برچسب نادرست باشد، مثلاً کاربر هنگام سفر تنظیم دستی منطقه زمانی دوربین را فراموش کرده باشد، این گزینه مانع استفاده از آن می‌شود. با این گزینه، \fBgpscorrelate\fR به تشخیص خودکار منطقه زمانی بازمی‌گردد یا از مقدار تعیین‌شده به صورت دستی (در صورت استفاده از \fB\-\-timeadd\fR) بهره می‌گیرد. .RE .PP \fB\-O\fR, \fB\-\-photooffset\fR \fIseconds\fR .RS 4 مدت زمان به ثانیه (مقادیر اعشاری مجاز هستند) که باید به برچسب زمانی عکس افزوده شود تا با زمان GPS تطبیق یابد. برای تعیین میزان ثانیه مورد نیاز، کافی است از دستگاه GPS خود در حالی که زمان جاری را نشان می‌دهد عکسی بگیرید و آن را با برچسب زمانی فایل عکس مقایسه نمایید. برچسب‌های زمانی EXIF در فایل تصویر بر اساس این مقدار تغییری نمی‌کنند. .RE .PP \fB\-i\fR, \fB\-\-no\-interpolation\fR .RS 4 غیرفعال کردن درونیابی خطی میان نقاط. با این فلگ، نزدیک‌ترین نقطه دقیق (در محدوده \fB\-\-max\-dist\fR) استفاده می‌شود. بدون این فلگ، عکس‌های گرفته‌شده میان زمان دو مختصات ثبت‌شده GPS بر پایه درونیابی خطی بین آن دو نقطه تطبیق می‌یابند. .RE .PP \fB\-v\fR, \fB\-\-verbose\fR .RS 4 نمایش اطلاعات بیشتر در طول فرآیند تطبیق تصویر، از جمله داده‌های GPS گزینش‌شده برای هر عکس. .RE .PP \fB\-d\fR, \fB\-\-datum\fR \fIdatum\fR .RS 4 تعیین مبنای ژئودتیک (datum) اندازه‌گیری GPS. اگر تنظیم نشود، از \fBWGS\-84\fR استفاده می‌شود (\fBTOKYO\fR گزینه محتمل دیگر است). با این حال، فرمت GPX نباید داده‌ای جز WGS-84 ذخیره کند، بنابراین این گزینه معمولاً فقط همراه با گزینه \fB\-\-latlong\fR مورد نیاز خواهد بود. .RE .PP \fB\-n\fR, \fB\-\-no\-write\fR .RS 4 عدم ذخیره داده‌های تطبیق‌یافته EXIF در فایل تصویر. در کنار گزینه \fB\-\-verbose\fR برای بررسی رویدادهایی که طی تطبیق رخ خواهد داد کاربرد دارد. .RE .PP \fB\-R\fR, \fB\-\-replace\fR .RS 4 بازنویسی برچسب‌های موجود GPS در فایل. بدون این گزینه، هر فایلی که از پیش دارای برچسب‌های GPS باشد نادیده گرفته خواهد شد. .RE .PP \fB\-m\fR, \fB\-\-max\-dist\fR \fItime\fR .RS 4 حداکثر زمان به ثانیه نسبت به زمان ثبت عکس که یک نقطه ثبت‌شده GPS می‌تواند داشته باشد و همچنان برای تطبیق به کار رود. پیش‌فرض این گزینه 0 است که به معنای غیرفعال بودن این بررسی می‌باشد. کافی است یکی از دو نقطه در این بازه باشد تا تطبیق صورت پذیرد. .sp اگر دید مستقیم به تعداد ماهواره‌های لازم در زمان ثبت مسیر قطع شود، ممکن است شکاف‌هایی در داده‌های فایل GPX رخ دهد. اگر دقت موقعیت ثبت‌شده اهمیت حیاتی دارد و ترجیح می‌دهید در صورتی که مختصات موجود GPS بیش از حد متعلق به گذشته یا آینده است هیچ مکانی برای عکس تطبیق نیابد، این گزینه را روی مقداری غیرصفر تنظیم کنید. .sp این گزینه همچنین از ثبت جهت حرکت و زاویه دوربین در همین شرایط جلوگیری می‌کند (توضیحات گزینه \fB\-\-max\-heading\fR را برای کاربرد آن ببینید). .RE .PP \fB\-t\fR, \fB\-\-ignore\-tracksegs\fR .RS 4 درونیابی میان بخش‌های مختلف مسیر (track segments). معمولاً بخش‌های مسیر نمایانگر جلسات ضبط جداگانه GPS هستند که فاصله میان آن‌ها نشان‌دهنده عدم ضبط توسط GPS است. از آنجا که درونیابی گزینه \fB\-\-max\-dist\fR را رعایت می‌کند، در صورت تنظیم هر دو گزینه، حتی بخش‌های دارای فاصله زمانی زیاد نیز بدون نگرانی قابل استفاده خواهند بود. بدون این فلگ، عکس‌های گرفته‌شده در فاصله زمانی میان دو بخش \fB\fR در فایل GPX تطبیق داده نمی‌شوند. .RE .PP \fB\-\-heading\fR .RS 4 نوشتن برچسب EXIF مربوط به جهت حرکت در لحظه ثبت عکس. این امر تنها در صورتی ممکن است که جهت در برچسبی مناسب درون ورودی \fB\fR در فایل GPX ذخیره شده باشد. برچسب‌های پشتیبانی‌شده عبارتند از \fBcourse\fR (از GPX 1.0)، \fBextensions/TrackPointExtension/course\fR (یک Garmin\(rg \fBTrackPointExtension\fR)، و \fBextensions/compass\fR (تولیدشده توسط OSMTracker). .sp برنامه \fBgpscorrelate\fR با تمامی این برچسب‌ها به عنوان جهت واقعی حرکت برخورد می‌کند؛ اما این برچسب‌ها استاندارد کاملاً مشخصی ندارند و ممکن است همیشه حامل داده‌های مورد انتظار نباشند. برای مثال، تلفن همراه ممکن است جهتی که دستگاه به سمت آن گرفته شده را ذخیره کند نه جهت جابجایی را، یا ممکن است جهت نسبت به شمال مغناطیسی باشد نه شمال واقعی. همچنین ممکن است دستگاه جهت را از روی سرعت پایین حرکت GPS تخمین بزند که دقیق نخواهد بود. با تکیه بر شناخت خود از نرم‌افزار ثبت‌کننده مسیر، میزان قابلیت اطمینان این برچسب‌ها را بسنجید. .sp اگر این گزینه با \fB\-\-latlong\fR به جای \fB\-\-gps\fR به کار رود، جهت ثابت 0 ثبت خواهد شد (این رفتار ممکن است در آینده تغییر کند). .RE .PP \fB\-B\fR, \fB\-\-max\-heading\fR \fIdegrees\fR .RS 4 عدم درج برچسب‌های \fB\-\-heading\fR و \fB\-\-direction\fR برای تصاویری که در آن‌ها جهت حرکت بین نقاط GPX مورد استفاده، بیش از تعداد درجات تعیین‌شده تغییر کرده باشد. این امر مانع از ثبت مقادیری می‌شود که به دلیل عکس‌برداری در زمان پیچیدن تند احتمالاً نادرست هستند. این قابلیت به صورت پیش‌فرض غیرفعال است. .sp این گزینه مانع از ثبت جهت یا زاویه نادرست در مواردی که نقاط GPS با فاصله‌ای بیشتر از زمان لازم برای دور زدن کامل وسیله نقلیه ثبت شده‌اند نخواهد شد. برای مثال، اگر خودرو برای دور زدن کامل به ۸ ثانیه نیاز داشته باشد اما برچسب‌های GPS هر ۱۰ ثانیه ثبت شوند، دو نقطه ابتدا و انتهای دور زدن ممکن است جهت‌هایی بسیار نزدیک داشته باشند (در محدوده \fB\-\-max\-heading\fR)؛ اما عکسی که در میانه چرخش و ۴ ثانیه پس از نقطه اول گرفته شده، زاویه‌ای درونیابی‌شده خواهد داشت که حدود ۱۸۰ درجه با واقعیت اختلاف دارد. با تنظیم گزینه \fB\-\-max\-dist\fR روی مقداری بسیار کمتر از مدت چرخش (مانند ۴ در این مثال)، از ثبت چنین مقادیر نادرستی جلوگیری کنید. .RE .PP \fB\-b\fR, \fB\-\-direction\fR \fIdegrees\fR .RS 4 نوشتن یک برچسب EXIF که جهت اشاره دوربین را در زمان ثبت تصویر نشان می‌دهد. آرگومان degrees اختلاف زاویه میان جهت حرکت (مقداری که در صورت تعیین \fB\-\-heading\fR نوشته می‌شد) و راستای دوربین را تعیین می‌کند. برای مثال، اگر دوربین به سمت پنجره سمت راست خودرو اشاره داشته باشد، این مقدار به صورت \fB\-\-direction\fR \fI90\fR تنظیم می‌شود. اگر گزینه \fB\-\-heading\fR نیز مشخص شده باشد، این دو برچسب همواره به اندازه همین مقدار درجه با یکدیگر اختلاف خواهند داشت. اگر دقت برایتان مهم است، از گزینه‌های \fB\-\-max\-heading\fR و \fB\-\-max\-dist\fR استفاده کنید تا درج این برچسب‌ها به زمان‌هایی محدود شود که موقعیت مکانی تثبیت شده و پیچ تندی رخ نداده باشد. از آنجا که این گزینه برای تمام طول مسیر اعمال می‌شود، تنها زمانی مفید است که دوربین در طول سفر نسبت به خودرو در وضعیتی ثابت نصب شده باشد. .sp این گزینه می‌تواند همراه با \fB\-\-latlong\fR نیز استفاده شود، که در این حالت آرگومان به صورت مستقیم به عنوان راستای دوربین بدون تغییر منظور می‌گردد. .RE .PP \fB\-M\fR, \fB\-\-no\-mtime\fR .RS 4 عدم تغییر زمان آخرین اصلاح (mtime) فایل‌های ویرایش‌شده. .RE .PP \fB\-f\fR, \fB\-\-fix\-datestamps\fR .RS 4 اصلاح برچسب‌های تاریخ نامعتبر GPS که با نگارش‌های قبل از 1.5.2 نرم‌افزار \fBgpscorrelate\fR نوشته شده‌اند، با جایگزینی آن‌ها با برچسب زمانی عکس. پیش از نگارش 1.5.2، دو باگ مقادیر اشتباهی در برچسب‌های GPSDateStamp و GPSTimeStamp درج می‌کردند. این گزینه تک‌تک فایل‌های ورودی را بررسی کرده و در صورت وجود مشکل، آن را تصحیح می‌کند. از این گزینه همراه با \fB\-\-no\-write\fR استفاده کنید تا از اعمال تغییرات جلوگیری شود (جهت بررسی وجود مشکل). این گزینه متضمن \fB\-\-no\-mtime\fR نیز می‌باشد. همچنین لازم است از گزینه \fB\-\-timeadd\fR برای تعیین اختلاف زمان محلی با ساعت UTC برای تصاویر داده‌شده استفاده کنید. .RE .PP \fB\-\-degmins\fR .RS 4 نوشتن موقعیت مکانی به فرمت DD MM\&.MM (به جای فرمت دقیق‌تر DD MM SS\&.SS) که در نسخه‌های پیش از 1.5.3 برنامه \fBgpscorrelate\fR پیش‌فرض بود. هیچ دلیل مناسبی برای استفاده از این گزینه وجود ندارد مگر آنکه نرم‌افزار قدیمی و معیوبی انتظار این سبک را داشته باشد. .RE .PP \fB\-h\fR, \fB\-\-help\fR .RS 4 تنها نمایش خلاصه‌ای از گزینه‌های موجود. .RE .PP \fB\-V\fR, \fB\-\-version\fR .RS 4 تنها چاپ شماره نگارش برنامه \fBgpscorrelate\fR و اطلاعات حق نشر. .RE .SH "مثال‌ها (EXAMPLES)" .PP تطبیق تمامی عکس‌های موجود در یک پوشه که در فصل تابستان در اروپای غربی گرفته شده‌اند (یعنی UTC-2): .PP \fBgpscorrelate \-g Test\&.gpx \-z 2 *\&.jpg\fR .PP تطبیق تمام عکس‌های یک پوشه ثبت‌شده در ایتالیا، همراه با تغییر خودکار به UTC-2 یا UTC-1 بر اساس ساعت تابستانی معتبر در زمان ثبت نخستین تصویر فهرست: .PP \fBenv TZ=Europe/Rome gpscorrelate \-g Test\&.gpx *\&.jpg\fR .PP تطبیق تمام عکس‌های یک پوشه از مسیری که در دو فایل GPX مجزا پخش شده و در منطقه زمانی فعلی رایانه گرفته شده‌اند؛ همراه با درونیابی میان قطعات و بین فایل‌ها در عین صرف‌نظر از عکس‌های با فاصله زیاد از نقطه ثبت‌شده، بدون تغییر برچسب زمانی فایل‌ها، و با نمایش جزئیات کامل فرآیند: .PP \fBgpscorrelate \-g track1\&.gpx \-g track2\&.gpx \-m 120 \-t \-M \-v *\&.jpg\fR .PP تطبیق عکس‌های گرفته‌شده با دوربین داشبورد، همراه با افزودن برچسب‌های جهت از فایل GPX: .PP \fBgpscorrelate \-\-heading \-\-max\-heading 90 \-\-direction 0 \-g Test\&.gpx *\&.jpg\fR .PP تطبیق مجموعه‌ای از عکس‌های گرفته‌شده با دوربینی که مستقیماً به سمت شیشه سمت راست خودرو نشانه رفته است (۹۰ درجه زاویه نسبت به جلو)، با استفاده از فایل GPX دارای برچسب‌های جهت، صرف‌نظر از برچسب‌گذاری جهت در پیچ‌های تند و حذف تمام برچسب‌ها در صورت قطع سیگنال GPS برای بیش از ۶ ثانیه (جهت جلوگیری از ثبت مقادیر نادرست): .PP \fBgpscorrelate \-g car_trip\&.gpx \-\-heading \-\-max\-heading 45 \-\-direction 90 \-\-max\-dist 6 \-\-ignore\-tracksegs *\&.jpg\fR .PP تطبیق عکسی ثبت‌شده با دوربینی با ساعت جلوتر (ساعت ۷۷.۵ ثانیه جلوتر از زمان GPS بوده است) و برچسب‌های منطقه زمانی اشتباه: .PP \fBgpscorrelate \-g Test\&.gpx \-O \-77\&.5 \-\-no\-photo\-tz photo\&.jpg\fR .PP نمایش برچسب‌های موجود GPS در یک عکس: .PP \fBgpscorrelate \-\-show photo\&.jpg\fR .PP نمایش برچسب‌های موجود GPS در عکس و خروجی در قالب CSV: .PP \fBgpscorrelate \-\-show \-\-machine photo\&.jpg\fR .PP ایجاد یک مسیر GPX از مجموعه‌ای از عکس‌های گرفته‌شده در زمستان در بریتانیا که دارای برچسب GPS هستند (مانند عکس‌های گوشی)، جهت استفاده در تطبیق عکس‌های دوربینی دیگر در همان نزدیکی: .PP \fBgpscorrelate \-\-show\-gpx \-z 0 IMG*\&.JPG\fR .PP حذف برچسب‌های GPS از عکس‌ها: .PP \fBgpscorrelate \-\-remove *\&.jpg\fR .PP افزودن برچسب موقعیت GPS به عکسی ثبت‌شده رو به سمت جنوب‌شرقی در کلیسای اولم: .PP \fBgpscorrelate \-l 48\&.398620,9\&.991417,522 \-\-direction 135 \-z 2 ulm\&.jpg\fR .SH "وضعیت خروج (EXIT STATUS)" .PP دستور \fBgpscorrelate\fR در صورت موفقیت مقدار \fB0\fR، در صورت بروز خطای عمده (مانند خطای خواندن یا نوشتن) مقدار \fB1\fR و در صورت خطای جزئی (مانند پوشش ندادن زمان تصویر توسط مسیر GPS داده‌شده) مقدار \fB2\fR را برمی‌گرداند. .SH "همچنین ببینید (SEE ALSO)" .PP \fBgpsd\fR(1), \fBgpsbabel\fR(1), \fBgpxlogger\fR(1), \fBcgpxlogger\fR(1)\&. .PP مستندات کامل نرم‌افزار gpscorrelate در قالب HTML در مسیر زیر بر روی فایل‌سیستم در دسترس است: /usr/share/doc/gpscorrelate\&. .SH "مجوز (LICENSE)" .PP این صفحه راهنما در ابتدا توسط Stefano Zacchiroli برای سیستم Debian(TM) نگاشته شد. سپس توسط Till Maas و Dan Fandrich گسترش یافت. حق تکثیر، توزیع و/یا تغییر این سند تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License)، نسخه ۲ یا هر نسخه پس از آن منتشرشده توسط بنیاد نرم‌افزارهای آزاد مجاز است. .SH "نویسندگان (AUTHORS)" .PP \fBStefano Zacchiroli\fR .RS 4 نویسنده اصلی. .RE .SH "حق نشر (COPYRIGHT)" .br حق نشر \(co 2006-2025 متعلق به Stefano Zacchiroli ، Till Maas، Dan Fandrich .br