نام (NAME)

gdal-raster-update - به‌روزرسانی رستر مقصد با محتوای رستر ورودی

افزوده‌شده در نگارش 3.12.

خلاصه دستور (SYNOPSIS)

کاربرد: gdal raster update [گزینه‌ها] <INPUT> <OUTPUT>
به‌روزرسانی رستر مقصد با محتوای رستر ورودی.
آرگومان‌های موضعی:
  -i, --input <INPUT>                        مجموعه داده‌های رستر ورودی [الزامی] [در خطوط لوله در دسترس نیست]
  -o, --output <OUTPUT>                      مجموعه داده رستر خروجی [الزامی]
گزینه‌های عمومی:
  -h, --help                                 نمایش پیام راهنما و خروج
  --json-usage                               نمایش شیوه استفاده به صورت سند JSON و خروج
  --config <KEY>=<VALUE>                     گزینه پیکربندی [تکرارپذیر]
  -q, --quiet                                حالت بی‌صدا (عدم نمایش نوار پیشرفت یا پیام‌های هشدار) [در خطوط لوله در دسترس نیست]
گزینه‌ها:
  --geometry <GEOMETRY>                      هندسه برش (WKT یا GeoJSON)
  --geometry-crs <GEOMETRY-CRS>              سامانه مرجع مختصات (CRS) هندسه برش
  -r, --resampling <RESAMPLING>              روش بازنمونه‌برداری. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum (پیش‌فرض: nearest)
  --no-update-overviews                      عدم به‌روزرسانی پیش‌نمایش‌های موجود
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>        قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  --oo, --open-option <KEY>=<VALUE>          گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست]
  --wo, --warp-option <NAME>=<VALUE>         گزینه(های) تابیدگی (Warping) [تکرارپذیر]
  --to, --transform-option <NAME>=<VALUE>    گزینه(های) تبدیل (Transform) [تکرارپذیر]
  --et, --error-threshold <ERROR-THRESHOLD>  آستانه خطا

توضیحات (DESCRIPTION)

دستور gdal raster update می‌تواند برای به‌روزرسانی یک مجموعه داده رستر خروجی موجود با مقادیر پیکسل‌های رستر ورودی استفاده شود، و در صورتی که سامانه‌های مرجع مختصات مجموعه داده‌های ورودی و خروجی یکسان نباشند، بازتصویرسازی (reprojection) را انجام می‌دهد. محدوده (extent)، اندازه، وضوح یا سامانه مرجع مختصات مجموعه داده خروجی با این عملیات تغییر نمی‌کند.

پیش‌نمایش‌ها (Overviews) توسط این دستور به‌روزرسانی می‌شوند (با استفاده از gdal raster overview refresh)، مگر اینکه گزینه --no-update-overviews مشخص شده باشد.

از نگارش GDAL 3.13 به بعد، gdal raster update می‌تواند به عنوان مرحله‌ای از یک خط لوله (pipeline) استفاده شود که در آن مجموعه داده ورودی همان خروجی مرحله پیشین است.

گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)

--et, --error-threshold <ERROR-THRESHOLD>: آستانه خطا برای تقریب تبدیل، که بر حسب تعداد پیکسل‌های ورودی بیان می‌شود. پیش‌فرض 0.125 پیکسل است مگر اینکه گزینه تبدیل‌کننده RPC_DEM مشخص شده باشد که در آن صورت یک تبدیل‌کننده دقیق، یعنی --error-threshold=0، استفاده خواهد شد.

--geometry <WKT_or_GeoJSON>: هندسه به صورت یک رشته WKT یا GeoJSON از یک چندضلعی (یا چندچندضلعی) که به‌روزرسانی به آن محدود می‌شود. اگر هندسه ورودی GeoJSON باشد، فرض می‌شود که CRS آن WGS84 است مگر اینکه یک CRS در هندسه GeoJSON تعریف شده باشد یا --geometry-crs مشخص گردد. اگر هندسه ورودی WKT باشد، فرض می‌شود که CRS آن همان CRS مجموعه داده ورودی است مگر اینکه --geometry-crs مشخص شود. محورهای X و Y بر اساس استانداردهای سازگار با GIS هستند، بدین معنا که X طول جغرافیایی (یا مختصات شرقی) و Y عرض جغرافیایی (یا مختصات شمالی) است.

--geometry-crs <CRS>: سامانه مرجع مختصات (CRS) که مقادیر مختصات --geometry بر حسب آن بیان شده‌اند. اگر مشخص نشود، فرض می‌شود که همان CRS مجموعه داده ورودی است. هندسه از geometry-crs به CRS مجموعه داده در حال به‌روزرسانی بازتصویرسازی خواهد شد.

--no-update-overviews: عدم به‌روزرسانی پیش‌نمایش‌های موجود.

--to, --transform-option <NAME>=<VALUE>: تنظیم یک گزینه تبدیل‌کننده مناسب برای ارسال به GDALCreateGenImgProjTransformer2(). برای گزینه‌های خاص RPC به GDALCreateRPCTransformerV2() مراجعه کنید.

-r, --resampling <RESAMPLING>

روش بازنمونه‌برداری مورد استفاده. روش‌های موجود عبارتند از:

nearest: بازنمونه‌برداری نزدیک‌ترین همسایه (پیش‌فرض، سریع‌ترین الگوریتم، کمترین کیفیت درون‌یابی).

bilinear: بازنمونه‌برداری دوخطی.

cubic: بازنمونه‌برداری مکعبی.

cubicspline: بازنمونه‌برداری اسپلاین مکعبی.

lanczos: بازنمونه‌برداری پنجره‌ای سینک لانچوس.

average: بازنمونه‌برداری میانگین، میانگین وزن‌دار تمام پیکسل‌های مؤثر غیر-NODATA را محاسبه می‌کند.

rms: جذر میانگین مربعات / میانگین درجه دوم تمام پیکسل‌های مؤثر غیر-NODATA.

mode: بازنمونه‌برداری نما (مد)، مقداری را انتخاب می‌کند که بیشترین تکرار را در تمام نقاط نمونه‌برداری‌شده دارد. در صورت برابری تکرار، اولین مقداری که به عنوان مد شناسایی شود انتخاب می‌گردد.

max: بازنمونه‌برداری بیشینه، بیشترین مقدار را از تمام پیکسل‌های مؤثر غیر-NODATA انتخاب می‌کند.

min: بازنمونه‌برداری کمینه، کمترین مقدار را از تمام پیکسل‌های مؤثر غیر-NODATA انتخاب می‌کند.

med: بازنمونه‌برداری میانه، مقدار میانه تمام پیکسل‌های مؤثر غیر-NODATA را انتخاب می‌کند.

q1: بازنمونه‌برداری چارک اول، مقدار چارک اول تمام پیکسل‌های مؤثر غیر-NODATA را انتخاب می‌کند.

q3: بازنمونه‌برداری چارک سوم، مقدار چارک سوم تمام پیکسل‌های مؤثر غیر-NODATA را انتخاب می‌کند.

sum: محاسبه مجموع وزن‌دار تمام پیکسل‌های مؤثر غیر-NODATA.

--wo, --warp-option <NAME>=<VALUE>: تنظیم گزینه تابیدگی (warp). مستندات GDALWarpOptions::papszWarpOptions تمام گزینه‌ها را نشان می‌دهد. می‌توان چندین گزینه را درج کرد.

گزینه‌های پیشرفته (ADVANCED OPTIONS)

--if, --input-format <format>: نام قالب/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً نیازی به مشخص کردن آن نیست، اما می‌توان از آن برای چشم‌پوشی از تشخیص خودکار درایور، در مواردی که در انتخاب درایور مناسب ناموفق است استفاده کرد. این گزینه می‌تواند چندین بار تکرار شود تا چند درایور نامزد مشخص گردند. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند. به‌ویژه، برخی درایورها نیازمندی‌هایی درباره پسوند فایل دارند.
می‌تواند تکرار شود.

--oo, --open-option <NAME>=<VALUE>: گزینه باز کردن مجموعه داده (مختص هر قالب).
می‌تواند تکرار شود.

کد وضعیت بازگشتی (RETURN STATUS CODE)

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

مثال‌ها (EXAMPLES)

مثال ۱: به‌روزرسانی out.tif موجود با محتوای in.tif با استفاده از میان‌یابی مکعبی

$ gdal raster update -r cubic in.tif out.tif

نویسنده (AUTHOR)

Even Rouault <even.rouault@spatialys.com>

حق نشر (COPYRIGHT)

1998-2026