GDALMOVE(1) GDAL GDALMOVE(1)

gdalmove - تبدیل در‌جای ارجاع مکانی فایل رستر

gdalmove [--help] [--help-general]
            [-s_srs <srs_defn>] -t_srs <srs_defn>
            [-et <max_pixel_err>] <target_file>

اسکریپت gdalmove مرزهای یک فایل رستر را از یک دستگاه مختصات به دستگاه دیگر تبدیل کرده و سپس دستگاه مختصات و geotransform فایل را به‌روزرسانی می‌کند. این کار بدون هیچ‌گونه تغییری در مقادیر پیکسل‌ها انجام می‌شود. این فرآیند تا حدی شبیه به استفاده از gdalwarp برای تبدیل تصویر است، با این تفاوت که جهت جلوگیری از افت کیفیت تصویر، از مرحله بازنمونه‌برداری (resampling) اجتناب می‌شود. این ابزار عموماً تنها برای تبدیل‌هایی مناسب است که در محدوده فایل ماهیتی عملاً خطی داشته باشند.

اگر مقدار آستانه خطایی (-et) مشخص نشود، فایل در عمل به‌روزرسانی نمی‌شود، بلکه خطاهایی که ممکن است به وجود آیند گزارش می‌شوند. اگر -et مشخص شده باشد، فایل تنها در صورتی تغییر داده می‌شود که خطای ظاهری ایجادشده کمتر از آستانه مشخص‌شده (برحسب پیکسل) باشد.

در حال حاضر، geotransform تبدیل‌شده بر اساس تبدیل مختصات گوشه‌های بالا-چپ، بالا-راست و پایین-چپ محاسبه می‌شود. می‌توان با استفاده از برازش کمترین مربعات حداقل بر روی هر چهار نقطه گوشه، خطای کلی کمتری به دست آورد.

نکته:

ابزار gdalmove یک اسکریپت پایتون است و تنها در صورتی در دسترس خواهد بود که بایندینگ‌های پایتون GDAL نصب شده باشند.
نمایش این پیام راهنما و خروج
--help-general
نمایش پیام کوتاهی درباره نحوه استفاده از گزینه‌های عمومی خط فرمان GDAL و خروج
جایگزین کردن دستگاه مختصات فایل با تعریف دستگاه مختصات مشخص‌شده. اختیاری است. در صورت مشخص نشدن، دستگاه مختصات مبدأ از فایل مبدأ خوانده می‌شود.
دستگاه مختصات مقصد را تعریف می‌کند. این دستگاه مختصات پس از به‌روزرسانی روی فایل نوشته خواهد شد.
آستانه خطا (برحسب پیکسل) که فراتر از آن، فایل به‌روزرسانی نخواهد شد. در صورت عدم تعیین، هیچ به‌روزرسانی روی فایل اعمال نمی‌شود، اما خطاها گزارش خواهند شد.

<target_file>

فایلی که عملیات روی آن انجام می‌شود. جهت به‌روزرسانی، فرمت فایل باید از به‌روزرسانی در‌جای geotransform و SRS پشتیبانی کند.

این برنامه در صورت موفقیت مقدار 0 و در صورت بروز خطا مقداری غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده‌ای که به عنوان هشدار ارسال می‌شوند، اجرای موفق در نظر گرفته می‌شوند).

Frank Warmerdam <warmerdam@pobox.com>

1998-2026

August 18, 2026