.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GEOD" "1" "10 avril 2026" "9.8" "PROJ"
.SH "نام (NAME)"
geod \- محاسبات ژئودزیک مسافت مستقیم و معکوس
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
\fBgeod\fP \fI+ellps=<ellipsoid>\fP [\fB\-afFIlptwW\fP [args]] [\fI+opt[=arg]\fP ...] file ...
.sp
\fBinvgeod\fP \fI+ellps=<ellipsoid>\fP [\fB\-afFIlptwW\fP [args]] [\fI+opt[=arg]\fP ...] file ...
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستورات geod (مستقیم) و invgeod (معکوس) محاسبات ژئودزیک (دایره عظیمه) را برای تعیین عرض جغرافیایی، طول جغرافیایی و آزیموت برگشتی یک نقطه مقصد بر اساس عرض جغرافیایی، طول جغرافیایی، آزیموت و فاصله نقطه آغازین (مستقیم) یا محاسبه آزیموت‌های رفت و برگشت و فاصله بین عرض‌ها و طول‌های جغرافیایی نقطه آغازین و مقصد (معکوس) انجام می‌دهند.
نتایج برای
.RI | f | < 1/50
تا حد خطای گرد کردن دقیق هستند، که در آن
.I f
میزان پَخی (Flattening) است.
.sp
ممکن است
.B invgeod
روی تمام پلتفرم‌ها در دسترس نباشد؛ در این حالت از
.B geod \-I
استفاده کنید.
.sp
گزینه‌های خط فرمان زیر می‌توانند به هر ترتیبی مشخص شوند:
.SH "گزینه‌ها (OPTIONS)"
.INDENT 0.0
.TP
.B \-I
مشخص می‌کند که محاسبات ژئودزیک معکوس انجام شود. می‌توان هنگام اجرای geod به عنوان جایگزینی برای اجرای invgeod استفاده کرد.
.UNINDENT
.INDENT 0.0
.TP
.B \-a
عرض و طول جغرافیایی نقاط آغازین و مقصد، آزیموت‌های رفت و برگشت و فاصله در خروجی نمایش داده می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-t<a>
که در آن \fIa\fP نویسه‌ای را مشخص می‌کند که به عنوان نخستین نویسه برای تعیین یک خط کنترلی به کار می‌رود تا بدون پردازش عبور داده شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-le
فهرستی از تمام بیضوی‌هایی که می‌توان با گزینه \fI+ellps=\fP انتخاب کرد ارائه می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-lu
فهرستی از تمام واحدهایی که می‌توان با گزینه \fI+units=\fP انتخاب کرد ارائه می‌دهد (واحد پیش‌فرض متر است).
.UNINDENT
.INDENT 0.0
.TP
.B \-f <format>
که در آن \fIformat\fP یک رشته قالب‌بندی printf برای کنترل قالب خروجی مقادیر مختصات جغرافیایی و آزیموت است. حالت پیش‌فرض DMS است.
.UNINDENT
.INDENT 0.0
.TP
.B \-F <format>
که در آن \fIformat\fP یک رشته قالب‌بندی printf برای کنترل قالب خروجی مقدار فاصله است. حالت پیش‌فرض \fB\(dq%.3f\(dq\fP است.
.UNINDENT
.INDENT 0.0
.TP
.B \-w<n>
که در آن \fIn\fP تعداد ارقام اعشاری معنادار برای خروجی ثانیه‌ها است (در صورت عدم تعیین گزینه، \fB\-w3\fP فرض می‌شود).
.UNINDENT
.INDENT 0.0
.TP
.B \-W<n>
که در آن \fIn\fP تعداد ارقام اعشاری معنادار برای خروجی ثانیه‌ها است. هنگام استفاده از \fB\-W\fP فیلدها عرض ثابت داشته و با صفرهای ابتدایی پر می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-p
این گزینه موجب می‌شود مقادیر آزیموت به عنوان اعداد نامنفی DMS بین ۰ تا ۳۶۰ درجه خروجی داده شوند. همچنین گزینه \fB\-f\fP را ببینید.
.UNINDENT
.sp
گزینه‌های خط فرمان \fI+opt\fP با پارامترهای ژئودتیک برای تعیین بیضوی یا کره مورد استفاده مرتبط هستند. گزینه‌ها به ترتیب از چپ به راست خط فرمان پردازش می‌شوند. تکرار یک گزینه نادیده گرفته شده و اولین رخداد به عنوان مقدار مورد نظر در نظر گرفته می‌شود.
.sp
برای فهرست کامل این پارامترها و کنترل‌ها به مستندات PROJ مراجعه کنید.
.sp
یک یا چند فایل (پردازش‌شده به ترتیب چپ به راست) منبع داده‌هایی را که باید تبدیل شوند مشخص می‌کنند. علامت \fB\-\fP ورودی استاندارد را مشخص می‌کند. اگر فایلی تعیین نشود، ورودی از stdin خوانده می‌شود.
.sp
برای محاسبات مستقیم، داده‌های ورودی باید به ترتیب عرض جغرافیایی، طول جغرافیایی، آزیموت و فاصله باشند و خروجی شامل عرض جغرافیایی، طول جغرافیایی و آزیموت برگشتی نقطه مقصد خواهد بود. در حالت معکوس، عرض و طول جغرافیایی نقطه آغازین و مقصد ورودی بوده و آزیموت رفت و برگشت متناظر از نقاط آغازین و مقصد همراه با فاصله بین نقاط در خروجی درج می‌شوند.
.sp
مختصات جغرافیایی ورودی (عرض و طول جغرافیایی) و داده‌های آزیموت باید به صورت درجه اعشاری یا قالب DMS باشند و داده‌های فاصله ورودی باید در واحدهای سازگار با نیم‌قطر بزرگ بیضوی یا شعاع کره باشند. عرض جغرافیایی باید در بازه [\-90d,90d] باشد. مختصات جغرافیایی و آزیموت‌های خروجی در قالب DMS (در صورت عدم استفاده از سوییچ \fB\-f\fP) تا دقت \(dq0.001 با حذف فیلدهای دقیقه و ثانیه صفر پایانی خواهند بود. داده‌های فاصله خروجی در همان واحدهای بیضوی یا شعاع کره خواهند بود.
.sp
شکل بیضوی زمین را می‌توان به همان شیوه برنامه proj با استفاده از \fI+ellps=\fP، \fI+a=\fP، \fI+es=\fP و غیره انتخاب کرد.
.sp
دستور geod همچنین می‌تواند برای تعیین نقاط میانی در امتداد یک خط ژئودزیک بین دو نقطه یا در امتداد کمانی با فاصله مشخص از یک نقطه جغرافیایی استفاده شود. در هر دو حالت باید نقطه آغازین با پارامترهای \fI+lat_1=lat\fP و \fI+lon_1=long\fP مشخص شده و یا نقطه مقصد با \fI+lat_2=lat\fP و \fI+lon_2=long\fP یا فاصله و آزیموت از نقطه آغازین با \fI+S=distance\fP و \fI+A=azimuth\fP تعیین شود.
.sp
اگر نقاط در امتداد یک خط ژئودزیک تعیین می‌شوند، باید \fI+n_S=integer\fP مشخص‌کننده تعداد نقاط میانی و/یا \fI+del_S=distance\fP مشخص‌کننده فاصله افزایشی بین نقاط تعیین گردد.
.sp
برای تعیین نقاط در امتداد کمانی با فاصله مساوی از نقطه آغازین، هر دو پارامتر \fI+del_A=angle\fP و \fI+n_A=integer\fP باید مشخص شوند که به ترتیب گام‌های زاویه‌ای و تعداد نقاط مورد نظر را تعیین می‌کنند.
.SH "مثال‌ها (EXAMPLES)"
.sp
اسکریپت زیر آزیموت‌های ژئودزیک و فاصله را بر حسب مایل قانونی ایالات متحده از بوستون، MA به پورتلند، OR محاسبه می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
geod +ellps=clrk66 \-I +units=us\-mi <<EOF
42d15\(aqN 71d07\(aqW 45d31\(aqN 123d41\(aqW
EOF
.EE
.UNINDENT
.UNINDENT
.sp
که نتایج زیر را ارائه می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\-66d31\(aq50.141\(dq 75d39\(aq13.083\(dq 2587.504
.EE
.UNINDENT
.UNINDENT
.sp
که در آن دو مقدار نخست آزیموت از بوستون به پورتلند و آزیموت برگشتی از پورتلند به بوستون بوده و به دنبال آن مقدار فاصله آمده است.
.sp
یک نمونه از کاربرد مستقیم (forward) ژئودزیک، استفاده از موقعیت بوستون و محاسبه موقعیت پورتلند بر اساس آزیموت و فاصله است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
geod +ellps=clrk66 +units=us\-mi <<EOF
42d15\(aqN 71d07\(aqW \-66d31\(aq50.141\(dq 2587.504
EOF
.EE
.UNINDENT
.UNINDENT
.sp
که نتیجه می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
45d31\(aq0.003\(dqN 123d40\(aq59.985\(dqW 75d39\(aq13.094\(dq
.EE
.UNINDENT
.UNINDENT
.sp
یعنی عرض و طول جغرافیایی پورتلند و آزیموت برگشتی از پورتلند به بوستون.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
عدم دقت کافی در مقدار فاصله، دقت موقعیت پورتلند را تحت تأثیر قرار می‌دهد.
.UNINDENT
.UNINDENT
.SH "مطالعه بیشتر (FURTHER READING)"
.INDENT 0.0
.IP 1. 3
کتابخانه GeographicLib \%<https://\:geographiclib\:.sourceforge\:.io>\&.
.IP 2. 3
چارلز اف. اف. کارنی، الگوریتم‌های ژئودزیک \%<https://\:doi\:.org/\:10\:.1007/\:s00190-012-0578-z>، مجله ژئودزی \fB87\fP(1)، ۴۳–۵۵ (۲۰۱۳)؛
ضمائم \%<https://\:geographiclib\:.sourceforge\:.io/\:geod-addenda\:.html>\&.
.IP 3. 3
کتاب‌شناسی ژئودزیک \%<https://\:geographiclib\:.sourceforge\:.io/\:geodesic-papers/\:biblio\:.html>\&.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBproj(1)\fP, \fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgie(1)\fP, \fBprojinfo(1)\fP, \fBprojsync(1)\fP
.SH "اشکالات (BUGS)"
.sp
فهرست اشکالات شناخته‌شده در نشانی زیر در دسترس است:
\%<https://\:github\:.com/\:OSGeo/\:PROJ/\:issues>
که گزارش اشکالات جدید را نیز می‌توان در آن ارسال کرد.
.SH "صفحه خانگی (HOME PAGE)"
.sp
\%<https://\:proj\:.org>
.SH "نویسنده (AUTHOR)"
Charles Karney
.SH "حق نشر (COPYRIGHT)"
1983-2026, PROJ contributors
.\" End of generated man page.