.\" 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 "GDAL-RASTER-UPDATE" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-raster-update \- به‌روزرسانی رستر مقصد با محتوای رستر ورودی
.sp
افزوده‌شده در نگارش 3.12.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
کاربرد: 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>  آستانه خطا
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal raster update\fP می‌تواند برای به‌روزرسانی یک مجموعه داده رستر خروجی موجود با مقادیر پیکسل‌های رستر ورودی استفاده شود، و در صورتی که سامانه‌های مرجع مختصات مجموعه داده‌های ورودی و خروجی یکسان نباشند، بازتصویرسازی (reprojection) را انجام می‌دهد.
محدوده (extent)، اندازه، وضوح یا سامانه مرجع مختصات مجموعه داده خروجی با این عملیات تغییر نمی‌کند.
.sp
پیش‌نمایش‌ها (Overviews) توسط این دستور به‌روزرسانی می‌شوند (با استفاده از \fI\%gdal raster overview refresh\fP)، مگر اینکه گزینه \fI\%\-\-no\-update\-overviews\fP مشخص شده باشد.
.sp
از نگارش GDAL 3.13 به بعد، \fBgdal raster update\fP می‌تواند به عنوان مرحله‌ای از یک خط لوله (pipeline) استفاده شود که در آن مجموعه داده ورودی همان خروجی مرحله پیشین است.
.SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-et, \-\-error\-threshold <ERROR\-THRESHOLD>
آستانه خطا برای تقریب تبدیل، که بر حسب تعداد پیکسل‌های ورودی بیان می‌شود. پیش‌فرض 0.125 پیکسل است مگر اینکه گزینه تبدیل‌کننده \fBRPC_DEM\fP مشخص شده باشد که در آن صورت یک تبدیل‌کننده دقیق، یعنی \fB\-\-error\-threshold=0\fP، استفاده خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-geometry <WKT_or_GeoJSON>
هندسه به صورت یک رشته WKT یا GeoJSON از یک چندضلعی (یا چندچندضلعی) که به‌روزرسانی به آن محدود می‌شود.
اگر هندسه ورودی GeoJSON باشد، فرض می‌شود که CRS آن WGS84 است مگر اینکه یک CRS در هندسه GeoJSON تعریف شده باشد یا \fI\%\-\-geometry\-crs\fP مشخص گردد.
اگر هندسه ورودی WKT باشد، فرض می‌شود که CRS آن همان CRS مجموعه داده ورودی است مگر اینکه \fI\%\-\-geometry\-crs\fP مشخص شود.
محورهای X و Y بر اساس استانداردهای سازگار با GIS هستند، بدین معنا که X طول جغرافیایی (یا مختصات شرقی) و Y عرض جغرافیایی (یا مختصات شمالی) است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-geometry\-crs <CRS>
سامانه مرجع مختصات (CRS) که مقادیر مختصات \fI\%\-\-geometry\fP بر حسب آن بیان شده‌اند. اگر مشخص نشود، فرض می‌شود که همان CRS مجموعه داده ورودی است.
هندسه از geometry\-crs به CRS مجموعه داده در حال به‌روزرسانی بازتصویرسازی خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-update\-overviews
عدم به‌روزرسانی پیش‌نمایش‌های موجود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-to, \-\-transform\-option <NAME>=<VALUE>
تنظیم یک گزینه تبدیل‌کننده مناسب برای ارسال به \fI\%GDALCreateGenImgProjTransformer2()\fP\&.
برای گزینه‌های خاص RPC به \fI\%GDALCreateRPCTransformerV2()\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-r, \-\-resampling <RESAMPLING>
روش بازنمونه‌برداری مورد استفاده. روش‌های موجود عبارتند از:
.sp
\fBnearest\fP: بازنمونه‌برداری نزدیک‌ترین همسایه (پیش‌فرض، سریع‌ترین الگوریتم، کمترین کیفیت درون‌یابی).
.sp
\fBbilinear\fP: بازنمونه‌برداری دوخطی.
.sp
\fBcubic\fP: بازنمونه‌برداری مکعبی.
.sp
\fBcubicspline\fP: بازنمونه‌برداری اسپلاین مکعبی.
.sp
\fBlanczos\fP: بازنمونه‌برداری پنجره‌ای سینک لانچوس.
.sp
\fBaverage\fP: بازنمونه‌برداری میانگین، میانگین وزن‌دار تمام پیکسل‌های مؤثر غیر\-NODATA را محاسبه می‌کند.
.sp
\fBrms\fP: جذر میانگین مربعات / میانگین درجه دوم تمام پیکسل‌های مؤثر غیر\-NODATA.
.sp
\fBmode\fP: بازنمونه‌برداری نما (مد)، مقداری را انتخاب می‌کند که بیشترین تکرار را در تمام نقاط نمونه‌برداری‌شده دارد. در صورت برابری تکرار، اولین مقداری که به عنوان مد شناسایی شود انتخاب می‌گردد.
.sp
\fBmax\fP: بازنمونه‌برداری بیشینه، بیشترین مقدار را از تمام پیکسل‌های مؤثر غیر\-NODATA انتخاب می‌کند.
.sp
\fBmin\fP: بازنمونه‌برداری کمینه، کمترین مقدار را از تمام پیکسل‌های مؤثر غیر\-NODATA انتخاب می‌کند.
.sp
\fBmed\fP: بازنمونه‌برداری میانه، مقدار میانه تمام پیکسل‌های مؤثر غیر\-NODATA را انتخاب می‌کند.
.sp
\fBq1\fP: بازنمونه‌برداری چارک اول، مقدار چارک اول تمام پیکسل‌های مؤثر غیر\-NODATA را انتخاب می‌کند.
.sp
\fBq3\fP: بازنمونه‌برداری چارک سوم، مقدار چارک سوم تمام پیکسل‌های مؤثر غیر\-NODATA را انتخاب می‌کند.
.sp
\fBsum\fP: محاسبه مجموع وزن‌دار تمام پیکسل‌های مؤثر غیر\-NODATA.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-wo, \-\-warp\-option <NAME>=<VALUE>
تنظیم گزینه تابیدگی (warp). مستندات \fI\%GDALWarpOptions::papszWarpOptions\fP تمام گزینه‌ها را نشان می‌دهد.
می‌توان چندین گزینه را درج کرد.
.UNINDENT
.SH "گزینه‌های پیشرفته (ADVANCED OPTIONS)"
.INDENT 0.0
.TP
.B \-\-if, \-\-input\-format <format>
نام قالب/درایور برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً نیازی به مشخص کردن آن نیست، اما می‌توان از آن برای چشم‌پوشی از تشخیص خودکار درایور، در مواردی که در انتخاب درایور مناسب ناموفق است استفاده کرد.
این گزینه می‌تواند چندین بار تکرار شود تا چند درایور نامزد مشخص گردند.
توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه داده نمی‌کند. به‌ویژه، برخی درایورها نیازمندی‌هایی درباره پسوند فایل دارند.
.sp
می‌تواند تکرار شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینه باز کردن مجموعه داده (مختص هر قالب).
.sp
می‌تواند تکرار شود.
.UNINDENT
.SH "کد وضعیت بازگشتی (RETURN STATUS CODE)"
.sp
برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS مثال ۱: به‌روزرسانی out.tif موجود با محتوای in.tif با استفاده از میان‌یابی مکعبی
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ gdal raster update \-r cubic in.tif out.tif
.EE
.UNINDENT
.UNINDENT
.SH "نویسنده (AUTHOR)"
Even Rouault <even.rouault@spatialys.com>
.SH "حق نشر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.