.\" 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 "PROJ" "1" "10 avril 2026" "9.8" "PROJ"
.SH "نام (NAME)"
proj \- فیلتر تصویرسازی کارتوگرافی
.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
\fBproj\fP [\fB\-beEfiIlmorsStTvVwW\fP] [args]] ([\fI+opt[=arg]\fP ...] | {crs}) file ...
.sp
\fBinvproj\fP [\fB\-beEfiIlmorsStTvVwW\fP] [args]] ([\fI+opt[=arg]\fP ...] | {crs}) file ...
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه‌های proj و invproj به ترتیب تبدیل مستقیم و معکوس داده‌های نقشه‌نگاری به داده‌های دکارتی یا برعکس را با طیف گسترده‌ای از توابع تصویر قابل انتخاب انجام می‌دهند.
.sp
دستور invproj ممکن است در همه پلتفرم‌ها در دسترس نباشد؛ در این حالت به جای آن از \fBproj \-I\fP استفاده کنید.
.sp
پارامترهای کنترلی زیر می‌توانند با هر ترتیبی ظاهر شوند:
.INDENT 0.0
.TP
.B \-b
گزینه ویژه برای ورود و خروج باینری داده‌های مختصات از طریق ورودی استاندارد و خروجی استاندارد. فرض بر این است که داده‌ها از نوع کلمات ممیز شناور با دقت مضاعف (double) سیستم هستند. این گزینه زمانی استفاده می‌شود که proj به عنوان یک فرایند فرزند اجرا شده باشد و امکان دور زدن عملیات قالب‌بندی را فراهم می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-d <n>
.UNINDENT
.sp
در نسخه 5.2.0 اضافه شد: تعیین تعداد ارقام اعشار برای گرد کردن در خروجی.

.INDENT 0.0
.TP
.B \-i
تنها ورودی باینری را انتخاب می‌کند (رجوع کنید به \fB\-b\fP).
.UNINDENT
.INDENT 0.0
.TP
.B \-I
روشی جایگزین برای تعیین تصویر معکوس. هنگام استفاده همراه با invproj\& نیازی به آن نیست و تکراری است.
.UNINDENT
.INDENT 0.0
.TP
.B \-o
تنها خروجی باینری را انتخاب می‌کند (رجوع کنید به \fB\-b\fP).
.UNINDENT
.INDENT 0.0
.TP
.B \-t<a>
که در آن \fIa\fP نویسه‌ای را مشخص می‌کند که به عنوان اولین نویسه برای نشان دادن یک خط کنترلی به کار می‌رود تا بدون پردازش عبور داده شود. این گزینه فقط برای ورودی ASCII کاربرد دارد (# مقدار پیش‌فرض است).
.UNINDENT
.INDENT 0.0
.TP
.B \-e <string>
که در آن \fIstring\fP یک رشته دلخواه است تا در صورت تشخیص خطا حین تبدیل داده‌ها در خروجی چاپ شود. مقدار پیش‌فرض یک رشته سه نویسه‌ای است: \fB*\et*\fP\&. توجه داشته باشید که در صورت استفاده از گزینه‌های \fB\-b\fP، \fB\-i\fP یا \fB\-o\fP، خطا برای هر دو مقدار بازگشتی به صورت مقدار HUGE_VAL برگردانده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-E
باعث می‌شود مختصات ورودی پیش از چاپ مقادیر تبدیل‌شده، در خط خروجی کپی شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-l<[=id]>
فهرست کردن شناسه‌های تصویری که می‌توان با \fI+proj\fP انتخاب کرد. دستور \fBproj \-l=id\fP توضیح بسط‌یافته شناسه تصویر \fIid\fP را نمایش می‌دهد؛ به عنوان مثال \fBproj \-l=merc\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-lp
فهرست تمام شناسه‌های تصویری که می‌توان با پارامتر \fI+proj\fP استفاده کرد. معادل با \fBproj \-l\fP\& است.
.UNINDENT
.INDENT 0.0
.TP
.B \-lP
توضیح بسط‌یافته از تمام تصویرهایی که می‌توان همراه با پارامتر \fI+proj\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 \-r
این گزینه ترتیب ورودی مورد انتظار را از طول‌جغرافیایی\-عرض‌جغرافیایی یا x\-y به عرض‌جغرافیایی\-طول‌جغرافیایی یا y\-x معکوس می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-s
این گزینه ترتیب خروجی را از x\-y یا طول‌جغرافیایی\-عرض‌جغرافیایی به y\-x یا عرض‌جغرافیایی\-طول‌جغرافیایی معکوس می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-S
باعث می‌شود برآورد ضرایب مقیاس نصف‌النهاری و مداری، ضریب مقیاس مساحت و اعوجاج زاویه‌ای، و حداکثر و حداقل ضرایب مقیاس برای هر نقطه ورودی بین <> فهرست شوند. در تصویرهای همدیس (هم‌شکل)، ضرایب مقیاس نصف‌النهاری و مداری برابر بوده و اعوجاج زاویه‌ای صفر خواهد بود. تصویرهای هم‌مساحت دارای ضریب مساحت ۱ خواهند بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-m <mult>
داده‌های دکارتی ممکن است با پارامتر \fImult\fP مقیاس‌بندی شوند. هنگام پردازش داده‌ها در حالت تصویر مستقیم، مقادیر خروجی دکارتی در \fImult\fP ضرب می‌شوند، در غیر این صورت مقادیر ورودی دکارتی قبل از تصویر معکوس بر \fImult\fP تقسیم می‌شوند. اگر دو نویسه اول \fImult\fP برابر 1/ یا 1: باشند، مقدار معکوس \fImult\fP به کار گرفته می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-f <format>
که در آن \fIformat\fP یک رشته قالب‌بندی printf برای کنترل شکل مقادیر خروجی است. برای تصویرهای معکوس، در صورت استفاده از این گزینه، خروجی به درجه خواهد بود. قالب پیش‌فرض برای تصویر مستقیم \fB\(dq%.2f\(dq\fP و برای تصویر معکوس DMS است.
.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 \-v
باعث می‌شود پیش از داده‌های ورودی، فهرستی از پارامترهای کنترلی نقشه‌نگاری که توسط برنامه بررسی و استفاده شده‌اند چاپ شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-V
این گزینه باعث نمایش فهرستی تشریحی و بسط‌یافته از ویژگی‌های نقطه تصویرشده می‌شود. گزینه \fB\-v\fP همراه با این گزینه لحاظ می‌شود.
.UNINDENT
.sp
آرگومان‌های خط فرمان \fI+opt\fP با پارامترهای نقشه‌نگاری مرتبط هستند. پارامترهای کنترلی اضافی تصویر می‌توانند در دو فایل کنترلی کمکی قرار گیرند: فایل اول اختیاری است و با \fI+init=file:id\fP ارجاع داده می‌شود، و دومی همیشه پس از مشخص شدن نام تصویر از طریق خط فرمان یا محتویات فایل +init پردازش می‌شود. متغیر محیطی \fBPROJ_DATA\fP \%<#\:envvar-PROJ_DATA> دایرکتوری پیش‌فرض را برای فایل‌های ارجاع‌شده بدون مسیر مطلق تعیین می‌کند. این متغیر همچنین برای فایل‌های پشتیبان مانند فایل‌های انتقال مبنا (datum shift) استفاده می‌شود.
.sp
در نسخه 9.3.0 اضافه شد: مقدار \fI{crs}\fP یکی از حالت‌های پذیرفته‌شده توسط :c:\fBproj_create()\fP است، به شرط آنکه یک CRS تصویرشده را مشخص کند؛ مانند یک رشته WKT، یک کد شیء (مانند \(dqEPSG:32632\(dq)، یک رشته PROJJSON و غیره.
تصویر محاسبه‌شده همان تصویر نقشه‌ای خواهد بود که از تبدیل CRS جغرافیایی پایه CRS تصویرشده به خود CRS تصویرشده حاصل می‌شود.
.sp
یک یا چند فایل (که به ترتیب از چپ به راست پردازش می‌شوند) منبع داده‌هایی را که باید تبدیل شوند مشخص می‌کنند. علامت \fB\-\fP موقعیت پردازش ورودی استاندارد را مشخص می‌کند. اگر هیچ فایلی تعیین نشود، فرض می‌شود ورودی از stdin دریافت می‌شود.
برای داده‌های ورودی ASCII، دو مقدار داده باید در دو فیلد اول که با فاصله خالی جدا شده‌اند قرار گیرند، و زمانی که هم ورودی و هم خروجی ASCII باشند، تمام بخش‌های انتهایی خط ورودی به انتهای خط خروجی افزوده می‌شوند.
.sp
داده‌های جغرافیایی ورودی (طول و عرض جغرافیایی) باید در قالب DMS یا درجات اعشاری باشند و داده‌های دکارتی ورودی باید واحدهایی سازگار با واحدهای نیم‌قطر بزرگ بیضوی یا شعاع کره داشته باشند. مختصات جغرافیایی خروجی در قالب DMS خواهد بود (اگر از سوییچ \fB\-w\fP استفاده نشده باشد) و با دقت 0.001\(dq همراه با حذف فیلدهای دقیقه و ثانیه صفر در انتها نمایش داده می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.sp
اسکریپت زیر
.INDENT 0.0
.INDENT 3.5
.sp
.EX
proj +proj=utm +zone=12 \-r <<EOF
45d15\(aq33.1\(dq 111.5W
45d15.551666667N \-111d30
+45.25919444444 111d30\(aq000w
EOF
.EE
.UNINDENT
.UNINDENT
.sp
تصویر مستقیم در زون 12 سامانه UTM را انجام می‌دهد.
از آنجا که هیچ +ellps مشخص نشده است، مقدار پیش‌فرض +ellps=GRS80 استفاده می‌شود.
مقادیر جغرافیایی این مثال هم‌ارز یکدیگر بوده و به عنوان نمونه‌هایی از انواع اَشکال ورودی DMS آورده شده‌اند. داده‌های خروجی x\-y به صورت سه خط زیر ظاهر خواهند شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
460770.43     5011865.86
.EE
.UNINDENT
.UNINDENT
.sp
مثال دیگر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
proj EPSG:6421 \-V <<EOF
\-120 35.8
EOF
.EE
.UNINDENT
.UNINDENT
.sp
تصویر مختصات را در \(dqNAD83(2011) / California zone 4\(dq (\fIEPSG:6421\fP) به سیستم جغرافیایی آن، \(dqNAD83(2011)\(dq، همراه با نمایش فهرست تفصیلی حاشیه‌نویسی‌شده انجام می‌دهد.
خروجی به صورت زیر نمایش داده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
#Lambert Conformal Conic
#   Conic, Sph&Ell
#   lat_1= and lat_2= or lat_0, k_0=
# +proj=lcc +lat_0=35.3333333333333 +lon_0=\-119 +lat_1=37.25 +lat_2=36
# +x_0=2000000 +y_0=500000 +ellps=GRS80
#Final Earth figure: ellipsoid
#  Major axis (a): 6378137.000
#  1/flattening: 298.257222
#  squared eccentricity: 0.006694380023
Longitude: 120dW [ \-120 ]
Latitude:  35d48\(aqN [ 35.8 ]
Easting (x):   1909606.87
Northing (y):  552253.58
Meridian scale (h) : 1.00004382  ( 0.004382 % error )
Parallel scale (k) : 1.00004382  ( 0.004382 % error )
Areal scale (s):     1.00008765  ( 0.008765 % error )
Angular distortion (w): 0.000
Meridian/Parallel angle: 90.00000
Convergence : \-0d35\(aq47.714\(dq [ \-0.59658715 ]
Max\-min (Tissot axis a\-b) scale error: 1.00004 1.00004
.EE
.UNINDENT
.UNINDENT
.SH "سایر برنامه‌ها (OTHER PROGRAMS)"
.sp
برنامه proj به تبدیل بین مختصات جغرافیایی و تصویرشده درون یک مبنا (datum) واحد محدود است.
.sp
برنامه cs2cs \%<#\:cs2cs> عملکردی مشابه دارد، اما امکان تبدیل بین هر جفت سامانه مرجع مختصات قابل تعریف را فراهم می‌کند، از جمله پشتیبانی از تبدیل مبنا (datum).
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(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 "نویسندگان (AUTHORS)"
Gerald I. Evenden
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1983-2026, مشارکت‌کنندگان PROJ
.\" End of generated man page.