.\" 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-OVERVIEW-REFRESH" "1" "Aug 18, 2026" "" "GDAL"
.SH "نام (NAME)"
gdal-raster-overview-refresh \- تازه‌سازی پیش‌نمایش‌ها
.sp
در نسخه 3.12 اضافه شد.

.SH "خلاصه دستور (SYNOPSIS)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Usage: gdal raster overview refresh [OPTIONS] <INPUT>

Refresh overviews.

Positional arguments:
  \-i, \-\-dataset, \-\-input <INPUT>     Dataset (to be updated in\-place, unless \-\-external) [required]

Common Options:
  \-h, \-\-help                         Display help message and exit
  \-\-json\-usage                       Display usage as JSON document and exit
  \-\-config <KEY>=<VALUE>             Configuration option [may be repeated]
  \-q, \-\-quiet                        Quiet mode (no progress bar or warning message) [not available in pipelines]

Options:
  \-\-external                         Refresh external overviews
  \-r, \-\-resampling <RESAMPLING>      Resampling method. RESAMPLING=nearest|average|cubic|cubicspline|lanczos|bilinear|gauss|average_magphase|rms|mode
  \-\-levels <LEVELS>                  Levels / decimation factors [may be repeated]
  \-\-bbox <BBOX>                      Bounding box to refresh
                                     Mutually exclusive with \-\-like, \-\-use\-source\-timestamp
  \-\-like <LIKE>                      Use extent of dataset(s) [may be repeated]
                                     Mutually exclusive with \-\-bbox, \-\-use\-source\-timestamp
  \-\-use\-source\-timestamp             Use timestamp of VRT or GTI sources as refresh criterion
                                     Mutually exclusive with \-\-bbox, \-\-like

Advanced Options:
  \-\-oo, \-\-open\-option <KEY>=<VALUE>  Open options [may be repeated]
.EE
.UNINDENT
.UNINDENT
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgdal raster overview refresh\fP می‌تواند برای تازه‌سازی پیش‌نمایش‌های موجود یک مجموعه داده (dataset) به کار رود.
به‌طور پیش‌فرض تمام پیش‌نمایش‌ها تازه‌سازی می‌شوند، اما محدود کردن پیش‌نمایش‌های تازه‌سازی‌شده بر اساس سطح (level) و/یا محدوده (extent) نیز امکان‌پذیر است.
.SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)"
.INDENT 0.0
.TP
.B \-\-bbox <xmin>,<ymin>,<xmax>,ymax>
این گزینه یک تازه‌سازی جزئی روی پیش‌نمایش‌های موجود، در ناحیه مورد نظر مشخص‌شده با مختصات زمین‌مرجع و بر حسب واحدهای CRS انجام می‌دهد.
.sp
مقدار \(aqx\(aq نشان‌دهنده مقادیر طول جغرافیایی برای CRS جغرافیایی و مؤلفه شرقی (easting) برای CRS تصویرشده است.
مقدار \(aqy\(aq نشان‌دهنده مقادیر عرض جغرافیایی برای CRS جغرافیایی و مؤلفه شمالی (northing) برای CRS تصویرشده است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-dataset <DATASET>
نام مجموعه داده که به‌طور پیش‌فرض در جای خود به‌روزرسانی می‌شود (مگر اینکه \fI\%\-\-external\fP مشخص شده باشد). الزامی است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-external
تازه‌سازی پیش‌نمایش‌های خارجی \fB\&.ovr\fP.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-levels <level1,level2,...>
فهرستی از سطوح پیش‌نمایش برای ساخت. هر سطح پیش‌نمایش باید یک مقدار عدد صحیح بزرگ‌تر یا مساوی ۲ باشد.
.sp
در صورت مشخص نشدن، تمام پیش‌نمایش‌های موجود تازه‌سازی می‌شوند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-like <filename1>[,<filenameN>]...
این گزینه یک تازه‌سازی جزئی روی پیش‌نمایش‌های موجود، در ناحیه مورد نظر مشخص‌شده توسط یک یا چند نام فایل (نام‌ها با ویرگول جدا می‌شوند) انجام می‌دهد.
توجه داشته باشید که نام فایل‌ها تنها برای تعیین نواحی مورد نظر جهت تازه‌سازی استفاده می‌شوند. پیکسل‌های منبع مرجع، همان پیکسل‌های مجموعه داده اصلی هستند.
به‌طور پیش‌فرض تمام سطوح پیش‌نمایش موجود تازه‌سازی خواهند شد، مگر اینکه سطوح به‌طور صریح مشخص شده باشند. به \fI\%مثال ۲\fP مراجعه کنید.
.UNINDENT
.INDENT 0.0
.TP
.B \-r, \-\-resampling {nearest|average|cubic|cubicspline|lanczos|bilinear|gauss|average_magphase|rms|mode}
انتخاب یک الگوریتم بازنمونه‌برداری (resampling). مقدار پیش‌فرض \fBnearest\fP است که در صورت نیاز به دقت زیرپیکسل معمولاً مناسب نیست.
.sp
هنگام تازه‌سازی پیش‌نمایش‌های TIFF موجود، چنانچه \fI\%\-r\fP مشخص نشده باشد، روشی که پیش‌تر استفاده شده بود (همان‌طور که در آیتم فراداده RESAMPLING پیش‌نمایش ثبت شده) به کار خواهد رفت.
.sp
روش‌های موجود عبارتند از:
.sp
روش \fBnearest\fP یک بازنمونه‌بردار نزدیک‌ترین همسایه (نمونه‌برداری ساده) را اعمال می‌کند.
.sp
روش \fBaverage\fP میانگین تمام پیکسل‌های مشارکت‌کننده غیر NODATA را محاسبه می‌کند. این یک میانگین وزنی است که وزن پیکسل‌های منبعی را که به طور کامل در پیکسل هدف مشارکت ندارند به‌درستی لحاظ می‌کند.
.sp
روش \fBbilinear\fP یک هسته کانولوشن دوخطی را اعمال می‌کند.
.sp
روش \fBcubic\fP یک هسته کانولوشن مکعبی را اعمال می‌کند.
.sp
روش \fBcubicspline\fP یک هسته کانولوشن B\-Spline را اعمال می‌کند.
.sp
روش \fBlanczos\fP یک هسته کانولوشن پنجره‌دار sinc مربوط به Lanczos را اعمال می‌کند.
.sp
روش \fBgauss\fP پیش از محاسبه پیش‌نمایش یک هسته گاوسی اعمال می‌کند که می‌تواند به نتایج بهتری نسبت به میانگین‌گیری ساده منجر شود؛ مثلاً در مواردی با لبه‌های تیز و کنتراست بالا یا الگوهای نویزدار. مقادیر سطوح توصیه‌شده ۲، ۴، ۸ و... هستند تا یک هسته بازنمونه‌برداری گاوسی ۳×۳ انتخاب شود.
.sp
روش \fBaverage_magphase\fP داده‌های مختلط را در فضای اندازه/فاز (mag/phase) میانگین‌گیری می‌کند.
.sp
روش \fBrms\fP مقدار جذر میانگین مربعات / میانگین مربعی تمام پیکسل‌های مشارکت‌کننده غیر NODATA را محاسبه می‌کند.
.sp
روش \fBmode\fP مقداری را انتخاب می‌کند که در میان تمام نقاط نمونه‌برداری‌شده بیشترین تکرار را داشته باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-use\-source\-timestamp
این گزینه یک تازه‌سازی جزئی روی پیش‌نمایش‌های موجود یک فایل \fI\%VRT \-\- GDAL Virtual Format\fP یا \fI\%GTI \-\- GDAL Raster Tile Index\fP دارای پیش‌نمایش خارجی انجام می‌دهد.
این گزینه برچسب زمانی تغییرات (timestamp) تمام منابع VRT را بررسی می‌کند و پیش‌نمایش را برای نواحی مربوط به منابعی که برچسب زمانی آن‌ها تازه‌تر از پیش‌نمایش خارجی VRT است، دوباره تولید می‌نماید.
به‌طور پیش‌فرض تمام سطوح پیش‌نمایش موجود تازه‌سازی خواهند شد، مگر اینکه سطوح به‌طور صریح مشخص شده باشند. به \fI\%مثال ۱\fP مراجعه کنید.
.UNINDENT
.SH "گزینه‌های استاندارد (STANDARD OPTIONS)"
.INDENT 0.0
.TP
.B \-\-oo, \-\-open\-option <NAME>=<VALUE>
گزینه باز کردن مجموعه داده (مختص به هر فرمت).
.sp
ممکن است تکرار شود.
.UNINDENT
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به شکل هشدار ارسال می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند).
.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱: تازه‌سازی پیش‌نمایش‌های خارجی یک فایل VRT با استفاده از برچسب زمانی فایل‌های منبع"
.sp
این کار زمانی نیاز است که فایل‌های منبع پس از ایجاد vrt.ovr. دستخوش تغییر شده باشند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal raster mosaic tile1.tif tile2.tif my.vrt               # create VRT
gdal raster overview add \-\-external \-r cubic my.vrt         # initial overview generation
touch tile1.tif                                             # simulate update of one of the source tiles
gdal raster overview refresh \-\-external \-r cubic \e
                          \-\-use\-source\-timestamp my.vrt     # refresh overviews
.EE
.UNINDENT
.UNINDENT
.SS "مثال ۲: تازه‌سازی پیش‌نمایش‌های (داخلی) یک فایل TIFF"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gdal raster mosaic tile1.tif tile2.tif mosaic.tif       # create mosaic
gdal raster overview add \-r cubic mosaic.tif            # initial overview generation
gdalwarp tile1_modif.tif mosaic.tif                     # update mosaic
gdal raster overview refresh \-\-like=tile1.tif my.tif    # refresh overviews
.EE
.UNINDENT
.UNINDENT
.SH "نویسندگان (AUTHORS)"
Even Rouault <even.rouault@spatialys.com>
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
1998-2026
.\" Generated by docutils manpage writer.
.