.\" 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-ADD" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-overview-add \- افزودن نمای کلی (overview) به مجموعه‌داده رَستری .sp افزوده‌شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster overview add [OPTIONS] Adding overviews. Positional arguments: \-i, \-\-dataset, \-\-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 = Configuration option [may be repeated] \-q, \-\-quiet Quiet mode (no progress bar or warning message) [not available in pipelines] Options: \-\-overview\-src Source overview dataset [may be repeated] Mutually exclusive with \-\-levels \-\-external Add external overviews \-r, \-\-resampling Resampling method. RESAMPLING=nearest|average|cubic|cubicspline|lanczos|bilinear|gauss|average_magphase|rms|mode \-\-levels Levels / decimation factors [may be repeated] Mutually exclusive with \-\-overview\-src \-\-min\-size Maximum width or height of the smallest overview level. \-\-co, \-\-creation\-option = Overview creation option [may be repeated] Advanced Options: \-\-oo, \-\-open\-option = Open options [may be repeated] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster overview add\fP می‌تواند برای ساخت یا بازسازی تصویرهای نمای کلی (overview) برای بیشتر فرمت‌های فایل پشتیبانی‌شده با استفاده از یکی از چندین الگوریتم نمونه‌کاهی (downsampling) به کار رود. .sp از GDAL 3.12 به بعد، \fBgdal raster overview add\fP می‌تواند به عنوان مرحله‌ای از یک خط لوله (pipeline) به کار رود. در این حالت، نماهای کلی مجازی در خروجی این مرحله تولید می‌شوند و در صورت نوشتن یک فایل GeoTIFF با گزینه ساخت COPY_SRC_OVERVIEWS یا هنگام نوشتن در یک فایل COG (مخفف Cloud Optimized GeoTIFF)، قابلیت تحقق در مرحله پایانی نوشتن را دارند. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-co = افزوده‌شده در نسخه 3.12. .sp گزینه‌های ساخت نمای کلی. می‌تواند تکرار شود. .sp بسیاری از فرمت‌ها یک یا چند گزینه اختیاری برای ساخت دارند که می‌توان از آن‌ها برای کنترل جزئیات نماهای کلی ایجادشده استفاده کرد. گزینه‌های دردسترس را می‌توان با بررسی \fBOverviewCreationOptionList\fP بازگردانده‌شده توسط \fBgdal \-\-format \fP\& به دست آورد. .sp بیشتر فرمت‌ها از نماهای کلی خارجی در یک فایل GeoTIFF به‌صورت فایل همراه (sidecar) با پسوند \fB\&.ovr\fP\& پشتیبانی می‌کنند. می‌توانید به \fI\%overview creation options for GeoTIFF\fP\& مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-dataset نام مجموعه‌داده، که به‌طور پیش‌فرض درجا به‌روزرسانی می‌شود (مگر این‌که \fI\%\-\-external\fP مشخص شده باشد). برای اجرای مستقل الزامی است، اما هنگام اجرا به عنوان مرحله‌ای از یک خط لوله، به‌طور ضمنی تعیین می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-external ایجاد نماهای کلی خارجی \fB\&.ovr\fP به عنوان فایل‌های GeoTIFF. هنگام اجرا به عنوان مرحله‌ای از خط لوله در دسترس نیست. .UNINDENT .INDENT 0.0 .TP .B \-\-levels فهرستی از سطوح نمای کلی برای ساخت. هر سطح نمای کلی باید یک مقدار عدد صحیح بزرگ‌تر یا مساوی ۲ باشد. .sp هنگامی که سطوح صریح مشخص نشده باشند: .INDENT 7.0 .IP \(bu 2 اگر از پیش نماهای کلی وجود داشته باشند، در صورت مشخص نشدن سطوح صریح، سطوح متناظر برای تازه‌سازی آن‌ها استفاده خواهند شد. .IP \(bu 2 در غیر این صورت، ضریب‌های توان دوی مناسب برای نمای کلی انتخاب خواهند شد تا زمانی که کوچک‌ترین نمای کلی کوچک‌تر از مقدار سوییچ \fI\%\-\-min\-size\fP شود. .UNINDENT .sp غیرقابل استفاده هم‌زمان با \fI\%\-\-overview\-src\fP .UNINDENT .INDENT 0.0 .TP .B \-\-min\-size حداکثر عرض یا ارتفاع کوچک‌ترین سطح نمای کلی. تنها در صورتی در نظر گرفته می‌شود که سطوح صریح مشخص نشده باشند. مقدار پیش‌فرض ۲۵۶ است. .UNINDENT .INDENT 0.0 .TP .B \-\-overview\-src افزوده‌شده در نسخه 3.12. .sp افزودن مجموعه‌داده‌های رَستری ورودی مشخص‌شده به عنوان نماهای کلی مجموعه‌داده هدف. نماهای کلی مبدأ می‌توانند از هر فرمت پشتیبانی‌شده در GDAL باشند، به شرطی که تعداد باندها و وسعت مکانی یکسانی با مجموعه‌داده هدف داشته باشند. .sp این حالت در حال حاضر تنها زمانی پیاده‌سازی شده است که مجموعه‌داده هدف در فرمت GeoTIFF باشد یا هنگام استفاده از \fI\%\-\-external\fP\&. .sp غیرقابل استفاده هم‌زمان با \fI\%\-\-levels\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 .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از فرمت‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و کاشی‌بندی بودن فایل پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت دردسترس بسته به درایور فرمت متفاوت هستند، و برخی از فرمت‌های ساده هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات خود فرمت منبع قطعی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های ساخت مجاز برای هر فرمت به مستندات اختصاصی فرمت \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (مخصوص هر فرمت). .sp می‌تواند تکرار شود. .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیرصفر را بازمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: ساخت نماهای کلی، جاسازی‌شده در فایل TIFF ارائه‌شده، با محاسبه خودکار سطوح" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster overview add \-r average abc.tif .EE .UNINDENT .UNINDENT .SS "مثال ۲: ساخت نماهای کلی، جاسازی‌شده در فایل TIFF ارائه‌شده" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster overview add \-r average \-\-levels=2,4,8,16 abc.tif .EE .UNINDENT .UNINDENT .SS "مثال ۳: ساخت یک فایل نمای کلی فشرده‌شده GeoTIFF خارجی از فایل ERDAS .IMG" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster overview add \-\-external \-\-levels=2,4,8,16 \-\-co COMPRESS=YES erdas.img .EE .UNINDENT .UNINDENT .SS "مثال ۴: ساخت یک فایل نمای کلی خارجی GeoTIFF فشرده‌شده با JPEG از یک مجموعه‌داده ۳-بانده RGB" .sp اگر مجموعه‌داده یک GeoTIFF با قابلیت نوشتن باشد، برای اجبار به ایجاد نمای کلی خارجی باید گزینه \fI\%\-\-external\fP را نیز اضافه کنید. .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster overview add \-\-co OVERVIEW=JPEG \-\-co PHOTOMETRIC=YCBCR \e \-\-co INTERLEAVE=PIXEL rgb_dataset.ext 2 4 8 16 .EE .UNINDENT .UNINDENT .SS "مثال ۵: ساخت نماهای کلی برای یک زیرمجموعه‌داده مشخص" .sp برای نمونه، یکی از لایه‌های رَستری پرتعداد در یک GeoPackage (پارامتر \(dqfilename\(dq باید پیشوند درایور، نام فایل و نام زیرمجموعه‌داده باشد، مشابه آنچه توسط gdalinfo نمایش داده می‌شود): .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster overview add GPKG:file.gpkg:layer .EE .UNINDENT .UNINDENT .SS "مثال ۶: افزودن ۳ مجموعه‌داده موجود در مقیاس‌های 1:25K، 1:50K و 1:100K به عنوان نماهای کلی my.tif" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster overview add \-\-overview\-src ovr_25k.tif \-\-overview\-src ovr_50k.tif \-\-overview\-src ovr_100k.tif \-\-dataset my.tif .EE .UNINDENT .UNINDENT .SS "مثال ۷: ساخت یک فایل COG با سطوح نمای کلی که توان دو نیستند" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal pipeline read input.tif ! reproject \-\-output\-crs=EPSG:4326 ! add overview \-\-levels 16,64,128 ! write output.tif \-\-format=COG .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .