.\" 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-NEIGHBORS" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-neighbors \- محاسبه مقدار هر پیکسل بر اساس همسایگان آن (آمار کانونی) .sp در نسخه 3.12 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster neighbors [OPTIONS] محاسبه مقدار هر پیکسل از همسایگان آن (آمار کانونی) آرگومان‌های موضعی (Positional arguments): \-i, \-\-input مجموعه‌داده‌های رستری ورودی [الزامی] [در خطوط لوله در دسترس نیست] \-o, \-\-output مجموعه‌داده رستری خروجی [الزامی] [در خطوط لوله در دسترس نیست] گزینه‌های عمومی (Common Options): \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به صورت سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست] گزینه‌ها (Options): \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی (مجاز بودن \(dqGDALG\(dq) [در خطوط لوله در دسترس نیست] \-\-co, \-\-creation\-option = گزینه ایجاد [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-overwrite آیا بازنویسی روی مجموعه‌داده خروجی موجود مجاز است [در خطوط لوله در دسترس نیست] ناسازگار با \-\-append \-\-append الحاق به عنوان یک زیرمجموعه‌داده به خروجی موجود [در خطوط لوله در دسترس نیست] ناسازگار با \-\-overwrite \-b, \-\-band باند ورودی (شاخص با شروع از ۱) \-\-method روش ترکیب پیکسل‌های وزن‌دار منبع. METHOD=mean|sum|min|max|stddev|median|mode [تکرارپذیر] \-\-size اندازه همسایگی \-\-kernel کرنل(های) کانولوشن جهت اعمال [۱.. مقادیر] [الزامی] \-\-ot, \-\-datatype, \-\-output\-data\-type نوع داده خروجی. OUTPUT\-DATA\-TYPE=UInt8|Int8|UInt16|Int16|UInt32|Int32|UInt64|Int64|CInt16|CInt32|Float16|Float32|Float64|CFloat32|CFloat64 (پیش‌فرض: Float64) \-\-nodata اختصاص مقدار بی‌داده (nodata) مشخص به باندهای خروجی (\(aqnone\(aq، مقدار عددی، \(aqnan\(aq، \(aqinf\(aq، \(aq\-inf\(aq) گزینه‌های پیشرفته (Advanced Options): \-\-if, \-\-input\-format قالب‌های ورودی [تکرارپذیر] [در خطوط لوله در دسترس نیست] \-\-oo, \-\-open\-option = گزینه‌های باز کردن [تکرارپذیر] [در خطوط لوله در دسترس نیست] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster neighbors\fP یک \X'tty: link https://en.wikipedia.org/wiki/Kernel_(image_processing)'\fI\%کرنل (ماتریس کانولوشن)\fP\X'tty: link' و یک روش را برای محاسبه مقدار پیکسل هدف از روی همسایگی مقدار پیکسل منبع اعمال می‌کند. .sp در لبه بالایی، مقادیر ردیف اول تکرار می‌شوند تا پنجره منبع را به صورت مجازی به تعداد ردیف‌هایی برابر با شعاع کرنل گسترش دهند؛ و به همین ترتیب برای لبه‌های پایین، چپ و راست نیز عمل می‌شود. این راهبرد ممکن است بسته به کرنل اعمال‌شده به طور بالقوه منجر به نتایج غیرمنتظره شود. .sp برای یک سلول هدف مشخص، اگر مقدار منبع متناظر (سلولی که در مرکز کرنل قرار دارد) برابر با nodata (بی‌داده) باشد، پیکسل حاصل نیز nodata خواهد بود. برای سایر مقادیر منبع در همسایگی تعریف‌شده توسط کرنل، مقادیر بی‌داده منبع نادیده گرفته می‌شوند. .sp این الگوریتم می‌تواند بخشی از یک \fI\%gdal pipeline\fP یا \fI\%gdal raster pipeline\fP باشد. .INDENT 0.0 .INDENT 2.5 [تصویر] مجموعه‌داده رستری پیش از جمع (چپ) و پس از جمع (راست) با یک کرنل ۳×۳ هم‌وزن. مقادیر NoData برای اهداف جمع صفر در نظر گرفته می‌شوند. در جایی که پنجره کرنل فراتر از لبه مجموعه‌داده امتداد می‌یابد، سلول‌های لبه تکرار می‌شوند. .UNINDENT .UNINDENT .SH "خروجی GDALG (مجموعه‌داده در لحظه / جریانی)" .sp این برنامه از سریالی‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. سپس فایل حاصل می‌تواند به عنوان یک مجموعه‌داده رستری با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP باز شود و خط لوله تعیین‌شده را به صورت در لحظه / جریانی اعمال کند. .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-band شماره باند منبع (شمارش از یک آغاز می‌شود). در صورت عدم تعیین، تمامی باندهای ورودی استفاده می‌شوند. .UNINDENT .INDENT 0.0 .TP .B \-\-kernel کرنل کانولوشن جهت اعمال بر پیکسل‌های منبع در همسایگی هر پیکسل. .INDENT 7.0 .IP \(bu 2 یا نام یک کرنل شناخته‌شده از میان \fBedge1\fP، \fBedge2\fP، \fBsharpen\fP، \fBgaussian\fP، یا \fBunsharp\-masking\fP، متناظر با این \X'tty: link https://en.wikipedia.org/wiki/Kernel_(image_processing)#Details'\fI\%کرنل‌ها (ماتریس‌های کانولوشن)\fP\X'tty: link'، به همراه موارد افزوده زیر: .INDENT 2.0 .IP \(bu 2 \fBequal\fP متناظر با یک کرنل با تمام ضرایب برابر با یک (اندازه کرنل می‌تواند هر عدد فردی بین ۳ تا ۹۹ باشد): .sp .ce \ebegin{align} \ebegin{bmatrix} 1 & 1 & 1\e\e 1 & 1 & 1 \e\e 1 & 1 & 1 \eend{bmatrix} \eend{align} .ce 0 .sp برای روش \fBmean\fP، این معادل فیلتر مات‌کننده جعبه‌ای (Box Blur) است. .IP \(bu 2 \fBu\fP متناظر با یک مشتق افقی با ضرایب زیر: .sp .ce \ebegin{align} \ebegin{bmatrix} 0 & 0 & 0\e\e \-0.5 & 0 & 0.5 \e\e 0 & 0 & 0 \eend{bmatrix} \eend{align} .ce 0 .IP \(bu 2 \fBv\fP متناظر با یک مشتق عمودی با ضرایب زیر: .sp .ce \ebegin{align} \ebegin{bmatrix} 0 & \-0.5 & 0\e\e 0 & 0 & 0 \e\e 0 & 0.5 & 0 \eend{bmatrix} \eend{align} .ce 0 .UNINDENT .INDENT 2.0 .INDENT 3.5 کرنل‌های \fBedge1\fP، \fBedge2\fP، \fBsharpen\fP، \fBu\fP و \fBv\fP فقط برای اندازه کرنل برابر با ۳ پشتیبانی می‌شوند. .sp کرنل \fBgaussian\fP برای اندازه کرنل برابر با ۳ یا ۵ پشتیبانی می‌شود. .sp کرنل \fBunsharp\-masking\fP برای اندازه کرنل برابر با ۵ پشتیبانی می‌شود. .UNINDENT .UNINDENT .IP \(bu 2 یا مقادیر ضرایب کرنل به عنوان یک ماتریس مربعی با پهنا و ارتفاع N، که در آن N یک عدد فرد است، به صورت \fB[[val00, val01, ..., val0N],[val10, val11, ..., val1N],...,[valN0, valN1, ..., valNN]]\fP\&. .sp اگر \fI\%\-\-method\fP روی \fBmean\fP تنظیم شود، این کار اثر محاسبه مجموع پیکسل‌های وزن‌دار منبع (مشارکت‌کننده، یعنی غیر nodata) و تقسیم آن بر مجموع ضرایب موجود در کرنل را خواهد داشت. .UNINDENT .sp اگر \fI\%\-\-kernel\fP چندین بار مشخص شود، برای هر ترکیب کرنل و باند ورودی یک باند خروجی وجود خواهد داشت. .UNINDENT .INDENT 0.0 .TP .B \-\-method sum|mean|min|max|stddev|median|mode تابع مورد نظر جهت اعمال بر پیکسل‌های وزن‌دار منبع در همسایگی تعریف‌شده با کرنل. پیش‌فرض \fBmean\fP است، مگر زمانی که \fI\%\-\-kernel\fP روی \fBu\fP، \fBv\fP، \fBedge1\fP، \fBedge2\fP، یا یک کرنل تعریف‌شده توسط کاربر که مجموع ضرایب آن صفر است تنظیم شده باشد، که در این حالت از \fBsum\fP استفاده می‌شود. .INDENT 7.0 .IP \(bu 2 \fBsum\fP: مجموع مقادیر پیکسل‌های مشارکت‌کننده منبع ضرب در وزن متناظر کرنل را محاسبه می‌کند. این معادل با یک کرنل با مجموع نرمال‌نشده ضرایب است. .IP \(bu 2 \fBmean\fP: میانگین مقادیر پیکسل‌های مشارکت‌کننده منبع ضرب در وزن متناظر کرنل را محاسبه می‌کند. این کار اثر نرمال‌سازی ضرایب کرنل را به همراه دارد به طوری که مجموع آن‌ها برابر با یک شود. .IP \(bu 2 \fBmin\fP: کمینه مقدار پیکسل‌های مشارکت‌کننده منبع ضرب در وزن متناظر کرنل را محاسبه می‌کند .IP \(bu 2 \fBmax\fP: بیشینه مقدار پیکسل‌های مشارکت‌کننده منبع ضرب در وزن متناظر کرنل را محاسبه می‌کند .IP \(bu 2 \fBstddev\fP: انحراف معیار مقادیر پیکسل‌های مشارکت‌کننده منبع ضرب در وزن متناظر کرنل را محاسبه می‌کند .IP \(bu 2 \fBmedian\fP: میانه مقادیر پیکسل‌های مشارکت‌کننده منبع ضرب در وزن متناظر کرنل را محاسبه می‌کند .IP \(bu 2 \fBmode\fP (اکثریت/نما): پرتکرارترین مقدار پیکسل‌های مشارکت‌کننده منبع ضرب در وزن متناظر کرنل را محاسبه می‌کند .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-nodata تنظیم مقدار NoData برای مجموعه‌داده خروجی. می‌تواند روی \fBnone\fP تنظیم شود تا مقدار NoData تعریف‌نشده باقی بماند. اگر \fI\%\-\-nodata\fP مشخص نشود، دستور \fBgdal raster neighbors\fP از مقدار NoData اولین مجموعه‌داده منبعی که دارای آن باشد استفاده خواهد کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-size اندازه کرنل. یک عدد فرد بین ۳ و ۹۹. .sp \fBنکته:\fP .INDENT 7.0 .INDENT 3.5 زمان محاسبات متناسب با مجذور اندازه کرنل است. .UNINDENT .UNINDENT .sp برای کرنل‌های \fBedge1\fP، \fBedge2\fP، \fBsharpen\fP، \fBu\fP، \fBv\fP، \fBgaussian\fP، \fBequal\fP، مقدار پیش‌فرض ۳ است. .sp برای کرنل \fBunsharp\-masking\fP، مقدار پیش‌فرض ۵ است. .sp برای کرنل‌هایی که با مقادیر ضرایب خود تعیین می‌شوند، این مقدار از شکل ماتریس استنباط می‌شود. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append الحاق رستر ورودی به عنوان یک زیرمجموعه‌داده جدید به فایل خروجی موجود. تنها با درایورهایی کار می‌کند که از افزودن زیرمجموعه‌داده‌ها پشتیبانی می‌کنند مانند \fI\%GTiff \-\- GeoTIFF File Format\fP و \fI\%GPKG \-\- GeoPackage raster\fP\&. این گزینه همچنین در صورت عدم وجود مجموعه‌داده خروجی، آن را ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد دارند که می‌توانند برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده شوند. به عنوان مثال، درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و کاشی‌بندی شدن فایل پشتیبانی می‌کند. .sp تکرارپذیر است. .sp گزینه‌های ایجاد در دسترس بر اساس درایور قالب متغیر است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات قالب، مرجع نهایی اطلاعات درباره گزینه‌های ایجاد درایور است. برای مشاهده گزینه‌های ایجاد مجاز برای هر قالب، به مستندات مختص به قالب در \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/درایوری که برای باز کردن فایل(های) ورودی تلاش می‌شود. معمولاً نیازی به تعیین آن نیست، اما می‌توان از آن برای چشم‌پوشی از تشخیص خودکار درایور، هنگامی که در انتخاب درایور مناسب ناموفق است، استفاده کرد. این گزینه می‌تواند چندین بار برای تعیین چندین درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن مجموعه‌داده نمی‌کند. به ویژه، برخی از درایورها نیازمندی‌هایی برای پسوند فایل دارند. .sp تکرارپذیر است. .UNINDENT .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه‌داده (مختص قالب). .sp تکرارپذیر است. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format تعیین اینکه از کدام قالب رستری خروجی استفاده شود. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: \fBgdal \-\-formats | grep raster | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-ot, \-\-datatype, \-\-output\-data\-type نوع داده خروجی از میان \fBByte\fP، \fBInt8\fP، \fBUInt16\fP، \fBInt16\fP، \fBUInt32\fP، \fBInt32\fP، \fBUInt64\fP، \fBInt64\fP، \fBCInt16\fP، \fBCInt32\fP، \fBFloat32\fP، \fBFloat64\fP، \fBCFloat32\fP، \fBCFloat64\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite اجازه دادن به برنامه برای بازنویسی روی فایل یا مجموعه‌داده هدف موجود. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه‌داده هدف از قبل وجود داشته باشد، \fBgdal\fP با خطا متوقف می‌شود. .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار ارسال می‌شوند به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS مثال ۱: محاسبه مشتق افقی و عمودی یک رستر تک‌باند .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster neighbors \-\-kernel u \-\-kernel v in.tif uv.tif .EE .UNINDENT .UNINDENT .SS مثال ۲: محاسبه مقدار میانگین پیرامون هر پیکسل در یک همسایگی ۳×۳ .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster neighbors \-\-kernel equal \-\-method mean in.tif mean.tif .EE .UNINDENT .UNINDENT .SS مثال ۳: محاسبه مقدار بیشینه پیرامون هر پیکسل در یک همسایگی ۵×۵ .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster neighbors \-\-kernel equal \-\-size 5 \-\-method max in.tif max.tif .EE .UNINDENT .UNINDENT .SS مثال ۴: محاسبه فیلتر شفاف‌سازی (Sharpen) یک رستر تک‌باند با تعیین دستی ضرایب کرنل .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster neighbors \(dq\-\-kernel=[[0,\-1,0],[\-1,5,\-1],[0,\-1,0]]\(dq in.tif sharpen.tif .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .