.\" 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 "PROJINFO" "1" "10 avril 2026" "9.8" "PROJ" .SH "نام (NAME)" projinfo \- پرس‌وجوی اشیاء ژئودتیک و عملیات‌های مختصات .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .nf \fBprojinfo\fP .in +2 [\-o formats] [\-k crs|operation|datum|ensemble|ellipsoid] [\-\-summary] [\-q] [[\-\-area name_or_code] | [\-\-bbox west_long,south_lat,east_long,north_lat]] [\-\-spatial\-test contains|intersects] [\-\-crs\-extent\-use none|both|intersection|smallest] [\-\-grid\-check none|discard_missing|sort|known_available] [\-\-pivot\-crs always|if_no_direct_transformation|never|{auth:code[,auth:code]*}] [\-\-show\-superseded] [\-\-hide\-ballpark] [\-\-accuracy {accuracy}] [\-\-allow\-ellipsoidal\-height\-as\-vertical\-crs] [\-\-boundcrs\-to\-wgs84] [\-\-authority name] [\-\-main\-db\-path path] [\-\-aux\-db\-path path]* [\-\-dump\-db\-structure] [\-\-identify] [\-\-3d] [\-\-output\-id AUTH:CODE] [\-\-c\-ify] [\-\-single\-line] \-\-searchpaths | \-\-remote\-data | \-\-list\-crs [list\-crs\-filter] | \-\-dump\-db\-structure [{object_definition} | {object_reference}] | {object_definition} | {object_reference} | (\-s {srs_def} [\-\-s_epoch {epoch}] \-t {srs_def} [\-\-t_epoch {epoch}]) | ({srs_def} {srs_def}) .in -2 .fi .sp .sp که در آن {object_definition} یا {srs_def} یکی از حالت‌های پذیرفته‌شده توسط \fBproj_create()\fP \%<#\:c\:.proj_create> است: .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 که ارجاعات را برای سیستم‌های مرجع مختصات ترکیبی ترکیب می‌کند (مانند \(dq\%\(dq یا نحو مختصر سفارشی \(dqEPSG:2393+5717\(dq)، .IP \(bu 2 یک OGC URN که ارجاعات را برای CRSهای تصویرشده یا مشتق‌شده ترکیب می‌کند؛ برای نمونه برای Projected 3D CRS به شکل \(dqUTM zone 31N / WGS 84 (3D)\(dq: \(dq\%\(dq (\fIدر نسخه 6.2 اضافه شد\fP) .IP \(bu 2 توسعه‌ای از OGC URN برای CoordinateMetadata؛ برای نمونه \(dq\%\(dq .IP \(bu 2 یک OGC URN ترکیب‌کننده ارجاعات برای عملیات‌های الحاقی (مانند \(dq\%\(dq) .IP \(bu 2 یک رشته PROJJSON؛ ساختار jsonschema در \% قرار دارد (\fIدر نسخه 6.2 اضافه شد\fP) .IP \(bu 2 یک CRS ترکیبی تشکیل‌شده از دو نام شیء که با \(dq + \(dq از یکدیگر جدا شده‌اند؛ برای نمونه \(dqWGS 84 + EGM96 height\(dq (\fIدر نسخه 7.1 اضافه شد\fP) .UNINDENT .sp {object_reference} نام فایلی است که پیش از آن نویسه \(aq@\(aq قرار می‌گیرد. فایلی که توسط {object_reference} به آن ارجاع داده می‌شود باید حاوی یک {object_definition} معتبر باشد. .sp استفاده از \(dq{srs_def} {srs_def}\(dq معادل \(dq\-s {srs_def} \-t {srs_def}\(dq است (\fIدر نسخه 9.5 اضافه شد\fP). .UNINDENT .UNINDENT.SH "توضیحات (DESCRIPTION)" .sp ‏projinfo برنامه‌ای است که می‌تواند هنگام مشخص شدن گزینه‌های \fB\-s\fP و \fB\-t\fP، اطلاعات مربوط به یک شیء ژئودتیک، سامانه مرجع مختصات (CRS) یا عملیات مختصات را پرس‌وجو کرده و آن را در قالب‌های مختلف (رشته PROJ، رشته WKT یا رشته PROJJSON) نمایش دهد. .sp همچنین می‌توان از آن برای پرس‌وجوی عملیات‌های مختصات موجود میان دو CRS استفاده کرد. .sp نام این برنامه با ارجاعی به ابزار کاربردی gdalsrsinfo از GDAL \% که خدمات تا حدی مشابهی ارائه می‌دهد، نام‌گذاری شده است. .sp پارامترهای کنترلی زیر می‌توانند به هر ترتیبی ظاهر شوند: .INDENT 0.0 .TP .B \-o formats ‏formats ترکیبی جداشده با ویرگول از موارد زیر است: \fBall\fP، \fBdefault\fP، \fBPROJ\fP، \fBWKT_ALL\fP، \fBWKT2:2015\fP، \fBWKT2:2019\fP، \fBWKT1:GDAL\fP، \fBWKT1:ESRI\fP، \fBPROJJSON\fP، \fBSQL\fP\&. .sp به جز \fBall\fP و \fBdefault\fP، سایر قالب‌ها می‌توانند با یک \fB\-\fP در ابتدا غیرفعال شوند. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 پیش‌تر WKT2_2019 با نام WKT2_2018 خوانده می‌شد. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 پیش از PROJ 6.3.0، قالب WKT1:GDAL به‌طور ضمنی \-\-boundcrs\-to\-wgs84 را فراخوانی می‌کرد. این مورد دیگر برقرار نیست. .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 هنگامی که SQL مشخص می‌شود، \fB\-\-output\-id\fP نیز باید مشخص گردد. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-k crs|operation|datum|ensemble|ellipsoid هنگامی که برای پرس‌وجوی یک شیء منفرد با یک AUTHORITY:CODE استفاده می‌شود، در صورتی که CRSها، عملیات‌های مختصات یا بیضوی‌هایی با یک CODE یکسان وجود داشته باشند، نوع (kind) شیء را تعیین می‌کند. پیش‌فرض crs است. .UNINDENT .INDENT 0.0 .TP .B \-\-summary هنگام فهرست کردن عملیات‌های مختصات موجود میان دو CRS، نتیجه را در قالبی خلاصه‌شده بازمی‌گرداند که فقط نام عملیات مختصات، دقت و محدودهٔ استفادهٔ آن را ذکر می‌کند. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 فقط برای محاسبهٔ عملیات مختصات استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-q حالت بی‌صدا (quiet mode) را فعال می‌کند. حالت بی‌صدا فقط برای پرس‌وجوها روی اشیاء منفرد و زمانی که فقط یک قالب خروجی انتخاب شده باشد در دسترس است. در این حالت، تنها رشتهٔ PROJ، WKT یا PROJJSON بدون هیچ‌گونه خروجی مقدماتی نمایش داده می‌شود. خروجی در این وضعیت به‌طور بالقوه برای انتقال از طریق لوله (pipe) به سایر ابزارها سازگار است. .UNINDENT .INDENT 0.0 .TP .B \-\-area name_or_code یک محدودهٔ مورد نظر (area of interest) را برای محدود کردن نتایج هنگام جستجوی عملیات‌های مختصات میان دو CRS مشخص می‌کند. محدودهٔ مورد نظر می‌تواند به صورت یک نام (مانند \(dqDenmark \- onshore\(dq) یا یک AUTHORITY:CODE (مانند EPSG:3237) تعیین شود. این گزینه با \fB\-\-bbox\fP مانعة‌الجمع است. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 فقط برای محاسبهٔ عملیات مختصات استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-bbox west_long,south_lat,east_long,north_lat یک محدودهٔ مورد نظر را برای محدود کردن نتایج هنگام جستجوی عملیات‌های مختصات میان دو 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) عبور کند. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 فقط برای محاسبهٔ عملیات مختصات استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-spatial\-test contains|intersects مشخص می‌کند که محدودهٔ استفادهٔ عملیات‌های مختصات یافت‌شده در پایگاه داده، چگونه با محدودهٔ استفادهٔ صریحاً مشخص‌شده توسط \fB\-\-area\fP یا \fB\-\-bbox\fP، یا مشتق‌شده به‌طور ضمنی از محدودهٔ استفادهٔ CRS مبدأ و مقصد مقایسه شود. به‌طور پیش‌فرض، projinfo فقط عملیات‌های مختصاتی را نگه می‌دارد که محدودهٔ استفادهٔ آن‌ها کاملاً درون محدودهٔ مورد نظر قرار داشته باشد (راهبرد \fBcontains\fP). اگر از راهبرد \fBintersects\fP استفاده شود، آزمون مکانی ساده‌تر شده و هر عملیات مختصاتی که محدودهٔ استفادهٔ آن حداقل تا حدی با محدودهٔ مورد نظر تقاطع داشته باشد، فهرست می‌شود. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 فقط برای محاسبهٔ عملیات مختصات استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-crs\-extent\-use none|both|intersection|smallest مشخص می‌کند در صورتی که هیچ محدودهٔ مورد نظری با گزینه‌های \fB\-\-area\fP یا \fB\-\-bbox\fP به‌طور صریح تعیین نشده باشد، کدام محدوده باید در نظر گرفته شود. به‌طور پیش‌فرض (راهبرد \fBsmallest\fP)، محدودهٔ استفادهٔ CRS مبدأ یا مقصد بررسی می‌شود و موردی که از نظر مساحت کوچک‌تر باشد به عنوان محدودهٔ مورد نظر استفاده خواهد شد. در صورت استفاده از \fBnone\fP، هیچ محدودهٔ مورد نظری استفاده نمی‌شود. در صورت استفاده از \fBboth\fP، تنها عملیات‌های مختصاتی انتخاب می‌شوند که با محدودهٔ استفادهٔ هر دو CRS مرتبط باشند (شامل شدن یا تقاطع، بسته به راهبرد \fB\-\-spatial\-test\fP). در صورت استفاده از \fBintersection\fP، محدودهٔ مورد نظر برابر با تقاطع جعبه‌های محصورکنندهٔ محدودهٔ استفادهٔ CRS مبدأ و مقصد خواهد بود. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 فقط برای محاسبهٔ عملیات مختصات استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-grid\-check none|discard_missing|sort|known_available مشخص می‌کند که وجود یا عدم وجود شبکهٔ انتقال (shift grid) افقی یا عمودیِ مورد نیاز برای یک عملیات مختصات، چگونه بر نتایج بازگردانده‌شده هنگام جستجوی عملیات‌های مختصات میان دو CRS اثر می‌گذارد. راهبرد پیش‌فرض \fBsort\fP است (در صورتی که \fBPROJ_NETWORK\fP \%<#\:envvar-PROJ_NETWORK> تعریف نشده باشد). در این حالت، تمامی عملیات‌های نامزد بازگردانده می‌شوند، اما در دسترس بودن واقعی شبکه‌ها برای تعیین ترتیب مرتب‌سازی به کار می‌رود؛ بدین صورت که اگر یک عملیات مختصات شامل استفاده از شبکه‌ای باشد که در دایرکتوری‌های منابع PROJ (تعیین‌شده توسط متغیر محیطی \fBPROJ_DATA\fP \%<#\:envvar-PROJ_DATA>) موجود نیست، در انتهای نتایج فهرست خواهد شد. راهبرد \fBnone\fP بررسی وجود شبکه‌ها را به‌طور کامل غیرفعال می‌کند و نتایج را به‌گونه‌ای بازمی‌گرداند که گویی تمامی شبکه‌ها در دسترس هستند. راهبرد \fBdiscard_missing\fP نتایجی را که شامل شبکه‌های ناموجود در دایرکتوری‌های منابع PROJ هستند کنار می‌گذارد. راهبرد \fBknown_available\fP نتایجی را که شامل شبکه‌های ناموجود در دایرکتوری‌های منابع PROJ بوده و برای CDN نیز ناشناخته هستند کنار می‌گذارد. این راهبرد پیش‌فرض در حالتی است که \fBPROJ_NETWORK\fP \%<#\:envvar-PROJ_NETWORK> روی \fBON\fP تنظیم شده باشد. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 فقط برای محاسبهٔ عملیات مختصات استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-pivot\-crs always|if_no_direct_transformation|never|{auth:code[,auth:code]*} تعیین می‌کند که آیا هنگام جستجوی عملیات مختصات میان دو CRS، امکان استفاده از یک CRS واسط (pivot) وجود دارد یا خیر. یک مثال معمول، مبنای WGS84 است. به‌طور پیش‌فرض، projinfo در صورت نبود تبدیل مستقیم، هر مبنای واسط بالقوه‌ای را در نظر می‌گیرد (\fBif_no_direct_transformation\fP). در صورت استفاده از راهبرد \fBnever\fP، تنها تبدیلات مستقیم میان CRS مبدأ و مقصد استفاده خواهند شد. در صورت استفاده از راهبرد \fBalways\fP، سامانه‌های CRS واسط حتی در صورت وجود تبدیلات مستقیم نیز در نظر گرفته می‌شوند. همچنین این امکان وجود دارد که با تعیین یک یا چند CRS بر اساس AUTHORITY:CODE آن‌ها، سامانه‌های CRS واسط مورد بررسی را محدود کرد..sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 تنها برای محاسبه عملیات مختصاتی استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-show\-superseded هنگامی که فعال باشد، عملیات‌های مختصاتی که توسط موارد دیگر جایگزین شده‌اند فهرست خواهند شد. توجه داشته باشید که جایگزینی معادل منسوخ‌سازی نیست: عملیات‌های جایگزین‌شده با وجود اینکه معادل بهتری دارند هنوز معتبر تلقی می‌شوند، در حالی که عملیات‌های منسوخ‌شده نادرست تشخیص داده شده‌اند و به هیچ وجه در نظر گرفته نمی‌شوند. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 تنها برای محاسبه عملیات مختصاتی استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-hide\-ballpark در نسخهٔ 7.1 اضافه شده است. .sp هر عملیات مختصاتی را که یک تبدیل Ballpark \%<#\:term-Ballpark-transformation> است یا شامل آن می‌شود، پنهان می‌کند. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 تنها برای محاسبه عملیات مختصاتی استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-accuracy {accuracy} در نسخهٔ 8.0 اضافه شده است. .sp حداقل دقت مورد نظر را برای عملیات‌های مختصاتی بازگردانده‌شده تنظیم می‌کند. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 تنها برای محاسبه عملیات مختصاتی استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-allow\-ellipsoidal\-height\-as\-vertical\-crs در نسخهٔ 8.0 اضافه شده است. .sp اجازه می‌دهد یک CRS جغرافیایی یا تصویرشده سه‌بعدی به عنوان یک CRS ترکیبی صادر شود که CRS عمودی آن نشان‌دهندهٔ ارتفاع بیضوی است. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 تنها برای CRS و با قالب خروجی WKT1:GDAL استفاده می‌شود .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-boundcrs\-to\-wgs84 هنگامی که مشخص شود، این گزینه یک عملیات مختصاتی را از CRS جغرافیایی پایه مربوط به CRS منفرد، CRS مبدأ یا مقصد به CRS جغرافیایی WGS84 جستجو می‌کند و در صورت یافتن، آن CRSها را در یک شیء BoundCRS بسته‌بندی می‌کند. این مورد عمدتاً برای رویکردهای پیوند اولیه (early\-binding) استفاده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-authority name نام مرجع (authority) را برای محدود کردن جستجوی اشیاء، هنگام مشخص کردن یک شیء با نام یا زمان محاسبه عملیات‌های مختصاتی، تعیین می‌کند. حالت پیش‌فرض مجاز دانستن تمام مراجع است. .sp هنگامی که همراه با خروجی SQL استفاده شود، مراجعی را که اشیاء میانی می‌توانند متعلق به آن‌ها باشند محدود می‌کند (پیش‌فرض EPSG و PROJ است). توجه داشته باشید که مرجع گزینهٔ \fB\-\-output\-id\fP نیز به‌طور ضمنی اضافه خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-main\-db\-path path نام و مسیر پایگاه داده‌ای که باید توسط projinfo\& استفاده شود را مشخص می‌کند. حالت پیش‌فرض \fBproj.db\fP در دایرکتوری‌های منابع PROJ است. .UNINDENT .INDENT 0.0 .TP .B \-\-aux\-db\-path path نام و مسیر پایگاه‌های داده کمکی را که باید با پایگاه داده اصلی ترکیب شوند، مشخص می‌کند. این پایگاه‌های داده کمکی باید ساختار جدولی همسان با پایگاه داده اصلی داشته باشند، اما می‌توانند تا حدی پر شده باشند و مدخل‌های آن‌ها می‌تواند به مدخل‌های پایگاه داده اصلی ارجاع دهد. این گزینه ممکن است برای تعیین چندین پایگاه داده کمکی تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-identify هنگامی که همراه با تعریف یک شیء استفاده شود، پایگاه داده PROJ را برای یافتن اشیاء شناخته‌شده، معمولاً CRS، که نزدیک یا یکسان با آن شیء هستند، پرس‌وجو می‌کند. به هر شیء نامزد یک درصد احتمال تقریبی اختصاص داده می‌شود. این ویژگی هنگام استفاده با یک رشته WKT فاقد شناسه EPSG، مانند ESRI WKT1، مفید است. همچنین ممکن است با رشته‌های PROJ نیز استفاده شود. برای مثال، \fI+proj=utm +zone=31 +datum=WGS84 +type=crs\fP با احتمال ۷۰٪ به عنوان EPSG:32631 شناسایی خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-dump\-db\-structure در نسخهٔ 8.1 اضافه شده است. .sp دنباله‌ای از دستورات SQL را برای ایجاد یک پایگاه داده کمکی معتبر و خالی جدید خروجی می‌دهد. این گزینه می‌تواند به عنوان تنها سوییچ این ابزار مشخص شود. در صورت مشخص کردن یک شیء CRS و گزینهٔ \fB\-\-output\-id\fP، تعریف شیء در قالب دستورات SQL ضمیمه خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-list\-crs [list\-crs\-filter] در نسخهٔ 8.1 اضافه شده است. .sp فهرستی (نام مرجع:کد و نام CRS) از CRSهای فیلترشده از پایگاه داده را خروجی می‌دهد. اگر هیچ فیلتری ارائه نشود، تمام نام‌های مراجع و انواع CRSهای غیرمنسوخ استخراج می‌شوند. list\-crs\-filter ترکیبی جداشده با ویرگول از موارد زیر است: allow_deprecated,geodetic,geocentric,geographic,geographic_2d,geographic_3d,vertical,projected,compound. تحت تأثیر گزینه‌های \fB\-\-authority\fP، \fB\-\-area\fP، \fB\-\-bbox\fP و \fB\-\-spatial\-test\fP قرار می‌گیرد. .sp یک جایگزین بصری، صفحه وب CRS Explorer \% است. .UNINDENT .INDENT 0.0 .TP .B \-\-3d در نسخهٔ 6.3 اضافه شده است. .sp «ارتقای» CRS(های) دوبعدی به نسخهٔ سه‌بعدی آن‌ها، به‌طوری که محور عمودی با استفاده از بیضوگونِ CRS ژئودتیک پایه، ارتفاع بیضوی بر حسب متر باشد. بسته به نسخه‌های PROJ و ماهیت دقیق CRSهای درگیر، به‌ویژه پیش از PROJ 9.1، ترکیبی از CRSهای دو و سه‌بعدی می‌توانست منجر به تبدیل‌های دو یا سه‌بعدی شود. از PROJ 9.1 به بعد، هر دو CRS باید سه‌بعدی باشند تا تبدیل عمودی امکان‌پذیر باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-id=AUTH:NAME در نسخهٔ 8.1 اضافه شده است. .sp شناسه‌ای برای انتساب به شیء (برای خروجی SQL). .sp اکیداً توصیه می‌شود که اشیاء جدید به مراجع ثبت مشترک مانند \fBEPSG\fP، \fBESRI\fP، \fBIAU\fP و غیره اضافه نشوند. کاربران باید در عوض از یک نام مرجع سفارشی استفاده کنند. اگر نیاز است شیء جدیدی به مرجع رسمی EPSG اضافه شود، از کاربران دعوت می‌شود تا روال توضیح داده شده در \%\& را دنبال کنند. .sp در ترکیب با \fB\-\-dump\-db\-structure\fP، کاربران می‌توانند به جای تغییر مستقیم پایگاه داده اصلی \fBproj.db\fP، پایگاه‌های داده کمکی ایجاد کنند. مثال مربوط به نحوه برون‌بری به یک پایگاه داده کمکی را ببینید\&. .sp این پایگاه‌های داده کمکی را می‌توان از طریق \fBproj_context_set_database_path()\fP یا متغیر محیطی \fBPROJ_AUX_DB\fP \%<#\:envvar-PROJ_AUX_DB> تعیین کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-c\-ify فقط برای توسعه‌دهندگان. خروجی رشته‌ای ابزار را به گونه‌ای تغییر می‌دهد که قرار دادن آن رشته‌ها در کد C/C++ آسان باشد. .UNINDENT .INDENT 0.0.TP .B \-\-single\-line رشته‌های PROJ،‏ WKT یا PROJJSON را به جای حالت پیش‌فرض (چندین خط با تورفتگی)، در یک خط واحد خروجی می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-searchpaths در نسخه 7.0 اضافه شد. .sp دایرکتوری‌هایی را خروجی می‌دهد که منابع PROJ در آن‌ها جستجو خواهند شد (در صورت عدم استفاده از C API مانند \fBproj_context_set_search_paths()\fP که آن‌ها را بازنویسی می‌کند). .UNINDENT .INDENT 0.0 .TP .B \-\-remote\-data در نسخه 7.0 اضافه شد. .sp اطلاعات مربوط به فعال بودن یا نبودن قابلیت‌های شبکه \%<#\:network> و نشانی URL مربوطه را نمایش می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-s_epoch در نسخه 9.4 اضافه شد. .sp مبدأ زمانی (Epoch) مختصات در CRS مبدأ، به صورت سال اعشاری. تنها برای یک CRS پویا اعمال می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-t_epoch در نسخه 9.4 اضافه شد. .sp مبدأ زمانی (Epoch) مختصات در CRS مقصد، به صورت سال اعشاری. تنها برای یک CRS پویا اعمال می‌شود. .UNINDENT .SH "مثال‌ها (EXAMPLES)" .INDENT 0.0 .IP 1. 3 پرس‌وجوی شیء CRS متناظر با EPSG:4326 .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX projinfo EPSG:4326 .EE .UNINDENT .UNINDENT .sp خروجی: .INDENT 0.0 .INDENT 3.5 .sp .EX PROJ.4 string: +proj=longlat +datum=WGS84 +no_defs +type=crs WKT2:2019 string: GEOGCRS[\(dqWGS 84\(dq, DATUM[\(dqWorld Geodetic System 1984\(dq, ELLIPSOID[\(dqWGS 84\(dq,6378137,298.257223563, LENGTHUNIT[\(dqmetre\(dq,1]]], PRIMEM[\(dqGreenwich\(dq,0, ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]], CS[ellipsoidal,2], AXIS[\(dqgeodetic latitude (Lat)\(dq,north, ORDER[1], ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]], AXIS[\(dqgeodetic longitude (Lon)\(dq,east, ORDER[2], ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]], USAGE[ SCOPE[\(dqunknown\(dq], AREA[\(dqWorld\(dq], BBOX[\-90,\-180,90,180]], ID[\(dqEPSG\(dq,4326]] .EE .UNINDENT .UNINDENT .INDENT 0.0 .IP 2. 3 فهرست کردن عملیات‌های مختصات بین NAD27 (مشخص‌شده با نام CRS آن) و NAD83 (مشخص‌شده با کد EPSG آن: 4269) درون یک منطقه مورد نظر .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX projinfo \-s NAD27 \-t EPSG:4269 \-\-area \(dqUSA \- Missouri\(dq .EE .UNINDENT .UNINDENT .sp خروجی: .INDENT 0.0 .INDENT 3.5 .sp .EX DERIVED_FROM(EPSG):1241, NAD27 to NAD83 (1), 0.15 m, USA \- CONUS including EEZ PROJ string: +proj=pipeline +step +proj=axisswap +order=2,1 +step +proj=unitconvert \e +xy_in=deg +xy_out=rad +step +proj=hgridshift +grids=conus \e +step +proj=unitconvert +xy_in=rad +xy_out=deg +step +proj=axisswap +order=2,1 WKT2:2019 string: COORDINATEOPERATION[\(dqNAD27 to NAD83 (1)\(dq, SOURCECRS[ GEOGCRS[\(dqNAD27\(dq, DATUM[\(dqNorth American Datum 1927\(dq, ELLIPSOID[\(dqClarke 1866\(dq,6378206.4,294.978698213898, LENGTHUNIT[\(dqmetre\(dq,1]]], PRIMEM[\(dqGreenwich\(dq,0, ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]], CS[ellipsoidal,2], AXIS[\(dqgeodetic latitude (Lat)\(dq,north, ORDER[1], ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]], AXIS[\(dqgeodetic longitude (Lon)\(dq,east, ORDER[2], ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]]]], TARGETCRS[ GEOGCRS[\(dqNAD83\(dq, DATUM[\(dqNorth American Datum 1983\(dq, ELLIPSOID[\(dqGRS 1980\(dq,6378137,298.257222101, LENGTHUNIT[\(dqmetre\(dq,1]]], PRIMEM[\(dqGreenwich\(dq,0, ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]], CS[ellipsoidal,2], AXIS[\(dqgeodetic latitude (Lat)\(dq,north, ORDER[1], ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]], AXIS[\(dqgeodetic longitude (Lon)\(dq,east, ORDER[2], ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]]]], METHOD[\(dqCTABLE2\(dq], PARAMETERFILE[\(dqLatitude and longitude difference file\(dq,\(dqconus\(dq], OPERATIONACCURACY[0.15], USAGE[ SCOPE[\(dqunknown\(dq], AREA[\(dqUSA \- CONUS including EEZ\(dq], BBOX[23.81,\-129.17,49.38,\-65.69]], ID[\(dqDERIVED_FROM(EPSG)\(dq,1241]] .EE .UNINDENT .UNINDENT .INDENT 0.0 .IP 3. 3 برون‌بری یک شیء به صورت یک رشته PROJJSON .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX projinfo GDA94 \-o PROJJSON \-q .EE .UNINDENT .UNINDENT .sp خروجی: .INDENT 0.0 .INDENT 3.5 .sp .EX { \(dqtype\(dq: \(dqGeographicCRS\(dq, \(dqname\(dq: \(dqGDA94\(dq, \(dqdatum\(dq: { \(dqtype\(dq: \(dqGeodeticReferenceFrame\(dq, \(dqname\(dq: \(dqGeocentric Datum of Australia 1994\(dq, \(dqellipsoid\(dq: { \(dqname\(dq: \(dqGRS 1980\(dq, \(dqsemi_major_axis\(dq: 6378137, \(dqinverse_flattening\(dq: 298.257222101 } }, \(dqcoordinate_system\(dq: { \(dqsubtype\(dq: \(dqellipsoidal\(dq, \(dqaxis\(dq: [ { \(dqname\(dq: \(dqGeodetic latitude\(dq, \(dqabbreviation\(dq: \(dqLat\(dq, \(dqdirection\(dq: \(dqnorth\(dq, \(dqunit\(dq: \(dqdegree\(dq }, { \(dqname\(dq: \(dqGeodetic longitude\(dq, \(dqabbreviation\(dq: \(dqLon\(dq, \(dqdirection\(dq: \(dqeast\(dq, \(dqunit\(dq: \(dqdegree\(dq } ] }, \(dqarea\(dq: \(dqAustralia \- GDA\(dq, \(dqbbox\(dq: { \(dqsouth_latitude\(dq: \-60.56, \(dqwest_longitude\(dq: 93.41, \(dqnorth_latitude\(dq: \-8.47, \(dqeast_longitude\(dq: 173.35 }, \(dqid\(dq: { \(dqauthority\(dq: \(dqEPSG\(dq, \(dqcode\(dq: 4283 } } .EE .UNINDENT .UNINDENT .INDENT 0.0.IP 4. 3 برون‌ریزی دستورات SQL برای درج یک CRS جدید در یک پایگاه‌داده کمکی. .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX # Get the SQL statements for a custom CRS projinfo \(dq+proj=merc +lat_ts=5 +datum=WGS84 +type=crs +title=my_crs\(dq \-\-output\-id HOBU:MY_CRS \-o SQL \-q > my_crs.sql cat my_crs.sql # Initialize an auxiliary database with the schema of the reference database echo \(dq.schema\(dq | sqlite3 /path/to/proj.db | sqlite3 aux.db # Append the content of the definition of HOBU:MY_CRS sqlite3 aux.db < my_crs.db # Check that everything works OK projinfo \-\-aux\-db\-path aux.db HOBU:MY_CRS .EE .UNINDENT .UNINDENT .sp یا ساده‌تر: .INDENT 0.0 .INDENT 3.5 .sp .EX # Create an auxiliary database with the definition of a custom CRS. projinfo \(dq+proj=merc +lat_ts=5 +datum=WGS84 +type=crs +title=my_crs\(dq \-\-output\-id HOBU:MY_CRS \-\-dump\-db\-structure | sqlite3 aux.db # Check that everything works OK projinfo \-\-aux\-db\-path aux.db HOBU:MY_CRS .EE .UNINDENT .UNINDENT .sp خروجی: .INDENT 0.0 .INDENT 3.5 .sp .EX INSERT INTO geodetic_crs VALUES(\(aqHOBU\(aq,\(aqGEODETIC_CRS_MY_CRS\(aq,\(aqunknown\(aq,\(aq\(aq,\(aqgeographic 2D\(aq,\(aqEPSG\(aq,\(aq6424\(aq,\(aqEPSG\(aq,\(aq6326\(aq,NULL,0); INSERT INTO usage VALUES(\(aqHOBU\(aq,\(aqUSAGE_GEODETIC_CRS_MY_CRS\(aq,\(aqgeodetic_crs\(aq,\(aqHOBU\(aq,\(aqGEODETIC_CRS_MY_CRS\(aq,\(aqPROJ\(aq,\(aqEXTENT_UNKNOWN\(aq,\(aqPROJ\(aq,\(aqSCOPE_UNKNOWN\(aq); INSERT INTO conversion VALUES(\(aqHOBU\(aq,\(aqCONVERSION_MY_CRS\(aq,\(aqunknown\(aq,\(aq\(aq,\(aqEPSG\(aq,\(aq9805\(aq,\(aqMercator (variant B)\(aq,\(aqEPSG\(aq,\(aq8823\(aq,\(aqLatitude of 1st standard parallel\(aq,5,\(aqEPSG\(aq,\(aq9122\(aq,\(aqEPSG\(aq,\(aq8802\(aq,\(aqLongitude of natural origin\(aq,0,\(aqEPSG\(aq,\(aq9122\(aq,\(aqEPSG\(aq,\(aq8806\(aq,\(aqFalse easting\(aq,0,\(aqEPSG\(aq,\(aq9001\(aq,\(aqEPSG\(aq,\(aq8807\(aq,\(aqFalse northing\(aq,0,\(aqEPSG\(aq,\(aq9001\(aq,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,NULL,0); INSERT INTO usage VALUES(\(aqHOBU\(aq,\(aqUSAGE_CONVERSION_MY_CRS\(aq,\(aqconversion\(aq,\(aqHOBU\(aq,\(aqCONVERSION_MY_CRS\(aq,\(aqPROJ\(aq,\(aqEXTENT_UNKNOWN\(aq,\(aqPROJ\(aq,\(aqSCOPE_UNKNOWN\(aq); INSERT INTO projected_crs VALUES(\(aqHOBU\(aq,\(aqMY_CRS\(aq,\(aqmy_crs\(aq,\(aq\(aq,\(aqEPSG\(aq,\(aq4400\(aq,\(aqHOBU\(aq,\(aqGEODETIC_CRS_MY_CRS\(aq,\(aqHOBU\(aq,\(aqCONVERSION_MY_CRS\(aq,NULL,0); INSERT INTO usage VALUES(\(aqHOBU\(aq,\(aqUSAGE_PROJECTED_CRS_MY_CRS\(aq,\(aqprojected_crs\(aq,\(aqHOBU\(aq,\(aqMY_CRS\(aq,\(aqPROJ\(aq,\(aqEXTENT_UNKNOWN\(aq,\(aqPROJ\(aq,\(aqSCOPE_UNKNOWN\(aq); .EE .UNINDENT .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX PROJ.4 string: +proj=merc +lat_ts=5 +lon_0=0 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs +type=crs WKT2:2019 string: PROJCRS[\(dqmy_crs\(dq, BASEGEOGCRS[\(dqunknown\(dq, ENSEMBLE[\(dqWorld Geodetic System 1984 ensemble\(dq, MEMBER[\(dqWorld Geodetic System 1984 (Transit)\(dq], MEMBER[\(dqWorld Geodetic System 1984 (G730)\(dq], MEMBER[\(dqWorld Geodetic System 1984 (G873)\(dq], MEMBER[\(dqWorld Geodetic System 1984 (G1150)\(dq], MEMBER[\(dqWorld Geodetic System 1984 (G1674)\(dq], MEMBER[\(dqWorld Geodetic System 1984 (G1762)\(dq], ELLIPSOID[\(dqWGS 84\(dq,6378137,298.257223563, LENGTHUNIT[\(dqmetre\(dq,1]], ENSEMBLEACCURACY[2.0]], PRIMEM[\(dqGreenwich\(dq,0, ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433]], ID[\(dqHOBU\(dq,\(dqGEODETIC_CRS_MY_CRS\(dq]], CONVERSION[\(dqunknown\(dq, METHOD[\(dqMercator (variant B)\(dq, ID[\(dqEPSG\(dq,9805]], PARAMETER[\(dqLatitude of 1st standard parallel\(dq,5, ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433], ID[\(dqEPSG\(dq,8823]], PARAMETER[\(dqLongitude of natural origin\(dq,0, ANGLEUNIT[\(dqdegree\(dq,0.0174532925199433], ID[\(dqEPSG\(dq,8802]], PARAMETER[\(dqFalse easting\(dq,0, LENGTHUNIT[\(dqmetre\(dq,1], ID[\(dqEPSG\(dq,8806]], PARAMETER[\(dqFalse northing\(dq,0, LENGTHUNIT[\(dqmetre\(dq,1], ID[\(dqEPSG\(dq,8807]]], CS[Cartesian,2], AXIS[\(dq(E)\(dq,east, ORDER[1], LENGTHUNIT[\(dqmetre\(dq,1]], AXIS[\(dq(N)\(dq,north, ORDER[2], LENGTHUNIT[\(dqmetre\(dq,1]], ID[\(dqHOBU\(dq,\(dqMY_CRS\(dq]] .EE .UNINDENT .UNINDENT .INDENT 0.0 .IP 5. 3 دریافت بازنمایی WKT از EPSG:25832 در قالب خروجی WKT1:GDAL و در یک خط .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX projinfo \-o WKT1:GDAL \-\-single\-line EPSG:25832 .EE .UNINDENT .UNINDENT .sp خروجی: .INDENT 0.0 .INDENT 3.5 .sp .EX WKT1:GDAL string: PROJCS[\(dqETRS89 / UTM zone 32N\(dq,GEOGCS[\(dqETRS89\(dq,DATUM[\(dqEuropean_Terrestrial_Reference_System_1989\(dq,SPHEROID[\(dqGRS 1980\(dq,6378137,298.257222101,AUTHORITY[\(dqEPSG\(dq,\(dq7019\(dq]],AUTHORITY[\(dqEPSG\(dq,\(dq6258\(dq]],PRIMEM[\(dqGreenwich\(dq,0,AUTHORITY[\(dqEPSG\(dq,\(dq8901\(dq]],UNIT[\(dqdegree\(dq,0.0174532925199433,AUTHORITY[\(dqEPSG\(dq,\(dq9122\(dq]],AUTHORITY[\(dqEPSG\(dq,\(dq4258\(dq]],PROJECTION[\(dqTransverse_Mercator\(dq],PARAMETER[\(dqlatitude_of_origin\(dq,0],PARAMETER[\(dqcentral_meridian\(dq,9],PARAMETER[\(dqscale_factor\(dq,0.9996],PARAMETER[\(dqfalse_easting\(dq,500000],PARAMETER[\(dqfalse_northing\(dq,0],UNIT[\(dqmetre\(dq,1,AUTHORITY[\(dqEPSG\(dq,\(dq9001\(dq]],AXIS[\(dqEasting\(dq,EAST],AXIS[\(dqNorthing\(dq,NORTH],AUTHORITY[\(dqEPSG\(dq,\(dq25832\(dq]] .EE .UNINDENT .UNINDENT.SH "همچنین ببینید (SEE ALSO)" .sp \fBcs2cs(1)\fP, \fBcct(1)\fP, \fBgeod(1)\fP, \fBgie(1)\fP, \fBproj(1)\fP, \fBprojsync(1)\fP .SH "گزارش باگ‌ها (BUGS)" .sp فهرستی از باگ‌های شناخته‌شده در \% در دسترس است که گزارش باگ‌های جدید را نیز می‌توان در آنجا ارسال کرد. .SH "صفحه اصلی (HOME PAGE)" .sp \% .SH "نویسنده (AUTHOR)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1983-2026، مشارکت‌کنندگان PROJ .\" End of generated man page.