.\" 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 "CS2CS" "1" "10 avril 2026" "9.8" "PROJ" .SH "نام (NAME)" cs2cs \- تبدیل و بازپروجکشن دستگاه‌های مختصات جغرافیایی و نقشه‌نگاری .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .nf \fBcs2cs\fP [\fB\-eEfIlrstvwW\fP [args]] .in +2 [[\-\-area ] | [\-\-bbox ]] [\-\-authority ] [\-\-3d] [\-\-accuracy ] [\-\-only\-best[=yes|=no]] [\-\-no\-ballpark] [\-\-s_epoch {epoch}] [\-\-t_epoch {epoch}] ([\fI+opt[=arg]\fP ...] [+to \fI+opt[=arg]\fP ...] | {source_crs} {target_crs}) file ... .in -2 .fi .sp .sp جایی که {source_crs} یا {target_crs} یکی از موارد پذیرفته‌شده توسط \fBproj_create()\fP \%<#\:c\:.proj_create> است، به شرطی که بیانگر یک سامانه مختصات مرجع (CRS) باشد: .INDENT 0.0 .IP \(bu 2 یک رشته پروژکشن (proj\-string)، .IP \(bu 2 یک رشته WKT، .IP \(bu 2 یک کد شیء (مانند \(dqEPSG:4326\(dq، \(dqurn:ogc:def:crs:EPSG::4326\(dq، \(dqurn:ogc:def:coordinateOperation:EPSG::1671\(dq)، .IP \(bu 2 یک نام شیء؛ برای مثال \(dqWGS 84\(dq، \(dqWGS 84 / UTM zone 31N\(dq. در این حالت از آنجا که یکتا بودن تضمین نمی‌شود، روش‌های اکتشافی (heuristics) برای تعیین مناسب‌ترین تطابق اعمال می‌شوند. .IP \(bu 2 یک نام CRS و مبدا مختصات زمانی (epoch)، که با \(aq@\(aq جدا شده‌اند؛ مانند \(dq\%\(dq (\fIاضافه‌شده در نگارش 9.2\fP). .IP \(bu 2 یک OGC URN ترکیبی از مراجع برای سامانه‌های مختصات مرجع مرکب (compound CRS) (مانند \(dq\%\(dq یا نحو اختصاری سفارشی \(dqEPSG:2393+5717\(dq)، .IP \(bu 2 یک OGC URN ترکیبی از مراجع برای CRSهای تصویری یا مشتق‌شده برای مثال برای CRS سه‌بعدی تصویری \(dqUTM zone 31N / WGS 84 (3D)\(dq: \(dq\%\(dq (\fIاضافه‌شده در نگارش 6.2\fP). .IP \(bu 2 یک OGC URN ترکیبی از مراجع برای عملیات‌های متوالی (concatenated operations) (مانند \(dq\%\(dq). .IP \(bu 2 یک رشته PROJJSON؛ اسکیما در \% در دسترس است (\fIاضافه‌شده در نگارش 6.2\fP). .IP \(bu 2 یک CRS مرکب ساخته‌شده از دو نام شیء که با \(dq + \(dq از هم جدا شده‌اند؛ مانند \(dqWGS 84 + EGM96 height\(dq (\fIاضافه‌شده در نگارش 7.1\fP). .UNINDENT .sp اضافه‌شده در نگارش 6.0.0. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 پیش از نسخه 7.0.1، هنگام افزودن نام فایل لازم بود عبارت +to میان {source_crs} و {target_crs} قرار گیرد. .UNINDENT .UNINDENT .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور cs2cs تبدیل میان سامانه مختصات مرجع (CRS) نقشه‌نگاری مبدا و مقصد را روی مجموعه‌ای از نقاط ورودی انجام می‌دهد. تبدیل سامانه مختصات مرجع می‌تواند شامل تبدیل میان مختصات تصویری و جغرافیایی و همچنین اعمال تغییر مبنا (datum shift) باشد. .sp پارامترهای کنترلی زیر می‌توانند به هر ترتیبی ظاهر شوند: .INDENT 0.0 .TP .B \-I انجام تبدیل معکوس؛ یعنی از CRS مقصد به CRS مبدا. .UNINDENT .INDENT 0.0 .TP .B \-t که در آن \fIa\fP نویسه‌ای را مشخص می‌کند که به‌عنوان اولین نویسه برای نشان دادن خط کنترلی به کار می‌رود تا بدون پردازش عبور داده شود. این گزینه فقط برای ورودی‌های ASCII کاربرد دارد (مقدار پیش‌فرض # است). .UNINDENT .INDENT 0.0 .TP .B \-d اضافه‌شده در نگارش 5.2.0. .sp تعداد ارقام اعشار را برای گرد کردن در خروجی مشخص می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-e که در آن \fIstring\fP یک رشته دلخواه است که در صورت تشخیص خطا هنگام تبدیل داده‌ها در خروجی چاپ می‌شود. مقدار پیش‌فرض یک رشته سه نویسه‌ای است: \fB*\et*\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-E باعث می‌شود مختصات ورودی پیش از چاپ مقادیر تبدیل‌شده، در خط خروجی کپی شوند. .UNINDENT .INDENT 0.0 .TP .B \-l<[=id]> فهرست شناسه‌های تصویری را که می‌توان با \fI+proj\fP انتخاب کرد، نمایش می‌دهد. دستور \fBcs2cs \-l=id\fP توضیحات کامل‌تری از شناسه تصویر \fIid\fP ارائه می‌دهد؛ مانند \fBcs2cs \-l=merc\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-lp فهرست تمام شناسه‌های تصویری که می‌توان با پارامتر \fI+proj\fP استفاده کرد. معادل با \fBcs2cs \-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 \-lm فهرست نصف‌النهارهای مبدأ پیش‌فرض که می‌توان با پارامتر \fI+pm\fP انتخاب کرد. توجه داشته باشید که این فهرست دیگر به‌روزرسانی نمی‌شود و ممکن است برخی مقادیر با سایر منابع مغایرت داشته باشند. .UNINDENT .INDENT 0.0 .TP .B \-lu فهرست تمام واحدهای فاصله که می‌توان با پارامتر \fI+units\fP انتخاب کرد. .UNINDENT .INDENT 0.0 .TP .B \-r این گزینه ترتیب دو ورودی مورد انتظار اول را از آنچه توسط CRS مشخص شده به ترتیب معکوس تغییر می‌دهد. مختصات سوم (معمولاً ارتفاع) در جایگاه سوم باقی می‌ماند. .UNINDENT .INDENT 0.0 .TP .B \-s این گزینه ترتیب دو خروجی مورد انتظار اول را از آنچه توسط CRS مشخص شده به ترتیب معکوس تغییر می‌دهد. مختصات سوم (معمولاً ارتفاع) در جایگاه سوم باقی می‌ماند. .UNINDENT .INDENT 0.0 .TP .B \-f که در آن \fIformat\fP یک رشته قالب‌بندی printf برای کنترل شکل مقادیر خروجی است. در تبدیلات معکوس، در صورت استفاده از این گزینه، خروجی برحسب درجه خواهد بود. اگر قالبی برای تبدیل معکوس مشخص شود، داده‌های خروجی برحسب درجه اعشاری خواهند بود. قالب پیش‌فرض برای تبدیل مستقیم \fB\(dq%.2f\(dq\fP و برای تبدیل معکوس DMS (درجه، دقیقه، ثانیه) است. .UNINDENT .INDENT 0.0 .TP .B \-w که در آن \fIn\fP تعداد ارقام اعشار بااهمیت برای خروجی ثانیه است (در صورت مشخص نشدن این گزینه، \fB\-w3\fP در نظر گرفته می‌شود). .UNINDENT .INDENT 0.0 .TP .B \-W که در آن \fIn\fP تعداد ارقام اعشار بااهمیت برای خروجی ثانیه است. هنگامی که \fB\-W\fP استفاده می‌شود، فیلدها با صفرهای ابتدایی دارای عرض ثابت خواهند بود. محدوده معتبر: \-W0 تا \-W8. .UNINDENT .INDENT 0.0 .TP .B \-v باعث می‌شود فهرستی از پارامترهای کنترلی نقشه‌نگاری آزموده‌شده و استفاده‌شده توسط برنامه پیش از داده‌های ورودی چاپ شود. .UNINDENT .INDENT 0.0 .TP .B \-\-area اضافه‌شده در نگارش 8.0.0. .sp محدوده جغرافیایی مورد نظر را برای محدود کردن نتایج هنگام جستجوی عملیات‌های مختصات میان دو CRS مشخص می‌کند. محدوده مورد نظر را می‌توان با نام (مانند \(dqDenmark \- onshore\(dq) یا به‌صورت AUTHORITY:CODE (مانند EPSG:3237) مشخص کرد. .sp این گزینه با \fB\-\-bbox\fP مانعة‌الجمع است. .UNINDENT .INDENT 0.0 .TP .B \-\-bbox اضافه‌شده در نگارش 8.0.0. .sp محدوده جغرافیایی مورد نظر را برای محدود کردن نتایج هنگام جستجوی عملیات‌های مختصات میان دو CRS مشخص می‌کند. محدوده به صورت یک کادر محصورکننده (bounding box) با مختصات جغرافیایی، برحسب درجه در یک CRS جغرافیایی نامشخص تعیین می‌شود. \fIwest_long\fP و \fIeast_long\fP باید در بازه [\-180,180] و \fIsouth_lat\fP و \fInorth_lat\fP در بازه [\-90,90] باشند. مقدار \fIwest_long\fP معمولاً کمتر از \fIeast_long\fP است، مگر در حالتی که محدوده مورد نظر از نصف‌النهار ۱۸۰ درجه (antimeridian) عبور کند. .UNINDENT .INDENT 0.0 .TP .B \-\-only\-best[=yes|=no] اضافه‌شده در نگارش 9.2.0. .sp برنامه \fIcs2cs\fP را ملزم می‌کند که فقط از بهترین تبدیل شناخته‌شده توسط PROJ استفاده کند. در صورتی که گرید مورد نیاز برای بهترین تبدیل وجود نداشته باشد، \fIcs2cs\fP یک خطا بازمی‌گرداند. .sp منظور از «بهترین تبدیل»، دقیق‌ترین تبدیل موجود در میان تمام تبدیلات مرتبط برای نقطه مورد نظر است، در صورتی که تمام شبکه‌ها (گریدها)ی شناخته‌شده مورد نیاز برای انجام چنین تبدیلی در دسترس باشند (به‌صورت محلی یا از طریق شبکه). .sp توجه داشته باشید که مقدار پیش‌فرض این گزینه را می‌توان با متغیر محیطی \fBPROJ_ONLY_BEST_DEFAULT\fP یا با تنظیم \fBonly_best_default\fP در فایل proj.ini \%<#\:proj-ini> نیز تعیین کرد (در صورت مشخص شدن \fB\-\-only\-best\fP، مقدار پیش‌فرض بازنویسی می‌شود). .UNINDENT .INDENT 0.0 .TP .B \-\-no\-ballpark اضافه‌شده در نگارش 8.0.0. .sp هرگونه عملیات مختصات را که یک تبدیل تقریبی (Ballpark transformation \%<#\:term-Ballpark-transformation>) باشد یا شامل آن گردد، غیرمجاز می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-accuracy اضافه‌شده در نگارش 8.0.0. .sp حداقل دقت مورد نظر را برای عملیات‌های مختصات کاندید تعیین می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-authority اضافه‌شده در نگارش 8.0.0. .sp این گزینه می‌تواند برای محدود کردن مرجع صادرکننده (authority) عملیات‌های مختصات جستجوشده در پایگاه‌داده به کار رود. در صورت مشخص نشدن، عملیات‌های مختصات از هر مرجعی جستجو خواهند شد، با محدودیت‌های تعیین‌شده در جدول پایگاه‌داده \fBauthority_to_authority_preference\fP مرتبط با مرجع خود CRSهای مبدا/مقصد. اگر مرجع روی \fBany\fP تنظیم شود، عملیات‌های مختصات از هر مرجعی جستجو می‌شوند. اگر مرجع یک رشته غیرخالی متفاوت از \fBany\fP باشد، عملیات‌های مختصات فقط در فضای‌نام آن مرجع جستجو خواهند شد (مانند \fBEPSG\fP). .sp این گزینه با \fB\-\-bbox\fP مانعة‌الجمع است. .UNINDENT .INDENT 0.0 .TP .B \-\-3d اضافه‌شده در نگارش 9.1. .sp سامانه(های) CRS دوبعدی را به نسخه سه‌بعدی ارتقا می‌دهد، جایی که محور عمودی ارتفاع بیضوی برحسب متر با استفاده از بیضویِ CRS مبنای ژئودتیک است. بسته به نگارش‌های PROJ و ماهیت دقیق CRSهای درگیر، به‌ویژه پیش از PROJ 9.1، ترکیب CRSهای دوبعدی و سه‌بعدی ممکن بود به تبدیلات ۲بعدی یا ۳بعدی منجر شود. از PROJ 9.1 به بعد، برای وقوع احتمالی تبدیل عمودی، هر دو CRS باید ۳بعدی باشند. .UNINDENT .INDENT 0.0 .TP .B \-\-s_epoch اضافه‌شده در نگارش 9.4. .sp مبدأ زمانی (Epoch) مختصات در CRS مبدا، برحسب سال اعشاری. تنها برای CRSهای پویا (dynamic CRS) کاربرد دارد. .UNINDENT .INDENT 0.0 .TP .B \-\-t_epoch اضافه‌شده در نگارش 9.4. .sp مبدأ زمانی (Epoch) مختصات در CRS مقصد، برحسب سال اعشاری. تنها برای CRSهای پویا (dynamic CRS) کاربرد دارد. .UNINDENT .sp آرگومان‌های خط فرمان \fI+opt\fP با پارامترهای نقشه‌نگاری مرتبط هستند. .sp برنامه cs2cs دو تعریف سامانه مختصات مرجع (CRS) را دریافت می‌کند. این تعاریف می‌توانند در قالب‌های گوناگونی مانند کدهای EPSG، رشته‌های WKT یا توضیحات سنتی CRS در PROJ.4 ارائه شوند. .sp اگر CRS دوم تعریف نشده باشد، یک CRS جغرافیایی بر پایه مبنا (datum) و بیضویِ CRS مبدا در نظر گرفته می‌شود. توجه داشته باشید که CRS مبدا و مقصد هر دو می‌توانند از یک نوع یا انواع متفاوت باشند (جغرافیایی، تصویری، CRS مرکب)، یا یکی از هر کدام، و ممکن است دارای مبناهای یکسان یا متفاوتی باشند. .sp هنگام استفاده از تعریف WKT یا AUTHORITY:CODE، ترتیب محورهای CRS اعمال خواهد شد. بنابراین برای مثال اگر از EPSG:4326 استفاده شود، اولین مقدار مورد انتظار (یا برگشتی) عرض جغرافیایی خواهد بود. .sp در سطح داخلی، cs2cs از تابع \fBproj_create_crs_to_crs()\fP \%<#\:c\:.proj_create_crs_to_crs> برای محاسبه عملیات مختصات مناسب استفاده می‌کند، بنابراین جزئیات پیاده‌سازی این تابع مستقیماً بر نتایج بازگردانده‌شده توسط برنامه تأثیر می‌گذارد. .sp پارامتر محیطی \fBPROJ_DATA\fP \%<#\:envvar-PROJ_DATA> دایرکتوری فایل‌های منابع (پایگاه‌داده، گرید‌های تغییر مبنا و غیره) را تعیین می‌کند. .sp یک یا چند فایل (که به ترتیب از چپ به راست پردازش می‌شوند) منبع داده‌های مورد تبدیل را مشخص می‌کنند. علامت \fB\-\fP ورودی استاندارد (stdin) را برای پردازش مشخص می‌کند. اگر هیچ فایلی مشخص نشود، ورودی از stdin فرض می‌شود. برای داده‌های ورودی، دو مقدار داده باید در دو فیلد اول که با فاصله از هم جدا شده‌اند قرار گیرند و هنگامی که هر دو ورودی و خروجی ASCII هستند، تمامی بخش‌های انتهایی خط ورودی به انتهای خط خروجی پیوست می‌شوند. .sp داده‌های جغرافیایی ورودی (طول و عرض جغرافیایی) باید در قالب DMS (درجه، دقیقه، ثانیه) یا درجه اعشاری باشند و داده‌های کارتزین ورودی باید در واحدهای سازگار با محور اصلی بیضوی یا واحدهای شعاع کره باشند. مختصات جغرافیایی خروجی معمولاً در قالب DMS خواهند بود (از \fB\-f %.12f\fP برای درجه اعشاری با ۱۲ رقم اعشار استفاده کنید)، در حالی که مختصات تصویری (کارتزین) در واحدهای خطی (متر، فوت) خواهند بود. .SS "استفاده از شبکه‌های راه دور (Use of remote grids)" .sp اضافه‌شده در نگارش 7.0.0. .sp اگر متغیر محیطی \fBPROJ_NETWORK\fP \%<#\:envvar-PROJ_NETWORK> روی \fBON\fP تنظیم شده باشد، برنامه cs2cs در صورت عدم دسترسی محلی به شبکه‌ها (گریدها)، تلاش می‌کند از گریدهای راه دور ذخیره‌شده روی فضای CDN (شبکه توزیع محتوا) استفاده کند. .sp جزئیات بیشتر در بخش قابلیت‌های شبکه \%<#\:network> در دسترس است. .SH "مثال‌ها (EXAMPLES)" .SS "استفاده از کدهای سامانه مختصات مرجع EPSG" .sp تبدیل از عرض/طول جغرافیایی WGS 84 (به همین ترتیب) به منطقه ۳۱ شمالی UTM با WGS 84 .INDENT 0.0 .INDENT 3.5 .sp .EX cs2cs EPSG:4326 EPSG:32631 < یافت که گزارش‌های جدید اشکالات نیز از طریق آن قابل ارسال است. .SH "صفحه اصلی (HOME PAGE)" .sp \% .SH "نویسنده (AUTHOR)" Frank Warmerdam .SH "حق نشر (COPYRIGHT)" 1983-2026, PROJ contributors .\" End of generated man page.