.\" 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-VECTOR-GRID" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-vector-grid \- ایجاد یک شبکه منظم از نقاط پراکنده .sp در نسخه 3.11 اضافه شد. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX کاربرد: gdal vector grid [OPTIONS] که در آن یکی از موارد زیر است: \- average: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از درونیابی میانگین متحرک. \- average\-distance: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از میانگین فاصله بین گره شبکه (مرکز بیضی جستجو) و تمام نقاط داده در بیضی جستجو. \- average\-distance\-points: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از میانگین فاصله بین نقاط داده در بیضی جستجو. \- count: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از تعداد نقاط در بیضی جستجو. \- invdist: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از درونیابی فاصله معکوس وزن‌دار. \- invdistnn: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از درونیابی فاصله معکوس وزن‌دار نزدیک‌ترین همسایه. \- linear: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از درونیابی خطی/مرکز ثقلی (barycentric). \- maximum: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از بیشترین مقدار در بیضی جستجو. \- minimum: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از کمترین مقدار در بیضی جستجو. \- nearest: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از درونیابی نزدیک‌ترین همسایه. \- range: ایجاد یک شبکه منظم از نقاط پراکنده با استفاده از اختلاف بین مقادیر کمینه و بیشینه در بیضی جستجو. گزینه‌های عمومی (Common Options): \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده به‌صورت سند JSON و خروج \-\-config = گزینه پیکربندی [می‌تواند تکرار شود] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp این برنامه یک شبکه منظم (رستر) از داده‌های پراکنده خوانده‌شده از یک مجموعه داده برداری ایجاد می‌کند. داده‌های ورودی برای پر کردن گره‌های شبکه با مقادیر درونیابی خواهند شد؛ شما می‌توانید از میان روش‌های مختلف درونیابی انتخاب کنید. .sp امکان تنظیم گزینه پیکربندی \fI\%GDAL_NUM_THREADS\fP برای موازی‌سازی پردازش وجود دارد. مقدار قابل تعیین برابر است با تعداد نخ‌های پردازشی (worker threads)، یا \fBALL_CPUS\fP برای استفاده از تمامی هسته‌ها/پردازنده‌های رایانه. .sp از نسخه GDAL 3.12، این الگوریتم می‌تواند بخشی از یک \fI\%gdal pipeline\fP باشد\&. .SH "گزینه‌های مشترک بین تمامی الگوریتم‌ها (OPTIONS COMMON TO ALL ALGORITHMS)" .SS "گزینه‌های استاندارد (Standard options)" .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format تعیین فرمت رستر خروجی مورد استفاده. مقادیر مجاز را می‌توان با دستور زیر به دست آورد: \fBgdal \-\-formats | grep raster | grep + | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از فرمت‌ها دارای یک یا چند گزینه اختیاری ساخت مجموعه داده هستند که می‌توان از آن‌ها برای کنترل جزئیات فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoPackage از گزینه‌های ساخت برای کنترل نسخه پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ساخت مجموعه داده در دسترس بر اساس درایور فرمت متفاوت است، و برخی از فرمت‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک فرمت را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات مربوط به همان فرمت منبع اصلی اطلاعات درباره گزینه‌های ساخت درایور است. برای گزینه‌های مجاز ساخت در هر فرمت، به مستندات اختصاصی فرمت \fI\%Vector drivers\fP مراجعه کنید. .sp توجه داشته باشید که گزینه‌های ساخت مجموعه داده با گزینه‌های ساخت لایه متفاوت هستند. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite به برنامه اجازه می‌دهد تا فایل یا مجموعه داده هدف موجود را رونویسی کند. در غیر این صورت، به‌طور پیش‌فرض، اگر فایل یا مجموعه داده هدف از قبل وجود داشته باشد، \fBgdal\fP با خطا مواجه می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-l, \-\-layer, \-\-layer\-name لایه(ها)یی از منبع داده را مشخص می‌کند که برای عوارض ورودی استفاده خواهند شد. می‌تواند چندین بار مشخص شود. .UNINDENT .INDENT 0.0 .TP .B \-\-sql |@ یک عبارت SQL که روی منبع داده ارزیابی می‌شود تا یک لایه مجازی از عوارض برای حک شدن (burn in) تولید کند. می‌توان از ساختار @filename برای مشخص کردن اینکه محتوا در نام فایل اشاره‌شده قرار دارد استفاده کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-extent ,,, تنظیم محدوده دارای ارجاع جغرافیایی (georeferenced extents). مقادیر باید بر حسب واحدهای ارجاع جغرافیایی بیان شوند. در صورت عدم تعیین، محدوده فایل خروجی همان محدوده لایه‌های برداری خواهد بود. .UNINDENT .INDENT 0.0 .TP .B \-\-resolution , تنظیم تفکیک‌پذیری (رزولوشن) هدف. مقادیر باید بر حسب واحدهای ارجاع جغرافیایی بیان شوند. هر دو مقدار باید مثبت باشند. توجه داشته باشید که \fI\-\-resolution\fP نمی‌تواند همراه با \fI\-\-size\fP استفاده شود\&. .UNINDENT .INDENT 0.0 .TP .B \-\-size , تنظیم اندازه فایل خروجی بر حسب پیکسل و خط. توجه داشته باشید که \fI\-\-size\fP نمی‌تواند همراه با \fI\-\-resolution\fP استفاده شود\&. .UNINDENT .INDENT 0.0 .TP .B \-\-ot, \-\-datatype, \-\-output\-data\-type باندهای خروجی را ملزم می‌کند که از نوع داده مشخص‌شده باشند. پیش‌فرض \fBFloat64\fP است\&. .UNINDENT .INDENT 0.0 .TP .B \-\-crs بازنویسی سیستم تصویر (projection) برای فایل خروجی. در صورت عدم تعیین، از سیستم تصویر فایل برداری ورودی در صورت موجود بودن استفاده می‌شود. هنگام استفاده از این گزینه، هیچ بازتصویرسازی از عوارض از CRS وکتور ورودی به CRS مشخص‌شده برای رستر خروجی انجام نمی‌شود؛ بنابراین تنها برای تصحیح یک CRS مبدأ نامعتبر از این گزینه استفاده کنید. \fB\fP می‌تواند هر یک از قالب‌های معمول GDAL/OGR، ساختار کامل WKT، PROJ.4، EPSG:n یا فایلی حاوی WKT باشد. .UNINDENT .INDENT 0.0 .TP .B \-\-bbox ,,, تنها نقاطی را انتخاب می‌کند که درون کادر احاطه‌کننده (bounding box) مشخص‌شده قرار دارند. .UNINDENT .INDENT 0.0 .TP .B \-\-zfield یک فیلد توصیفی را روی عوارض مشخص می‌کند که برای به دست آوردن مقدار Z از آن استفاده می‌شود. این مقدار جایگزین مقدار Z خوانده‌شده از رکورد هندسه عارضه می‌شود (طبیعتاً در صورتی که مقدار Z در هندسه داشته باشید؛ در غیر این صورت چاره‌ای ندارید و باید نام فیلدی حاوی یک مقدار Z را مشخص کنید). .UNINDENT .INDENT 0.0 .TP .B \-\-zincrease مقدار افزایشی به فیلد توصیفی روی عوارض که برای دریافت مقدار Z از آن استفاده می‌شود. مقدار افزوده باید دارای همان واحد مقدار Z باشد. مقدار حاصل برابر با مقدار Z + مقدار افزایش Z خواهد بود. مقدار پیش‌فرض 0 است. .UNINDENT .INDENT 0.0 .TP .B \-\-zmultiply این ضریب ضرب برای فیلد Z است. از این مقدار می‌توان برای تبدیل، مثلاً از فوت به متر یا از ارتفاع به عمق استفاده کرد. مقدار حاصل برابر با (مقدار Z + مقدار افزایش Z) * مقدار ضریب Z خواهد بود. مقدار پیش‌فرض 1 است. .UNINDENT.SS "گزینه‌های پیشرفته (Advanced options)" .INDENT 0.0 .TP .B \-\-oo, \-\-open\-option = گزینه باز کردن مجموعه داده (وابسته به قالب). .sp می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-if, \-\-input\-format نام قالب/راه‌انداز برای تلاش جهت باز کردن فایل(های) ورودی. معمولاً مشخص کردن آن ضروری نیست، اما هنگامی که تشخیص خودکار راه‌انداز در انتخاب راه‌انداز مناسب ناموفق است، می‌تواند برای رد کردن تشخیص خودکار استفاده شود. این گزینه می‌تواند چندین بار برای تعیین چند راه‌انداز نامزد تکرار شود. توجه داشته باشید که این گزینه راه‌اندازها را ملزم به باز کردن مجموعه داده نمی‌کند. به‌ویژه، برخی راه‌اندازها نیازمندی‌هایی برای پسوند فایل دارند. .sp می‌تواند تکرار شود. .UNINDENT .SH "الگوریتم \(dqINVDIST\(dq (INVDIST ALGORITHM)" .sp درونیابی با استفاده از معکوس فاصله به توان. .sp هنگامی که \fI\%\-\-min\-points\-per\-quadrant\fP یا \fI\%\-\-max\-points\-per\-quadrant\fP مشخص شده باشد، الگوریتم واقعی مورد استفاده \(dqinvdistnn\(dq است. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-power توان وزن‌دهی (پیش‌فرض 2.0). .UNINDENT .INDENT 0.0 .TP .B \-\-smoothing پارامتر هموارسازی (پیش‌فرض 0.0). .UNINDENT .INDENT 0.0 .TP .B \-\-radius تنظیم شعاع اول و دوم (مانعة‌الجمع با \fI\%\-\-radius1\fP و \fI\%\-\-radius2\fP\&). به‌طور پیش‌فرض، از کل آرایه نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-radius1 شعاع اول بیضی جستجو (محور X اگر زاویه چرخش 0 باشد). به‌طور پیش‌فرض، از کل آرایه نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-radius2 شعاع دوم بیضی جستجو (محور Y اگر زاویه چرخش 0 باشد). به‌طور پیش‌فرض، از کل آرایه نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-angle زاویه چرخش بیضی جستجو بر حسب درجه (پادساعت‌گرد، پیش‌فرض 0 است). .UNINDENT .INDENT 0.0 .TP .B \-\-max\-points حداکثر تعداد نقاط داده برای استفاده. برای بیش از این تعداد نقطه جستجو نشود. این گزینه تنها زمانی قابل استفاده است که بیضی جستجو تنظیم شده باشد (هر دو شعاع غیر صفر باشند). به‌طور پیش‌فرض، محدودیتی وجود ندارد. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-points حداقل تعداد نقاط داده برای استفاده. اگر در بیضی جستجو نقاط کمتری از مقدار مشخص‌شده یافت شود، گره شبکه خالی در نظر گرفته شده و با مقدار nodata پر خواهد شد. این گزینه تنها زمانی قابل استفاده است که بیضی جستجو تنظیم شده باشد (هر دو شعاع غیر صفر باشند). به‌طور پیش‌فرض، محدودیتی وجود ندارد. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-points\-per\-quadrant حداکثر تعداد نقاط داده برای استفاده در هر ربع. به‌طور پیش‌فرض، محدودیتی وجود ندارد. در صورت مشخص شدن، الگوریتم برای هر یک از ربع‌های بالا\-راست، بالا\-چپ، پایین\-راست و بالا\-راست نسبت به نقطه‌ای که درونیابی می‌شود، تنها حداکثر تا max_points_per_quadrant نقطه را لحاظ خواهد کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-points\-per\-quadrant حداقل تعداد نقاط داده برای استفاده در هر ربع. به‌طور پیش‌فرض، محدودیتی وجود ندارد. در صورت مشخص شدن، الگوریتم برای هر یک از ربع‌های بالا\-راست، بالا\-چپ، پایین\-راست و بالا\-راست نسبت به نقطه‌ای که درونیابی می‌شود، حداقل min_points_per_quadrant نقطه را جمع‌آوری خواهد کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-nodata مقدار nodata برای پر کردن نقاط خالی (پیش‌فرض 0 است). .UNINDENT.SH "الگوریتم INVDISTNN (INVDISTNN ALGORITHM)" .sp درون‌یابی با استفاده از معکوس فاصله با توان مشخص همراه با جستجوی نزدیک‌ترین همسایه، ایده‌آل برای زمان‌هایی که \fI\%\-\-max\-points\fP استفاده می‌شود. .sp هنگامی که \fI\%\-\-min\-points\-per\-quadrant\fP یا \fI\%\-\-max\-points\-per\-quadrant\fP مشخص شده باشد، جستجو با نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع اول آغاز می‌شود، سپس نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع دوم و به همین ترتیب تا ربع چهارم ادامه می‌یابد؛ سپس با نزدیک‌ترین نقطه بعدی در ربع اول و غیره ادامه پیدا می‌کند تا زمانی که آستانه‌های \fI\%\-\-max\-points\fP و/یا \fI\%\-\-max\-points\-per\-quadrant\fP برآورده شوند. .SS "گزینه الزامی (Required option)" .INDENT 0.0 .TP .B \-\-radius تنظیم شعاع جستجو (با \fI\%\-\-radius1\fP و \fI\%\-\-radius2\fP مانعة‌الجمع است). الزامی. .UNINDENT .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-power توان وزن‌دهی (پیش‌فرض 2.0). .UNINDENT .INDENT 0.0 .TP .B \-\-smoothing پارامتر هموارسازی (پیش‌فرض 0.0). .UNINDENT .INDENT 0.0 .TP .B \-\-max\-points حداکثر تعداد نقاط داده برای استفاده. بیش از این تعداد نقطه جستجو نخواهد شد. این گزینه تنها در صورتی قابل استفاده است که بیضی جستجو تنظیم شده باشد (هر دو شعاع غیر صفر باشند). به طور پیش‌فرض، بدون محدودیت است. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-points حداقل تعداد نقاط داده برای استفاده. اگر تعداد نقاط یافت‌شده در بیضی جستجو کمتر از مقدار مشخص‌شده باشد، گره شبکه خالی در نظر گرفته شده و با مقدار nodata پر می‌شود. این گزینه تنها در صورتی قابل استفاده است که بیضی جستجو تنظیم شده باشد (هر دو شعاع غیر صفر باشند). به طور پیش‌فرض، بدون محدودیت است. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-points\-per\-quadrant حداکثر تعداد نقاط داده برای استفاده در هر ربع. به طور پیش‌فرض، بدون محدودیت است. در صورت مشخص شدن، الگوریتم تنها تا سقف max_points_per_quadrant نقطه را برای هر یک از ربع‌های بالا\-راست، بالا\-چپ، پایین\-راست و بالا\-راست نسبت به نقطه در حال درون‌یابی در نظر خواهد گرفت. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-points\-per\-quadrant حداقل تعداد نقاط داده برای استفاده در هر ربع. به طور پیش‌فرض، بدون محدودیت است. در صورت مشخص شدن، الگوریتم حداقل min_points_per_quadrant نقطه را برای هر یک از ربع‌های بالا\-راست، بالا\-چپ، پایین\-راست و بالا\-راست نسبت به نقطه در حال درون‌یابی جمع‌آوری خواهد کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-nodata مقدار nodata برای پر کردن نقاط خالی (پیش‌فرض 0 است). .UNINDENT .SH "الگوریتم میانگین (AVERAGE ALGORITHM)" .sp درون‌یابی با استفاده از الگوریتم میانگین متحرک. .sp هنگامی که \fI\%\-\-min\-points\-per\-quadrant\fP یا \fI\%\-\-max\-points\-per\-quadrant\fP مشخص شده باشد، جستجو با نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع اول آغاز می‌شود، سپس نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع دوم و به همین ترتیب تا ربع چهارم ادامه می‌یابد؛ سپس با نزدیک‌ترین نقطه بعدی در ربع اول و غیره ادامه پیدا می‌کند تا زمانی که آستانه‌های \fI\%\-\-max\-points\fP و/یا \fI\%\-\-max\-points\-per\-quadrant\fP برآورده شوند. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-radius تنظیم شعاع اول و دوم (با \fI\%\-\-radius1\fP و \fI\%\-\-radius2\fP مانعة‌الجمع است). به طور پیش‌فرض، از کل آرایه نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-radius1 شعاع اول (محور X در صورتی که زاویه چرخش 0 باشد) بیضی جستجو. به طور پیش‌فرض، از کل آرایه نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-radius2 شعاع دوم (محور Y در صورتی که زاویه چرخش 0 باشد) بیضی جستجو. به طور پیش‌فرض، از کل آرایه نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-angle زاویه چرخش بیضی جستجو بر حسب درجه (پادساعت‌گرد، پیش‌فرض 0 است). .UNINDENT .INDENT 0.0 .TP .B \-\-max\-points حداکثر تعداد نقاط داده برای استفاده. بیش از این تعداد نقطه جستجو نخواهد شد. این گزینه تنها در صورتی قابل استفاده است که بیضی جستجو تنظیم شده باشد (هر دو شعاع غیر صفر باشند). به طور پیش‌فرض، بدون محدودیت است. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-points حداقل تعداد نقاط داده برای استفاده. اگر تعداد نقاط یافت‌شده در بیضی جستجو کمتر از مقدار مشخص‌شده باشد، گره شبکه خالی در نظر گرفته شده و با مقدار nodata پر می‌شود. این گزینه تنها در صورتی قابل استفاده است که بیضی جستجو تنظیم شده باشد (هر دو شعاع غیر صفر باشند). به طور پیش‌فرض، بدون محدودیت است. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-points\-per\-quadrant حداکثر تعداد نقاط داده برای استفاده در هر ربع. به طور پیش‌فرض، بدون محدودیت است. در صورت مشخص شدن، الگوریتم تنها تا سقف max_points_per_quadrant نقطه را برای هر یک از ربع‌های بالا\-راست، بالا\-چپ، پایین\-راست و بالا\-راست نسبت به نقطه در حال درون‌یابی در نظر خواهد گرفت. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-points\-per\-quadrant حداقل تعداد نقاط داده برای استفاده در هر ربع. به طور پیش‌فرض، بدون محدودیت است. در صورت مشخص شدن، الگوریتم حداقل min_points_per_quadrant نقطه را برای هر یک از ربع‌های بالا\-راست، بالا\-چپ، پایین\-راست و بالا\-راست نسبت به نقطه در حال درون‌یابی جمع‌آوری خواهد کرد. .UNINDENT .INDENT 0.0 .TP .B \-\-nodata مقدار nodata برای پر کردن نقاط خالی (پیش‌فرض 0 است). .UNINDENT.SH "الگوریتم «NEAREST» (NEAREST ALGORITHM)" .sp میان‌یابی با استفاده از الگوریتم نزدیک‌ترین همسایه. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-radius تنظیم شعاع اول و دوم (ناسازگار با \fI\%\-\-radius1\fP و \fI\%\-\-radius2\fP\&). به‌طور پیش‌فرض، از کل آرایهٔ نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-radius1 شعاع اول بیضی جستجو (محور X اگر زاویهٔ چرخش 0 باشد). به‌طور پیش‌فرض، از کل آرایهٔ نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-radius2 شعاع دوم بیضی جستجو (محور Y اگر زاویهٔ چرخش 0 باشد). به‌طور پیش‌فرض، از کل آرایهٔ نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-angle زاویهٔ چرخش بیضی جستجو بر حسب درجه (پادساعت‌گرد، پیش‌فرض 0 است). .UNINDENT .INDENT 0.0 .TP .B \-\-nodata مقدار nodata برای پر کردن نقاط خالی (پیش‌فرض 0 است). .UNINDENT .SH "الگوریتم «LINEAR» (LINEAR ALGORITHM)" .sp میان‌یابی خطی با محاسبهٔ مثلث‌بندی دلاونی (Delaunay triangulation) ابر نقاط، یافتن این‌که نقطه در کدام مثلث از مثلث‌بندی واقع شده است، و انجام میان‌یابی خطی از روی مختصات گرانیگاهی (barycentric) آن در درون مثلث. اگر نقطه در هیچ مثلثی قرار نداشته باشد، بسته به شعاع، الگوریتم از مقدار نزدیک‌ترین نقطه یا مقدار nodata استفاده خواهد کرد. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-radius در صورتی که نقطهٔ مورد نظر برای میان‌یابی در هیچ مثلثی از مثلث‌بندی دلاونی جای نگیرد، از این بیشینهٔ فاصله برای جستجوی نزدیک‌ترین همسایه استفاده می‌شود، وگرنه از nodata استفاده خواهد شد. اگر تعیین نشود، فاصلهٔ جستجو بی‌نهایت است. اگر روی 0 تنظیم شود، همیشه از مقدار nodata استفاده خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-nodata مقدار nodata برای پر کردن نقاط خالی (پیش‌فرض 0 است). .UNINDENT .SH "الگوریتم‌های معیارهای داده (DATA METRICS ALGORITHMS)" .sp علاوه بر قابلیت میان‌یابی، \fBgdal vector grid\fP می‌تواند برای محاسبهٔ برخی معیارهای داده با استفاده از پنجره و هندسهٔ شبکهٔ خروجی مشخص‌شده به کار رود. این معیارها عبارتند از: .INDENT 0.0 .IP \(bu 2 \fBminimum\fP: حداقل مقدار یافت‌شده در بیضی جستجوی گره شبکه. .IP \(bu 2 \fBmaximum\fP: حداکثر مقدار یافت‌شده در بیضی جستجوی گره شبکه. .IP \(bu 2 \fBrange\fP: اختلاف میان مقادیر کمینه و بیشینهٔ یافت‌شده در بیضی جستجوی گره شبکه. .IP \(bu 2 \fBcount\fP: تعداد نقاط دادهٔ یافت‌شده در بیضی جستجوی گره شبکه. .IP \(bu 2 \fBaverage\-distance\fP: میانگین فاصلهٔ بین گره شبکه (مرکز بیضی جستجو) و تمام نقاط دادهٔ یافت‌شده در بیضی جستجوی گره شبکه. .IP \(bu 2 \fBaverage\-distance\-points\fP: میانگین فاصلهٔ بین نقاط دادهٔ یافت‌شده در بیضی جستجوی گره شبکه. فاصلهٔ بین هر جفت نقطه درون بیضی محاسبه شده و میانگین تمام فواصل به عنوان مقدار گره شبکه تنظیم می‌شود. .UNINDENT .sp تمام معیارها دارای مجموعه گزینه‌های یکسانی هستند: .INDENT 0.0 .TP .B \-\-radius تنظیم شعاع اول و دوم (ناسازگار با \fI\%\-\-radius1\fP و \fI\%\-\-radius2\fP\&). به‌طور پیش‌فرض، از کل آرایهٔ نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-radius1 شعاع اول بیضی جستجو (محور X اگر زاویهٔ چرخش 0 باشد). به‌طور پیش‌فرض، از کل آرایهٔ نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-radius2 شعاع دوم بیضی جستجو (محور Y اگر زاویهٔ چرخش 0 باشد). به‌طور پیش‌فرض، از کل آرایهٔ نقاط استفاده می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-angle زاویهٔ چرخش بیضی جستجو بر حسب درجه (پادساعت‌گرد، پیش‌فرض 0 است). .UNINDENT .INDENT 0.0 .TP .B \-\-min\-points حداقل تعداد نقاط داده برای استفاده. اگر تعداد نقاط یافت‌شده در بیضی جستجو کمتر از مقدار مشخص‌شده باشد، گره شبکه خالی در نظر گرفته شده و با مقدار nodata پر خواهد شد. این گزینه تنها زمانی قابل استفاده است که بیضی جستجو تنظیم شده باشد (هر دو شعاع غیر صفر باشند). به‌طور پیش‌فرض، هیچ محدودیتی وجود ندارد. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-points\-per\-quadrant حداکثر تعداد نقاط داده برای استفاده در هر ربع. به‌طور پیش‌فرض، هیچ محدودیتی وجود ندارد. در صورت مشخص شدن، الگوریتم نسبت به نقطه‌ای که میان‌یابی می‌شود، برای هر یک از ربع‌های بالا\-راست، بالا\-چپ، پایین\-راست و بالا\-راست حداکثر تا max_points_per_quadrant نقطه را در نظر می‌گیرد. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-points\-per\-quadrant حداقل تعداد نقاط داده برای استفاده در هر ربع. به‌طور پیش‌فرض، هیچ محدودیتی وجود ندارد. اگر به این تعداد نرسد، نقطهٔ در حال میان‌یابی با مقدار nodata تنظیم خواهد شد. در صورت مشخص شدن، الگوریتم نسبت به نقطه‌ای که میان‌یابی می‌شود، حداقل min_points_per_quadrant نقطه را برای هر یک از ربع‌های بالا\-راست، بالا\-چپ، پایین\-راست و بالا\-راست جمع‌آوری می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-nodata مقدار nodata برای پر کردن نقاط خالی (پیش‌فرض 0 است). .UNINDENT .sp هنگامی که \fI\%\-\-min\-points\-per\-quadrant\fP یا \fI\%\-\-max\-points\-per\-quadrant\fP مشخص شود، جستجو با نزدیک‌ترین نقطه به نقطهٔ در حال میان‌یابی از ربع اول آغاز می‌شود، سپس نزدیک‌ترین نقطه به نقطهٔ در حال میان‌یابی از ربع دوم و به همین ترتیب تا ربع چهارم، و با نزدیک‌ترین نقطهٔ بعدی در ربع اول و غیره ادامه می‌یابد تا زمانی که آستانه‌های \fI\%\-\-max\-points\fP و/یا \fI\%\-\-max\-points\-per\-quadrant\fP حاصل شوند..SH "خواندن مقادیر جداشده با کاما (READING COMMA SEPARATED VALUES)" .sp اغلب برای کار، یک فایل متنی حاوی فهرستی از مقادیر XYZ جداشده با کاما (به‌اصطلاح فایل CSV) در اختیار دارید. می‌توانید به‌راحتی از این نوع منبع داده در \fBgdal vector grid\fP\& استفاده کنید. تنها کاری که باید انجام دهید ساخت یک سربرگ مجموعه داده مجازی (VRT) برای فایل CSV و استفاده از آن به‌عنوان منبع داده ورودی برای \fBgdal vector grid\fP\& است. می‌توانید جزئیات مربوط به قالب VRT را در صفحه توضیحات \fI\%VRT \-\- OGR Virtual Format\fP بیابید. .sp در اینجا یک مثال کوچک آورده شده است. فرض کنید یک فایل CSV به نام \fIdem.csv\fP با محتوای زیر داریم: .INDENT 0.0 .INDENT 3.5 .sp .EX Easting,Northing,Elevation 86943.4,891957,139.13 87124.3,892075,135.01 86962.4,892321,182.04 87077.6,891995,135.01 \&... .EE .UNINDENT .UNINDENT .sp برای داده‌های بالا، یک سربرگ \fIdem.vrt\fP با محتوای زیر ایجاد می‌کنیم: .INDENT 0.0 .INDENT 3.5 .sp .EX dem.csv wkbPoint .EE .UNINDENT .UNINDENT .sp این توصیف، یک هندسه به‌اصطلاح 2.5D با سه مختصات X، Y و Z را مشخص می‌کند. مقدار Z برای درون‌یابی استفاده خواهد شد. اکنون می‌توانید از \fIdem.vrt\fP در تمام برنامه‌های OGR استفاده کنید (برای اطمینان از صحت عملکرد، ابتدا با \fI\%ogrinfo\fP آزمایش کنید). این منبع داده شامل یک لایه منفرد به نام \fI\(dqdem\(dq\fP خواهد بود که با عوارض نقطه‌ای ساخته‌شده از مقادیر فایل CSV پر شده است. با استفاده از این روش می‌توانید فایل‌های CSV با بیش از سه ستون را مدیریت کنید، ستون‌ها را جابه‌جا کنید و غیره. بسیار خوب، اکنون مرحله نهایی: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector grid invdist dem.vrt demv.tif .EE .UNINDENT .UNINDENT .sp یا در صورتی که مایل به استفاده از فایل VRT نباشیم: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector grid invdist \-l dem \-oo X_POSSIBLE_NAMES=Easting \e \-oo Y_POSSIBLE_NAMES=Northing \-\-zfield=Elevation dem.csv dem.tif .EE .UNINDENT .UNINDENT .sp اگر فایل CSV شما فاقد سرستون باشد، می‌توان آن را در فایل VRT به روش زیر مدیریت کرد: .INDENT 0.0 .INDENT 3.5 .sp .EX .EE .UNINDENT .UNINDENT .sp صفحه توضیحات \fI\%Comma Separated Value (.csv)\fP شامل جزئیات قالب CSV پشتیبانی‌شده توسط GDAL است. .sp در نسخه 3.12 اضافه شد..SH "خروجی GDALG (مجموعه‌داده در لحظه / جریانی) (GDALG OUTPUT)" .sp این برنامه از سریال‌سازی خط فرمان به عنوان یک فایل JSON با استفاده از قالب خروجی \fBGDALG\fP پشتیبانی می‌کند. فایل حاصل را می‌توان سپس با استفاده از درایور \fI\%GDALG: GDAL Streamed Algorithm\fP به عنوان یک مجموعه‌داده رستری باز کرد و خط لوله مشخص‌شده را به صورت در لحظه (on\-the\-fly) / جریانی اعمال نمود. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 با این حال این الگوریتم به طور ذاتی با جریان‌سازی سازگار نیست. در نتیجه یک مجموعه‌داده موقت ایجاد خواهد شد که ممکن است زمان پردازش قابل‌توجهی را هنگام باز شدن مصرف کند. .UNINDENT .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا، مقداری غیر از صفر را بازمی‌گرداند (خطاهای غیرمسدودکننده که به شکل هشدار اعلام می‌شوند، به عنوان اجرای موفق در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: ایجاد یک رستر از منبع داده VRT با استفاده از روش عکس توان فاصله" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector grid invdist \-\-power=2.0 \-\-smoothing=1.0 \-\-extent=85000,894000,89000,890000 \e \-\-size=400,400 \-l dem dem.vrt dem.tif .EE .UNINDENT .UNINDENT .sp این مثال با استفاده از روش عکس توان فاصله، یک فایل رستری TIFF از منبع داده VRT شرح‌داده‌شده در بخش \fI\%Reading comma separated values\fP ایجاد می‌کند. مقادیر مورد نیاز برای درون‌یابی از مقدار Z رکورد هندسی خوانده خواهند شد. .SS "مثال ۲: خواندن مقادیر درون‌یابی از یک فیلد توصیفی" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal vector grid invdist \-\-zfield=Elevation \-\-config GDAL_NUM_THREADS ALL_CPUS \e \-\-power=2.0 \-\-smoothing=1.0 \-\-extent=85000,894000,89000,890000 \e \-\-size=400,400 \-l dem dem.vrt dem.tif .EE .UNINDENT .UNINDENT .sp این دستور همان عملیات دستور قبل را انجام می‌دهد، با این تفاوت که مقادیر مورد نیاز برای درون‌یابی را به‌جای رکورد هندسی، از فیلد مشخص‌شده با گزینه \fI\%\-\-zfield\fP می‌خواند. بنابراین در این حالت مختصات X و Y از هندسه و Z از فیلد \fI\(dqElevation\(dq\fP گرفته می‌شوند. همچنین \fI\%GDAL_NUM_THREADS\fP برای موازی‌سازی محاسبات تنظیم شده است. .SH "نویسندگان (AUTHORS)" Even Rouault .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .