.\" Man page generated from reStructuredText. . . .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 "GDALTRANSFORM" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdaltransform \- تبدیل مختصات .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdaltransform [\-\-help] [\-\-help\-general] [\-i] [\-s_srs ] [\-t_srs ] [\-to =]... [\-s_coord_epoch ] [\-t_coord_epoch ] [\-ct ] [\-order ] [\-tps] [\-rpc] [\-geoloc] [\-gcp [elevation]]... [\-output_xy] [\-E] [\-field_sep ] [\-ignore_extra_input] [ []] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp ابزار .B gdaltransform فهرستی از مختصات را به هر سیستم تصویر پشتیبانی‌شده، از جمله تبدیل‌های مبتنی بر نقاط کنترل زمینی (GCP)، بازتصویر می‌کند. .INDENT 0.0 .TP .B \-\-help نمایش پیام راهنما و خروج. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-general نمایش خلاصه نحوه استفاده برای گزینه‌های عمومی خط فرمان GDAL و خروج. .UNINDENT .INDENT 0.0 .TP .B \-s_srs تنظیم مرجع مکانی مبدأ. سیستم‌های مختصاتی قابل ارسال شامل هر موردی است که توسط فراخوانی .B OGRSpatialReference.SetFromUserInput() پشتیبانی می‌شود؛ از جمله EPSG PCS و GCSها (مانند .BR EPSG:4296 )، تعاریف PROJ.4 یا نام یک فایل .B .prj حاوی متن شناخته‌شده (WKT). .UNINDENT .INDENT 0.0 .TP .B \-s_coord_epoch در نسخه 3.8 اضافه شد. .sp تخصیص مبدأ زمانی مختصات (Epoch)، متصل به SRS مبدأ. زمانی مفید است که SRS مبدأ یک CRS پویا باشد. تنها زمانی در نظر گرفته می‌شود که .B \-s_srs استفاده شده باشد. .sp پیش از PROJ 9.4، گزینه‌های .B \-s_coord_epoch و .B \-t_coord_epoch به دلیل عدم پشتیبانی از تبدیل بین دو CRS پویا، مانعة‌الجمع بودند. .UNINDENT .INDENT 0.0 .TP .B \-t_srs تنظیم مرجع مکانی مقصد. سیستم‌های مختصاتی قابل ارسال شامل هر موردی است که توسط فراخوانی .B OGRSpatialReference.SetFromUserInput() پشتیبانی می‌شود؛ از جمله EPSG PCS و GCSها (مانند .BR EPSG:4296 )، تعاریف PROJ.4 یا نام یک فایل .B .prj حاوی متن شناخته‌شده (WKT). .UNINDENT .INDENT 0.0 .TP .B \-t_coord_epoch در نسخه 3.8 اضافه شد. .sp تخصیص مبدأ زمانی مختصات (Epoch)، متصل به SRS خروجی. زمانی مفید است که SRS خروجی یک CRS پویا باشد. تنها زمانی در نظر گرفته می‌شود که .B \-t_srs استفاده شده باشد. .sp پیش از PROJ 9.4، گزینه‌های .B \-s_coord_epoch و .B \-t_coord_epoch به دلیل عدم پشتیبانی از تبدیل بین دو CRS پویا، مانعة‌الجمع بودند. .UNINDENT .INDENT 0.0 .TP .B \-ct یک رشته PROJ (عملیات تک‌مرحله‌ای یا رشته چندمرحله‌ای که با .B +proj=pipeline شروع می‌شود)، یک رشته WKT2 که توصیف‌کننده CoordinateOperation است، یا یک URN به‌صورت .B urn:ogc:def:coordinateOperation:EPSG::XXXX که تبدیل پیش‌فرض از CRS مبدأ به مقصد را بازنویسی می‌کند. این گزینه باید ترتیب محورهای CRS مبدأ و مقصد را در نظر بگیرد. .sp در نسخه 3.0 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-to = تنظیم گزینه تبدیل‌کننده مناسب برای ارسال به .BR GDALCreateGenImgProjTransformer2() . .UNINDENT .INDENT 0.0 .TP .B \-order مرتبه چندجمله‌ای مورداستفاده برای پیچش و تغییر شکل (۱ تا ۳). حالت پیش‌فرض، انتخاب مرتبه چندجمله‌ای بر اساس تعداد GCPها است. .UNINDENT .INDENT 0.0 .TP .B \-tps اجبار به استفاده از تبدیل‌کننده اسپلاین صفحه نازک (Thin Plate Spline) بر اساس GCPهای موجود. .UNINDENT .INDENT 0.0 .TP .B \-rpc اجبار به استفاده از RPCها. .UNINDENT .INDENT 0.0 .TP .B \-geoloc اجبار به استفاده از آرایه‌های موقعیت جغرافیایی (Geolocation Arrays). .UNINDENT .INDENT 0.0 .TP .B \-i تبدیل معکوس: از مقصد به مبدأ. .UNINDENT .INDENT 0.0 .TP .B \-gcp [] ارائه یک نقطه کنترل زمینی (GCP) برای استفاده در تبدیل (معمولاً سه یا بیشتر مورد نیاز است). نیازی نیست که پیکسل و سطر عدد صحیح باشند. .UNINDENT .INDENT 0.0 .TP .B \-output_xy محدود کردن خروجی به \(dqx y\(dq به جای \(dqx y z\(dq. .UNINDENT .INDENT 0.0 .TP .B \-ignore_extra_input در نسخه 3.9 اضافه شد. .sp تنظیم این فلگ برای جلوگیری از اضافه شدن محتوای غیرعددی اضافی در انتهای خطوط ورودی به خطوط خروجی. .UNINDENT .INDENT 0.0 .TP .B \-E در نسخه 3.9 اضافه شد. .sp فعال‌سازی حالت اکو (Echo)، که در آن مختصات ورودی به ابتدای خطوط خروجی اضافه می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-field_sep در نسخه 3.9 اضافه شد. .sp تعیین جداکننده فیلدها جهت تفکیک مقادیر مختلف. مقدار پیش‌فرض کاراکتر فاصله (Space) است. .UNINDENT .INDENT 0.0 .TP .B مجموعه‌داده رستر حاوی تعریف سیستم تصویر مبدأ یا GCPها. در صورت عدم ارائه، سیستم تصویر یا GCPهای مبدأ از پارامترهای خط فرمان .B \-s_srs یا .B \-gcp خوانده می‌شوند. .sp توجه داشته باشید که تنها SRS و/یا GCPهای این فایل ورودی در نظر گرفته می‌شوند و محتوای پیکسلی آن خوانده نمی‌شود. .UNINDENT .INDENT 0.0 .TP .B مجموعه‌داده رستر حاوی تعریف سیستم تصویر مقصد. .UNINDENT .sp مختصات به‌صورت جفت، سه‌تایی (برای سه‌بعدی) یا (از GDAL 3.0.0 به بعد) چهارتایی (برای X, Y, Z, زمان) از اعداد در هر خط از ورودی استاندارد خوانده شده، تبدیل می‌شوند و به همان صورت در خروجی استاندارد نوشته می‌شوند. تمامی تبدیل‌های ارائه‌شده توسط gdalwarp از جمله تبدیل‌های مبتنی بر GCP پشتیبانی می‌شوند. .sp از GDAL 3.9 به بعد، محتوای غیرعددی اضافی (معمولاً نام نقطه) در انتهای خط ورودی نیز به خط خروجی افزوده خواهد شد، مگر اینکه گزینه .B \-ignore_extra_input اضافه شده باشد. .sp توجه داشته باشید که ورودی و خروجی همیشه باید به صورت اعشاری (Decimal) باشند. در حال حاضر هیچ پشتیبانی از ورودی یا خروجی درجه/دقیقه/ثانیه (DMS) وجود ندارد. .sp اگر یک فایل تصویر ورودی ارائه شود، ورودی بر اساس مختصات پیکسل/سطر آن تصویر است. اگر فایل خروجی ارائه شود، خروجی بر اساس مختصات پیکسل/سطر آن تصویر خواهد بود. .SH "کدهای وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا کد غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال بازتصویر (Reprojection Example)" .sp بازتصویر ساده از یک سیستم مختصات تصویرشده به سیستم دیگر: .INDENT 0.0 .INDENT 3.5 .sp .EX gdaltransform \-s_srs EPSG:28992 \-t_srs EPSG:31370 177502 311865 .EE .UNINDENT .UNINDENT .sp خروجی زیر را بر حسب متر در سیستم تصویر \(dqBelge 1972 / Belgian Lambert 72\(dq تولید می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX 244296.724777415 165937.350217148 0 .EE .UNINDENT .UNINDENT .SS "مثال RPC تصویر (Image RPC Example)" .sp دستور زیر یک تبدیل مبتنی بر RPC را با استفاده از مدل RPC مرتبط با فایل مشخص‌شده درخواست می‌کند. از آنجا که فلگ .B \-i (معکوس) استفاده شده است، تبدیل از مختصات زمین‌مرجع خروجی (WGS84) به مختصات تصویر بازمی‌گردد. .INDENT 0.0 .INDENT 3.5 .sp .EX gdaltransform \-i \-rpc 06OCT20025052\-P2AS\-005553965230_01_P001.TIF 125.67206 39.85307 50 .EE .UNINDENT .UNINDENT .sp این خروجی را بر حسب پیکسل و سطر روی تصویر تولید می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX 3499.49282422381 2910.83892848414 50 .EE .UNINDENT .UNINDENT .SS "تبدیل X,Y,Z و زمان (X,Y,Z,time transform)" .sp تبدیل مختصات هلمرت ۱۵ مؤلفه‌ای وابسته به زمان از ITRF2000 به ITRF93 برای مختصاتی در مبدأ زمانی (Epoch) 2000.0: .INDENT 0.0 .INDENT 3.5 .sp .EX gdaltransform \-ct \(dq+proj=pipeline +step +proj=unitconvert +xy_in=deg \e +xy_out=rad +step +proj=cart +step +proj=helmert +convention=position_vector \e +x=0.0127 +dx=\-0.0029 +rx=\-0.00039 +drx=\-0.00011 +y=0.0065 +dy=\-0.0002 \e +ry=0.00080 +dry=\-0.00019 +z=\-0.0209 +dz=\-0.0006 +rz=\-0.00114 +drz=0.00007 \e +s=0.00195 +ds=0.00001 +t_epoch=1988.0 +step +proj=cart +inv +step \e +proj=unitconvert +xy_in=rad +xy_out=deg\(dq 2 49 0 2000 .EE .UNINDENT .UNINDENT .sp این خروجی را بر حسب درجه طول جغرافیایی، درجه عرض جغرافیایی و ارتفاع بیضوی بر حسب متر تولید می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX 2.0000005420366 49.0000003766711 \-0.0222802283242345 .EE .UNINDENT .UNINDENT .SS "نقاط کنترل زمینی (Ground control points)" .sp هدف: یافتن یک نشانی و تخصیص نشانی دیگر. ما سالت‌لیک‌سیتی را انتخاب می‌کنیم، جایی که نام خیابان‌ها \fIهمان\fP مقادیر شبکه مختصات آن‌ها است. ابتدا چند نقطه کنترل زمینی در تقاطع خیابان‌ها ایجاد می‌کنیم. برای استفاده مجدد آسان از GCPهای خود از .B \-\-optfile استفاده خواهیم کرد: .INDENT 0.0 .INDENT 3.5 .sp .EX echo \-output_xy \e \-gcp 0 0 \-111.89114717 40.76932606 \e \-gcp 0 \-500 \-111.89114803 40.75846686 \e \-gcp 500 0 \-111.87685039 40.76940631 > optfile.txt .EE .UNINDENT .UNINDENT .sp نشانی \(dq370 S. 300 E.\(dq کجاست؟ .INDENT 0.0 .INDENT 3.5 .sp .EX echo 300 \-370 Address 370 S. 300 E. | gdaltransform \-\-optfile optfile.txt \-111.8825697384 40.761338402 Address 370 S. 300 E. .EE .UNINDENT .UNINDENT .sp (عدد 370 با قرار دادن یک کلمه قبل از آن، از خوانده شدن به عنوان ارتفاع محافظت می‌شود.) .sp در نزدیکی آنجا، یک ساختمان نوساز نیاز به تخصیص نشانی دارد. از .B \-i استفاده می‌کنیم: .INDENT 0.0 .INDENT 3.5 .sp .EX echo \-111.88705 40.76502 Building ABC123 | gdaltransform \-i \-\-optfile optfile.txt 143.301947786644 \-199.32683635161 Building ABC123 .EE .UNINDENT .UNINDENT .sp (یعنی 143 E. 200 S. یا اگر در آن سوی خیابان باشد 144.) .SH "نویسندگان (AUTHORS)" Frank Warmerdam , Jan Hartmann .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .