| CS2CS(1) | PROJ | CS2CS(1) |
نام (NAME)
cs2cs - تبدیل و بازپروجکشن دستگاه‌های مختصات جغرافیایی و نقشه‌نگاری
خلاصه دستور (SYNOPSIS)
cs2cs [-eEfIlrstvwW [args]]
[[--area <name_or_code>] | [--bbox <west_long,south_lat,east_long,north_lat>]]
[--authority <name>] [--3d]
[--accuracy <accuracy>] [--only-best[=yes|=no]] [--no-ballpark]
[--s_epoch {epoch}] [--t_epoch {epoch}]
([+opt[=arg] ...] [+to +opt[=arg] ...] | {source_crs} {target_crs})
file ...
جایی که {source_crs} یا {target_crs} یکی از موارد پذیرفته‌شده توسط proj_create() <#c.proj_create> است، به شرطی که بیانگر یک سامانه مختصات مرجع (CRS) باشد:
- یک رشته پروژکشن (proj-string)،
- یک رشته WKT،
- یک کد شیء (مانند "EPSG:4326"، "urn:ogc:def:crs:EPSG::4326"، "urn:ogc:def:coordinateOperation:EPSG::1671")،
- یک نام شیء؛ برای مثال "WGS 84"، "WGS 84 / UTM zone 31N". در این حالت از آنجا که یکتا بودن تضمین نمی‌شود، روش‌های اکتشافی (heuristics) برای تعیین مناسب‌ترین تطابق اعمال می‌شوند.
- یک نام CRS و مبدا مختصات زمانی (epoch)، که با '@' جدا شده‌اند؛ مانند "<ITRF2014@2025.0>" (اضافه‌شده در نگارش 9.2).
- یک OGC URN ترکیبی از مراجع برای سامانه‌های مختصات مرجع مرکب (compound CRS) (مانند "<urn:ogc:def:crs,crs:EPSG::2393,crs:EPSG::5717>" یا نحو اختصاری سفارشی "EPSG:2393+5717")،
- یک OGC URN ترکیبی از مراجع برای CRSهای تصویری یا مشتق‌شده برای مثال برای CRS سه‌بعدی تصویری "UTM zone 31N / WGS 84 (3D)": "<urn:ogc:def:crs,crs:EPSG::4979,cs:PROJ::ENh,coordinateOperation:EPSG::16031>" (اضافه‌شده در نگارش 6.2).
- یک OGC URN ترکیبی از مراجع برای عملیات‌های متوالی (concatenated operations) (مانند "<urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,coordinateOperation:EPSG::1618>").
- یک رشته PROJJSON؛ اسکیما در https://proj.org/schemas/v0.4/projjson.schema.json در دسترس است (اضافه‌شده در نگارش 6.2).
- یک CRS مرکب ساخته‌شده از دو نام شیء که با " + " از هم جدا شده‌اند؛ مانند "WGS 84 + EGM96 height" (اضافه‌شده در نگارش 7.1).
اضافه‌شده در نگارش 6.0.0.
نکته:
توضیحات (DESCRIPTION)
دستور cs2cs تبدیل میان سامانه مختصات مرجع (CRS) نقشه‌نگاری مبدا و مقصد را روی مجموعه‌ای از نقاط ورودی انجام می‌دهد. تبدیل سامانه مختصات مرجع می‌تواند شامل تبدیل میان مختصات تصویری و جغرافیایی و همچنین اعمال تغییر مبنا (datum shift) باشد.
پارامترهای کنترلی زیر می‌توانند به هر ترتیبی ظاهر شوند:
- -I
- انجام تبدیل معکوس؛ یعنی از CRS مقصد به CRS مبدا.
- -t<a>
- که در آن a نویسه‌ای را مشخص می‌کند که به‌عنوان اولین نویسه برای نشان دادن خط کنترلی به کار می‌رود تا بدون پردازش عبور داده شود. این گزینه فقط برای ورودی‌های ASCII کاربرد دارد (مقدار پیش‌فرض # است).
- -d <n>
- اضافه‌شده
در نگارش 5.2.0.
تعداد ارقام اعشار را برای گرد کردن در خروجی مشخص می‌کند.
- -e <string>
- که در آن string یک رشته دلخواه است که در صورت تشخیص خطا هنگام تبدیل داده‌ها در خروجی چاپ می‌شود. مقدار پیش‌فرض یک رشته سه نویسه‌ای است: *\t*.
- -E
- باعث می‌شود مختصات ورودی پیش از چاپ مقادیر تبدیل‌شده، در خط خروجی کپی شوند.
- -l<[=id]>
- فهرست شناسه‌های تصویری را که می‌توان با +proj انتخاب کرد، نمایش می‌دهد. دستور cs2cs -l=id توضیحات کامل‌تری از شناسه تصویر id ارائه می‌دهد؛ مانند cs2cs -l=merc.
- -lp
- فهرست تمام شناسه‌های تصویری که می‌توان با پارامتر +proj استفاده کرد. معادل با cs2cs -l.
- -lP
- توضیحات مبسوط تمام تصویرهایی که می‌توان با پارامتر +proj استفاده کرد.
- -le
- فهرست تمام بیضوی‌هایی که می‌توان با پارامتر +ellps انتخاب کرد.
- -lm
- فهرست نصف‌النهارهای مبدأ پیش‌فرض که می‌توان با پارامتر +pm انتخاب کرد. توجه داشته باشید که این فهرست دیگر به‌روزرسانی نمی‌شود و ممکن است برخی مقادیر با سایر منابع مغایرت داشته باشند.
- -lu
- فهرست تمام واحدهای فاصله که می‌توان با پارامتر +units انتخاب کرد.
- -r
- این گزینه ترتیب دو ورودی مورد انتظار اول را از آنچه توسط CRS مشخص شده به ترتیب معکوس تغییر می‌دهد. مختصات سوم (معمولاً ارتفاع) در جایگاه سوم باقی می‌ماند.
- -s
- این گزینه ترتیب دو خروجی مورد انتظار اول را از آنچه توسط CRS مشخص شده به ترتیب معکوس تغییر می‌دهد. مختصات سوم (معمولاً ارتفاع) در جایگاه سوم باقی می‌ماند.
- -f <format>
- که در آن format یک رشته قالب‌بندی printf برای کنترل شکل مقادیر خروجی است. در تبدیلات معکوس، در صورت استفاده از این گزینه، خروجی برحسب درجه خواهد بود. اگر قالبی برای تبدیل معکوس مشخص شود، داده‌های خروجی برحسب درجه اعشاری خواهند بود. قالب پیش‌فرض برای تبدیل مستقیم "%.2f" و برای تبدیل معکوس DMS (درجه، دقیقه، ثانیه) است.
- -w<n>
- که در آن n تعداد ارقام اعشار بااهمیت برای خروجی ثانیه است (در صورت مشخص نشدن این گزینه، -w3 در نظر گرفته می‌شود).
- -W<n>
- که در آن n تعداد ارقام اعشار بااهمیت برای خروجی ثانیه است. هنگامی که -W استفاده می‌شود، فیلدها با صفرهای ابتدایی دارای عرض ثابت خواهند بود. محدوده معتبر: -W0 تا -W8.
- -v
- باعث می‌شود فهرستی از پارامترهای کنترلی نقشه‌نگاری آزموده‌شده و استفاده‌شده توسط برنامه پیش از داده‌های ورودی چاپ شود.
- --area <name_or_code>
- اضافه‌شده
در نگارش 8.0.0.
محدوده جغرافیایی مورد نظر را برای محدود کردن نتایج هنگام جستجوی عملیات‌های مختصات میان دو CRS مشخص می‌کند. محدوده مورد نظر را می‌توان با نام (مانند "Denmark - onshore") یا به‌صورت AUTHORITY:CODE (مانند EPSG:3237) مشخص کرد.
این گزینه با --bbox مانعة‌الجمع است.
- --bbox <west_long,south_lat,east_long,north_lat>
- اضافه‌شده
در نگارش 8.0.0.
محدوده جغرافیایی مورد نظر را برای محدود کردن نتایج هنگام جستجوی عملیات‌های مختصات میان دو CRS مشخص می‌کند. محدوده به صورت یک کادر محصورکننده (bounding box) با مختصات جغرافیایی، برحسب درجه در یک CRS جغرافیایی نامشخص تعیین می‌شود. west_long و east_long باید در بازه [-180,180] و south_lat و north_lat در بازه [-90,90] باشند. مقدار west_long معمولاً کمتر از east_long است، مگر در حالتی که محدوده مورد نظر از نصف‌النهار ۱۸۰ درجه (antimeridian) عبور کند.
- --only-best[=yes|=no]
- اضافه‌شده
در نگارش 9.2.0.
برنامه cs2cs را ملزم می‌کند که فقط از بهترین تبدیل شناخته‌شده توسط PROJ استفاده کند. در صورتی که گرید مورد نیاز برای بهترین تبدیل وجود نداشته باشد، cs2cs یک خطا بازمی‌گرداند.
منظور از «بهترین تبدیل»، دقیق‌ترین تبدیل موجود در میان تمام تبدیلات مرتبط برای نقطه مورد نظر است، در صورتی که تمام شبکه‌ها (گریدها)ی شناخته‌شده مورد نیاز برای انجام چنین تبدیلی در دسترس باشند (به‌صورت محلی یا از طریق شبکه).
توجه داشته باشید که مقدار پیش‌فرض این گزینه را می‌توان با متغیر محیطی PROJ_ONLY_BEST_DEFAULT یا با تنظیم only_best_default در فایل proj.ini <#proj-ini> نیز تعیین کرد (در صورت مشخص شدن --only-best، مقدار پیش‌فرض بازنویسی می‌شود).
- --no-ballpark
- اضافه‌شده
در نگارش 8.0.0.
هرگونه عملیات مختصات را که یک تبدیل تقریبی (Ballpark transformation <#term-Ballpark-transformation>) باشد یا شامل آن گردد، غیرمجاز می‌کند.
- --accuracy <accuracy>
- اضافه‌شده
در نگارش 8.0.0.
حداقل دقت مورد نظر را برای عملیات‌های مختصات کاندید تعیین می‌کند.
- اضافه‌شده
در نگارش 8.0.0.
این گزینه می‌تواند برای محدود کردن مرجع صادرکننده (authority) عملیات‌های مختصات جستجوشده در پایگاه‌داده به کار رود. در صورت مشخص نشدن، عملیات‌های مختصات از هر مرجعی جستجو خواهند شد، با محدودیت‌های تعیین‌شده در جدول پایگاه‌داده authority_to_authority_preference مرتبط با مرجع خود CRSهای مبدا/مقصد. اگر مرجع روی any تنظیم شود، عملیات‌های مختصات از هر مرجعی جستجو می‌شوند. اگر مرجع یک رشته غیرخالی متفاوت از any باشد، عملیات‌های مختصات فقط در فضای‌نام آن مرجع جستجو خواهند شد (مانند EPSG).
این گزینه با --bbox مانعة‌الجمع است.
- --3d
- اضافه‌شده
در نگارش 9.1.
سامانه(های) CRS دوبعدی را به نسخه سه‌بعدی ارتقا می‌دهد، جایی که محور عمودی ارتفاع بیضوی برحسب متر با استفاده از بیضویِ CRS مبنای ژئودتیک است. بسته به نگارش‌های PROJ و ماهیت دقیق CRSهای درگیر، به‌ویژه پیش از PROJ 9.1، ترکیب CRSهای دوبعدی و سه‌بعدی ممکن بود به تبدیلات ۲بعدی یا ۳بعدی منجر شود. از PROJ 9.1 به بعد، برای وقوع احتمالی تبدیل عمودی، هر دو CRS باید ۳بعدی باشند.
- --s_epoch
- اضافه‌شده
در نگارش 9.4.
مبدأ زمانی (Epoch) مختصات در CRS مبدا، برحسب سال اعشاری. تنها برای CRSهای پویا (dynamic CRS) کاربرد دارد.
- --t_epoch
- اضافه‌شده
در نگارش 9.4.
مبدأ زمانی (Epoch) مختصات در CRS مقصد، برحسب سال اعشاری. تنها برای CRSهای پویا (dynamic CRS) کاربرد دارد.
آرگومان‌های خط فرمان +opt با پارامترهای نقشه‌نگاری مرتبط هستند.
برنامه cs2cs دو تعریف سامانه مختصات مرجع (CRS) را دریافت می‌کند. این تعاریف می‌توانند در قالب‌های گوناگونی مانند کدهای EPSG، رشته‌های WKT یا توضیحات سنتی CRS در PROJ.4 ارائه شوند.
اگر CRS دوم تعریف نشده باشد، یک CRS جغرافیایی بر پایه مبنا (datum) و بیضویِ CRS مبدا در نظر گرفته می‌شود. توجه داشته باشید که CRS مبدا و مقصد هر دو می‌توانند از یک نوع یا انواع متفاوت باشند (جغرافیایی، تصویری، CRS مرکب)، یا یکی از هر کدام، و ممکن است دارای مبناهای یکسان یا متفاوتی باشند.
هنگام استفاده از تعریف WKT یا AUTHORITY:CODE، ترتیب محورهای CRS اعمال خواهد شد. بنابراین برای مثال اگر از EPSG:4326 استفاده شود، اولین مقدار مورد انتظار (یا برگشتی) عرض جغرافیایی خواهد بود.
در سطح داخلی، cs2cs از تابع proj_create_crs_to_crs() <#c.proj_create_crs_to_crs> برای محاسبه عملیات مختصات مناسب استفاده می‌کند، بنابراین جزئیات پیاده‌سازی این تابع مستقیماً بر نتایج بازگردانده‌شده توسط برنامه تأثیر می‌گذارد.
پارامتر محیطی PROJ_DATA <#envvar-PROJ_DATA> دایرکتوری فایل‌های منابع (پایگاه‌داده، گریدهای تغییر مبنا و غیره) را تعیین می‌کند.
یک یا چند فایل (که به ترتیب از چپ به راست پردازش می‌شوند) منبع داده‌های مورد تبدیل را مشخص می‌کنند. علامت - ورودی استاندارد (stdin) را برای پردازش مشخص می‌کند. اگر هیچ فایلی مشخص نشود، ورودی از stdin فرض می‌شود. برای داده‌های ورودی، دو مقدار داده باید در دو فیلد اول که با فاصله از هم جدا شده‌اند قرار گیرند و هنگامی که هر دو ورودی و خروجی ASCII هستند، تمامی بخش‌های انتهایی خط ورودی به انتهای خط خروجی پیوست می‌شوند.
داده‌های جغرافیایی ورودی (طول و عرض جغرافیایی) باید در قالب DMS (درجه، دقیقه، ثانیه) یا درجه اعشاری باشند و داده‌های کارتزین ورودی باید در واحدهای سازگار با محور اصلی بیضوی یا واحدهای شعاع کره باشند. مختصات جغرافیایی خروجی معمولاً در قالب DMS خواهند بود (از -f %.12f برای درجه اعشاری با ۱۲ رقم اعشار استفاده کنید)، در حالی که مختصات تصویری (کارتزین) در واحدهای خطی (متر، فوت) خواهند بود.
استفاده از شبکه‌های راه دور (Use of remote grids)
اضافه‌شده در نگارش 7.0.0.
اگر متغیر محیطی PROJ_NETWORK <#envvar-PROJ_NETWORK> روی ON تنظیم شده باشد، برنامه cs2cs در صورت عدم دسترسی محلی به شبکه‌ها (گریدها)، تلاش می‌کند از گریدهای راه دور ذخیره‌شده روی فضای CDN (شبکه توزیع محتوا) استفاده کند.
جزئیات بیشتر در بخش قابلیت‌های شبکه <#network> در دسترس است.
مثال‌ها (EXAMPLES)
استفاده از کدهای سامانه مختصات مرجع EPSG
تبدیل از عرض/طول جغرافیایی WGS 84 (به همین ترتیب) به منطقه ۳۱ شمالی UTM با WGS 84
cs2cs EPSG:4326 EPSG:32631 <<EOF 45N 2E EOF
خروجی می‌دهد:
421184.70 4983436.77 0.00
استفاده از نام‌های سامانه مختصات مرجع EPSG
تبدیل از عرض/طول جغرافیایی WGS 84 (به همین ترتیب) همراه با ارتفاع EGM96 به منطقه ۳۱ شمالی UTM با WGS 84 همراه با ارتفاع بیضوی WGS84
echo 45 2 0 | cs2cs "WGS 84 + EGM96 height" "WGS 84 / UTM zone 31N" --3d
خروجی می‌دهد:
421184.70 4983436.77 50.69
نکته:
استفاده از رشته‌های PROJ
اسکریپت زیر:
cs2cs +proj=latlong +datum=NAD83 +to +proj=utm +zone=10 +datum=NAD27 -r <<EOF 45°15'33.1" 111.5W 45d15.551666667N -111d30 +45.25919444444 111d30'000w EOF
مختصات جغرافیایی ورودی NAD83 را به مختصات NAD27 در تصویر UTM با انتخاب منطقه ۱۰ تبدیل می‌کند. مقادیر جغرافیایی این مثال هم‌ارز هستند و به‌عنوان نمونه‌هایی از انواع ورودی‌های DMS آورده شده‌اند. داده‌های خروجی x-y به‌صورت سه خط زیر ظاهر خواهند شد:
1402285.93 5076292.58 0.00
برای دریافت دقیق این مقادیر، باید تمام گریدهای جاری (در این مورد گرید NADCON5 به نام us_noaa_nadcon5_nad27_nad83_1986_conus.tif) را به‌صورت محلی نصب داشته باشید یا از قابلیت‌های شبکه که پیش‌تر ذکر شد استفاده کنید.
برای اطمینان از دستیابی به نتیجه بهینه، می‌توانید گزینه --only-best را اضافه کنید. با فرض این که گرید ذکرشده در بالا در دسترس نباشد:
echo -111.5 45.25919444444 | cs2cs --only-best +proj=latlong +datum=NAD83 +to +proj=utm +zone=10 +datum=NAD27
این خروجی را بازمی‌گرداند:
Attempt to use coordinate operation axis order change (2D) + Inverse of NAD27 to NAD83 (7) + axis order change (2D) + UTM zone 10N failed. Grid us_noaa_nadcon5_nad27_nad83_1986_conus.tif is not available. Consult https://proj.org/resource_files.html for guidance. * * inf
در غیر این صورت، اگر گرید را در دسترس نداشته باشید و --only-best را نیز مشخص نکنید:
echo -111.5 45.25919444444 | cs2cs --only-best +proj=latlong +datum=NAD83 +to +proj=utm +zone=10 +datum=NAD27
این خروجی را بازمی‌گرداند:
1402224.57 5076275.42 0.00
که نتیجه‌ای است حاصل از یکسان فرض شدن مبناهای NAD27 و NAD83، که تقریبی در حد چند ده متر است.
همچنین ببینید (SEE ALSO)
اشکالات (BUGS)
فهرستی از اشکالات شناخته‌شده را می‌توان در https://github.com/OSGeo/PROJ/issues یافت که گزارش‌های جدید اشکالات نیز از طریق آن قابل ارسال است.
صفحه اصلی (HOME PAGE)
نویسنده (AUTHOR)
Frank Warmerdam
حق نشر (COPYRIGHT)
1983-2026, PROJ contributors
| 10 avril 2026 | 9.8 |