.\" 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_GRID" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal_grid \- ایجاد شبکه منظم (رستر) از داده‌های پراکنده .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_grid [\-\-help] [\-\-help\-general] [\-ot {Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/ CInt16/CInt32/CFloat32/CFloat64}] [\-oo =]... [\-of ] [\-co =]... [\-zfield ] [\-z_increase ] [\-z_multiply ] [\-a_srs ] [\-spat ] [\-clipsrc |||spat_extent] [\-clipsrcsql ] [\-clipsrclayer ] [\-clipsrcwhere ] [\-l ]... [\-where ] [\-sql ] [\-txe ] [\-tye ] [\-tr ] [\-outsize ] [\-a {[[:=]...]}] [\-q] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp این برنامه یک شبکه منظم (رستر) را از داده‌های پراکنده خوانده‌شده از منبع داده OGR ایجاد می‌کند. داده‌های ورودی برای پر کردن گره‌های شبکه با مقادیر، درون‌یابی می‌شوند و شما می‌توانید از میان روش‌های مختلف درون‌یابی انتخاب کنید. .sp امکان تنظیم گزینه پیکربندی \fI\%GDAL_NUM_THREADS\fP برای موازی‌سازی پردازش وجود دارد. مقدار مشخص‌شده تعداد ریسمان‌های پردازشی (worker threads)، یا \fBALL_CPUS\fP برای استفاده از تمام هسته‌ها/پردازنده‌های رایانه است. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 معادل در رابط خط فرمان جدید \(dqgdal\(dq: .sp بخش \fI\%gdal vector grid\fP را ببینید. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-help نمایش این پیام راهنما و خروج. .UNINDENT .INDENT 0.0 .TP .B \-\-help\-general نمایش یک پیام کاربردی کوتاه برای گزینه‌های عمومی خط فرمان GDAL و خروج. .UNINDENT .INDENT 0.0 .TP .B \-q, \-\-quiet عدم نمایش پیام‌های پیشرفت و سایر خروجی‌های غیرخطا. .UNINDENT .INDENT 0.0 .TP .B \-ot اجبار باندهای تصویر خروجی به داشتن یک نوع داده مشخص که توسط درایور پشتیبانی می‌شود؛ این مقدار می‌تواند یکی از موارد زیر باشد: \fBByte\fP، \fBInt8\fP، \fBUInt16\fP، \fBInt16\fP، \fBUInt32\fP، \fBInt32\fP، \fBUInt64\fP، \fBInt64\fP، \fBFloat32\fP، \fBFloat64\fP، \fBCInt16\fP، \fBCInt32\fP، \fBCFloat32\fP یا \fBCFloat64\fP\&. .UNINDENT .sp اگر تنظیم نشود، یک نوع پیش‌فرض استفاده می‌شود که ممکن است توسط درایور مربوطه پشتیبانی نشود و موجب بروز خطا گردد. .INDENT 0.0 .TP .B \-of انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند فایل تشخیص داده می‌شود. از نام کوتاه قالب استفاده کنید. .UNINDENT .INDENT 0.0 .TP .B \-txe تنظیم محدوده زمین‌مرجع‌شده محور X برای فایل خروجی در حال ایجاد. .UNINDENT .INDENT 0.0 .TP .B \-tye تنظیم محدوده زمین‌مرجع‌شده محور Y برای فایل خروجی در حال ایجاد. .UNINDENT .INDENT 0.0 .TP .B \-tr تنظیم تفکیک‌پذیری فایل خروجی (بر حسب واحدهای زمین‌مرجع‌شده مقصد). توجه داشته باشید که \fI\%\-tr\fP فقط در ترکیب با ورودی معتبر از \fI\%\-txe\fP و \fI\%\-tye\fP کار می‌کند. .sp در نسخه 3.2 اضافه شد. .UNINDENT .INDENT 0.0 .TP .B \-outsize تنظیم اندازه فایل خروجی بر حسب پیکسل و سطر. توجه داشته باشید که \fI\%\-outsize\fP نمی‌تواند همراه با \fI\%\-tr\fP استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-a_srs بازنویسی سیستم تصویر فایل خروجی. \fIsrs_def\fP می‌تواند هر یک از اشکال معمول GDAL/OGR، شامل WKT کامل، PROJ.4، EPSG:n یا فایلی حاوی WKT باشد. هیچ بازتصویرسازی انجام نمی‌شود. .UNINDENT .INDENT 0.0 .TP .B \-zfield مشخص‌کننده یک فیلد توصیفی در عوارض که برای دریافت مقدار Z استفاده می‌شود. این مقدار جایگزین مقدار Z خوانده‌شده از رکورد هندسه عارضه می‌شود (طبیعتاً اگر در هندسه مقدار Z داشته باشید، در غیر این صورت چاره‌ای ندارید و باید نام فیلدی حاوی مقدار Z را مشخص کنید). .UNINDENT .INDENT 0.0 .TP .B \-z_increase مقدار افزایشی برای افزودن به فیلد توصیفی عوارض که برای دریافت مقدار Z به کار می‌رود. این افزایش باید هم‌واحد با مقدار Z باشد. مقدار حاصل برابر با مقدار Z + مقدار افزایش Z خواهد بود. مقدار پیش‌فرض 0 است. .UNINDENT .INDENT 0.0 .TP .B \-z_multiply ضریب ضرب برای فیلد Z است. این گزینه می‌تواند برای تغییر واحد (مثلاً فوت به متر) یا از ارتفاع به عمق استفاده شود. مقدار حاصل برابر با (مقدار Z + مقدار افزایش Z) * مقدار ضریب Z خواهد بود. مقدار پیش‌فرض 1 است. .UNINDENT .INDENT 0.0 .TP .B \-a {[[:=]...]} تنظیم نام الگوریتم درون‌یابی یا سنجه داده و (به صورت اختیاری) پارامترهای آن. برای بررسی بیشتر گزینه‌های در دسترس، بخش‌های \fI\%الگوریتم‌های درون‌یابی (INTERPOLATION ALGORITHMS)\fP و \fI\%سنجه‌های داده (DATA METRICS)\fP را ببینید. .UNINDENT .INDENT 0.0 .TP .B \-spat افزودن یک فیلتر مکانی برای انتخاب فقط عوارضی که درون کادر محصورکننده توصیف‌شده با (xmin, ymin) \- (xmax, ymax) قرار دارند. .UNINDENT .INDENT 0.0 .TP .B \-clipsrc [ ]|||spat_extent افزودن یک فیلتر مکانی برای انتخاب فقط عوارضی که در کادر محصورکننده مشخص‌شده (بیان‌شده در SRS مبدا)، هندسه WKT (از نوع POLYGON یا MULTIPOLYGON)، از یک منبع داده یا در محدوده مکانی گزینه \fI\%\-spat\fP (در صورت استفاده از کلیدواژه \fBspat_extent\fP) قرار دارند. هنگام مشخص کردن منبع داده، عموماً می‌خواهید آن را در ترکیب با گزینه‌های \fI\%\-clipsrclayer\fP، \fI\%\-clipsrcwhere\fP یا \fI\%\-clipsrcsql\fP به کار ببرید. .UNINDENT .INDENT 0.0 .TP .B \-clipsrcsql انتخاب هندسه‌های مورد نظر با استفاده از یک پرس‌وجوی SQL به جای آن. .UNINDENT .INDENT 0.0 .TP .B \-clipsrclayer انتخاب لایه نام‌برده از منبع داده برش مبدا. .UNINDENT .INDENT 0.0 .TP .B \-clipsrcwhere محدود کردن هندسه‌های مورد نظر بر اساس یک پرس‌وجوی توصیفی. .UNINDENT .INDENT 0.0 .TP .B \-l نشان‌دهنده لایه(هایی) از منبع داده است که برای عوارض ورودی استفاده خواهد شد. می‌تواند چندین بار مشخص شود، اما حداقل یک نام لایه یا یک گزینه \fI\%\-sql\fP باید مشخص گردد. .UNINDENT .INDENT 0.0 .TP .B \-where یک عبارت پرس‌وجوی اختیاری به سبک SQL WHERE برای اعمال جهت انتخاب عوارض مورد پردازش از لایه(های) ورودی. .UNINDENT .INDENT 0.0 .TP .B \-sql یک دستور SQL برای ارزیابی روی منبع داده جهت تولید یک لایه مجازی از عوارض برای پردازش. .UNINDENT .INDENT 0.0 .TP .B \-oo = در نسخه 3.7 اضافه شد. .sp گزینه باز کردن مجموعه داده مبدا (وابسته به قالب) .UNINDENT .INDENT 0.0 .TP .B \-co = بسیاری از قالب‌ها یک یا چند گزینه ساخت اختیاری دارند که می‌توان برای کنترل جزئیات فایل ایجادشده استفاده کرد. به عنوان مثال، درایور GeoTIFF از گزینه‌های ساخت برای کنترل فشرده‌سازی و اینکه آیا فایل باید به صورت تایل‌بندی‌شده باشد یا خیر پشتیبانی می‌کند. .sp گزینه‌های ساخت موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً هیچ گزینه ساختی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-format\fP مشاهده کرد، اما مستندات مربوط به آن قالب منبع نهایی اطلاعات در مورد گزینه‌های ساخت درایور است. مستندات اختصاصی قالب در \fI\%درایورهای رستر (Raster drivers)\fP را برای گزینه‌های ساخت مجاز هر قالب ببینید. .UNINDENT .INDENT 0.0 .TP .B هر منبع داده قابل خواندن که توسط OGR پشتیبانی می‌شود. .UNINDENT .INDENT 0.0 .TP .B فایل خروجی پشتیبانی‌شده توسط GDAL. .UNINDENT .SH "الگوریتم‌های درون‌یابی (INTERPOLATION ALGORITHMS)" .sp تعدادی الگوریتم درون‌یابی برای انتخاب وجود دارد. .sp جزئیات بیشتر درباره آنها را نیز می‌توانید در \fI\%آموزش شبکه GDAL (GDAL Grid Tutorial)\fP بیابید. .SS invdist .sp توان عکس فاصله (Inverse distance to a power). این الگوریتم پیش‌فرض است و پارامترهای زیر را دارد: .INDENT 0.0 .IP \(bu 2 \fBpower\fP: توان وزن‌دهی (پیش‌فرض 2.0). .IP \(bu 2 \fBsmoothing\fP: پارامتر هموارسازی (پیش‌فرض 0.0). .IP \(bu 2 \fBradius1\fP: اولین شعاع بیضی جستجو (محور X در صورتی که زاویه چرخش 0 باشد). برای استفاده از کل آرایه نقاط، این پارامتر را صفر تنظیم کنید. پیش‌فرض 0.0 است. .IP \(bu 2 \fBradius2\fP: دومین شعاع بیضی جستجو (محور Y در صورتی که زاویه چرخش 0 باشد). برای استفاده از کل آرایه نقاط، این پارامتر را صفر تنظیم کنید. پیش‌فرض 0.0 است. .IP \(bu 2 \fBradius\fP: تنظیم شعاع اول و دوم (مانعة‌الجمع با radius1 و radius2). پیش‌فرض 0.0 است. در GDAL 3.6 اضافه شد. .IP \(bu 2 \fBangle\fP: زاویه چرخش بیضی جستجو بر حسب درجه (پادساعت‌گرد، پیش‌فرض 0.0). .IP \(bu 2 \fBmax_points\fP: حداکثر تعداد نقاط داده برای استفاده. نقاط بیشتری بیش از این تعداد جستجو نخواهد شد. این پارامتر فقط زمانی استفاده می‌شود که بیضی جستجو تنظیم شده باشد (هر دو شعاع غیرصفر باشند). مقدار صفر به این معنی است که تمام نقاط یافت‌شده باید استفاده شوند. پیش‌فرض 0 است. .IP \(bu 2 \fBmin_points\fP: حداقل تعداد نقاط داده برای استفاده. اگر تعداد نقاط کمتری یافت شود، گره شبکه خالی تلقی شده و با نشانگر NODATA پر خواهد شد. این پارامتر فقط در صورت تنظیم بیضی جستجو (هر دو شعاع غیرصفر) استفاده می‌شود. پیش‌فرض 0 است. .IP \(bu 2 \fBmax_points_per_quadrant\fP: حداکثر تعداد نقاط داده برای استفاده در هر ربع. پیش‌فرض 0 است. در GDAL 3.6 اضافه شد. در صورت مشخص شدن، در واقع از پیاده‌سازی invdistnn استفاده می‌شود. .IP \(bu 2 \fBmin_points_per_quadrant\fP: حداقل تعداد نقاط داده برای استفاده در هر ربع. پیش‌فرض 0 است. در GDAL 3.6 اضافه شد. در صورت مشخص شدن، در واقع از پیاده‌سازی invdistnn استفاده می‌شود. .IP \(bu 2 \fBnodata\fP: نشانگر NODATA برای پر کردن نقاط خالی (پیش‌فرض 0.0). .UNINDENT .SS invdistnn .sp توان عکس فاصله همراه با جستجوی نزدیک‌ترین همسایه، مناسب برای زمانی که max_points استفاده می‌شود. پارامترهای زیر را دارد: .INDENT 0.0 .IP \(bu 2 \fBpower\fP: توان وزن‌دهی (پیش‌فرض 2.0). .IP \(bu 2 \fBsmoothing\fP: پارامتر هموارسازی (پیش‌فرض 0.0). .IP \(bu 2 \fBradius\fP: شعاع دایره جستجو که باید غیرصفر باشد. پیش‌فرض 1.0 است. .IP \(bu 2 \fBmax_points\fP: حداکثر تعداد نقاط داده برای استفاده. برای نقاط بیشتری بیش از این مقدار جستجو نکنید. نقاط یافت‌شده هنگام وزن‌دهی بر اساس فاصله از نزدیک‌ترین به دورترین رتبه‌بندی می‌شوند. پیش‌فرض 12 است. .IP \(bu 2 \fBmin_points\fP: حداقل تعداد نقاط داده برای استفاده. اگر تعداد نقاط کمتری یافت شود، گره شبکه خالی در نظر گرفته شده و با نشانگر NODATA پر می‌شود. پیش‌فرض 0 است. .IP \(bu 2 \fBmax_points_per_quadrant\fP: حداکثر تعداد نقاط داده برای استفاده در هر ربع. پیش‌فرض 0 است. در GDAL 3.6 اضافه شد. در صورت تعیین، الگوریتم برای هر یک از ربع‌های بالا-راست، بالا-چپ، پایین-راست و پایین-چپ نسبت به نقطه در حال درون‌یابی، حداکثر تا max_points_per_quadrant نقطه را لحاظ می‌کند. .IP \(bu 2 \fBmin_points_per_quadrant\fP: حداقل تعداد نقاط داده برای استفاده در هر ربع. پیش‌فرض 0 است. در GDAL 3.6 اضافه شد. اگر این تعداد حاصل نشود، نقطه در حال درون‌یابی با نشانگر NODATA تنظیم می‌شود. در صورت تعیین، الگوریتم حداقل min_points_per_quadrant نقطه را برای هر یک از ربع‌های بالا-راست، بالا-چپ، پایین-راست و پایین-چپ نسبت به نقطه در حال درون‌یابی جمع‌آوری می‌کند. .IP \(bu 2 \fBnodata\fP: نشانگر NODATA برای پر کردن نقاط خالی (پیش‌فرض 0.0). .UNINDENT .sp هنگامی که \fBmin_points_per_quadrant\fP یا \fBmax_points_per_quadrant\fP مشخص شود، جستجو با نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع اول شروع می‌شود، سپس نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع دوم و به همین ترتیب تا ربع چهارم، و با نزدیک‌ترین نقطه بعدی در ربع اول ادامه می‌یابد تا زمانی که به آستانه‌های \fBmax_points\fP و/یا \fBmax_points_per_quadrant\fP برسد. .SS average .sp الگوریتم میانگین متحرک (Moving average). پارامترهای زیر را دارد: .INDENT 0.0 .IP \(bu 2 \fBradius1\fP: اولین شعاع بیضی جستجو (محور X در صورتی که زاویه چرخش 0 باشد). برای استفاده از کل آرایه نقاط، این پارامتر را صفر قرار دهید. پیش‌فرض 0.0 است. .IP \(bu 2 \fBradius2\fP: دومین شعاع بیضی جستجو (محور Y در صورتی که زاویه چرخش 0 باشد). برای استفاده از کل آرایه نقاط، این پارامتر را صفر قرار دهید. پیش‌فرض 0.0 است. .IP \(bu 2 \fBradius\fP: تنظیم شعاع اول و دوم (مانعة‌الجمع با radius1 و radius2). پیش‌فرض 0.0 است. در GDAL 3.6 اضافه شد. .IP \(bu 2 \fBangle\fP: زاویه چرخش بیضی جستجو بر حسب درجه (پادساعت‌گرد، پیش‌فرض 0.0). .IP \(bu 2 \fBmax_points\fP: حداکثر تعداد نقاط داده برای استفاده. بیش از این تعداد نقطه جستجو نشود. نقاط یافت‌شده هنگام وزن‌دهی از نزدیک‌ترین به دورترین فاصله رتبه‌بندی می‌شوند. پیش‌فرض 0 است. در GDAL 3.6 اضافه شد. تنها در صورتی لحاظ می‌شود که یک یا هر دوی \fBmin_points_per_quadrant\fP یا \fBmax_points_per_quadrant\fP مشخص شده باشند. .IP \(bu 2 \fBmin_points\fP: حداقل تعداد نقاط داده برای استفاده. اگر تعداد نقاط کمتری یافت شود، گره شبکه خالی تلقی شده و با نشانگر NODATA پر خواهد شد. پیش‌فرض 0 است. .IP \(bu 2 \fBmax_points_per_quadrant\fP: حداکثر تعداد نقاط داده برای استفاده در هر ربع. پیش‌فرض 0 است. در GDAL 3.6 اضافه شد. در صورت تعیین، الگوریتم برای هر یک از ربع‌های بالا-راست، بالا-چپ، پایین-راست و پایین-چپ نسبت به نقطه در حال درون‌یابی، حداکثر تا max_points_per_quadrant نقطه را لحاظ می‌کند. .IP \(bu 2 \fBmin_points_per_quadrant\fP: حداقل تعداد نقاط داده برای استفاده در هر ربع. پیش‌فرض 0 است. در GDAL 3.6 اضافه شد. اگر این تعداد حاصل نشود، نقطه در حال درون‌یابی با نشانگر NODATA تنظیم می‌شود. در صورت تعیین، الگوریتم حداقل min_points_per_quadrant نقطه را برای هر یک از ربع‌های بالا-راست، بالا-چپ، پایین-راست و پایین-چپ نسبت به نقطه در حال درون‌یابی جمع‌آوری می‌کند. .IP \(bu 2 \fBnodata\fP: نشانگر NODATA برای پر کردن نقاط خالی (پیش‌فرض 0.0). .UNINDENT .sp توجه داشته باشید که تعیین بیضی جستجو برای روش میانگین متحرک ضروری است. این پنجره‌ای است که هنگام محاسبه مقادیر گره‌های شبکه میانگین‌گیری می‌شود. .sp هنگامی که \fBmin_points_per_quadrant\fP یا \fBmax_points_per_quadrant\fP مشخص شود، جستجو با نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع اول شروع می‌شود، سپس نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع دوم و به همین ترتیب تا ربع چهارم، و با نزدیک‌ترین نقطه بعدی در ربع اول ادامه می‌یابد تا زمانی که به آستانه‌های \fBmax_points\fP و/یا \fBmax_points_per_quadrant\fP برسد. .SS nearest .sp الگوریتم نزدیک‌ترین همسایه (Nearest neighbor). پارامترهای زیر را دارد: .INDENT 0.0 .IP \(bu 2 \fBradius1\fP: اولین شعاع بیضی جستجو (محور X در صورتی که زاویه چرخش 0 باشد). برای استفاده از کل آرایه نقاط، این پارامتر را صفر قرار دهید. پیش‌فرض 0.0 است. .IP \(bu 2 \fBradius2\fP: دومین شعاع بیضی جستجو (محور Y در صورتی که زاویه چرخش 0 باشد). برای استفاده از کل آرایه نقاط، این پارامتر را صفر قرار دهید. پیش‌فرض 0.0 است. .IP \(bu 2 \fBradius\fP: تنظیم شعاع اول و دوم (مانعة‌الجمع با radius1 و radius2). پیش‌فرض 0.0 است. در GDAL 3.6 اضافه شد. .IP \(bu 2 \fBangle\fP: زاویه چرخش بیضی جستجو بر حسب درجه (پادساعت‌گرد، پیش‌فرض 0.0). .IP \(bu 2 \fBnodata\fP: نشانگر NODATA برای پر کردن نقاط خالی (پیش‌فرض 0.0). .UNINDENT .SS linear .sp الگوریتم درون‌یابی خطی (Linear interpolation). .sp روش خطی با محاسبه مثلث‌بندی دلونی (Delaunay triangulation) ابر نقاط، یافتن اینکه نقطه در کدام مثلث از مثلث‌بندی قرار دارد و انجام درون‌یابی خطی بر اساس مختصات گرانیگاهی (barycentric) آن در درون مثلث، عمل درون‌یابی خطی را انجام می‌دهد. اگر نقطه در هیچ مثلثی قرار نگیرد، بسته به شعاع، الگوریتم از مقدار نزدیک‌ترین نقطه یا مقدار nodata استفاده خواهد کرد. .sp پارامترهای زیر را دارد: .INDENT 0.0 .IP \(bu 2 \fBradius\fP: در صورتی که نقطه مورد نظر برای درون‌یابی در هیچ مثلثی از مثلث‌بندی دلونی نگنجد، از این حداکثر فاصله برای جستجوی نزدیک‌ترین همسایه استفاده می‌شود، یا در غیر این صورت از nodata استفاده خواهد شد. اگر روی \-1 تنظیم شود، فاصله جستجو نامحدود است. اگر روی 0 تنظیم شود، همیشه مقدار nodata استفاده خواهد شد. پیش‌فرض \-1 است. .IP \(bu 2 \fBnodata\fP: نشانگر NODATA برای پر کردن نقاط خالی (پیش‌فرض 0.0). .UNINDENT .SH "سنجه‌های داده (DATA METRICS)" .sp علاوه بر قابلیت‌های درون‌یابی، می‌توان از \fBgdal_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_pts\fP: میانگین فاصله بین نقاط داده یافت‌شده در بیضی جستجوی گره شبکه. فاصله بین هر جفت نقطه در بیضی محاسبه شده و میانگین تمام فواصل به عنوان مقدار گره شبکه تنظیم می‌شود. .UNINDENT .sp تمام این سنجه‌ها مجموعه گزینه‌های یکسانی دارند: .INDENT 0.0 .IP \(bu 2 \fBradius1\fP: اولین شعاع بیضی جستجو (محور X در صورتی که زاویه چرخش 0 باشد). برای استفاده از کل آرایه نقاط، این پارامتر را صفر قرار دهید. پیش‌فرض 0.0 است. .IP \(bu 2 \fBradius2\fP: دومین شعاع بیضی جستجو (محور Y در صورتی که زاویه چرخش 0 باشد). برای استفاده از کل آرایه نقاط، این پارامتر را صفر قرار دهید. پیش‌فرض 0.0 است. .IP \(bu 2 \fBradius\fP: تنظیم شعاع اول و دوم (مانعة‌الجمع با radius1 و radius2). پیش‌فرض 0.0 است. در GDAL 3.6 اضافه شد. .IP \(bu 2 \fBangle\fP: زاویه چرخش بیضی جستجو بر حسب درجه (پادساعت‌گرد، پیش‌فرض 0.0). .IP \(bu 2 \fBmin_points\fP: حداقل تعداد نقاط داده برای استفاده. اگر تعداد نقاط کمتری یافت شود، گره شبکه خالی تلقی شده و با نشانگر NODATA پر خواهد شد. این پارامتر فقط در صورت تنظیم بیضی جستجو (هر دو شعاع غیرصفر) استفاده می‌شود. پیش‌فرض 0 است. .IP \(bu 2 \fBmax_points_per_quadrant\fP: حداکثر تعداد نقاط داده برای استفاده در هر ربع. پیش‌فرض 0 است. در GDAL 3.6 اضافه شد. در صورت تعیین، الگوریتم برای هر یک از ربع‌های بالا-راست، بالا-چپ، پایین-راست و پایین-چپ نسبت به نقطه در حال درون‌یابی، حداکثر تا max_points_per_quadrant نقطه را لحاظ می‌کند. .IP \(bu 2 \fBmin_points_per_quadrant\fP: حداقل تعداد نقاط داده برای استفاده در هر ربع. پیش‌فرض 0 است. در GDAL 3.6 اضافه شد. اگر این تعداد حاصل نشود، نقطه در حال درون‌یابی با نشانگر NODATA تنظیم می‌شود. در صورت تعیین، الگوریتم حداقل min_points_per_quadrant نقطه را برای هر یک از ربع‌های بالا-راست، بالا-چپ، پایین-راست و پایین-چپ نسبت به نقطه در حال درون‌یابی جمع‌آوری می‌کند. .IP \(bu 2 \fBnodata\fP: نشانگر NODATA برای پر کردن نقاط خالی (پیش‌فرض 0.0). .UNINDENT .sp هنگامی که \fBmin_points_per_quadrant\fP یا \fBmax_points_per_quadrant\fP مشخص شود، جستجو با نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع اول شروع می‌شود، سپس نزدیک‌ترین نقطه به نقطه در حال درون‌یابی از ربع دوم و به همین ترتیب تا ربع چهارم، و با نزدیک‌ترین نقطه بعدی در ربع اول ادامه می‌یابد تا زمانی که به آستانه‌های \fBmax_points\fP و/یا \fBmax_points_per_quadrant\fP برسد. .SH "خواندن مقادیر جداشده با کاما (READING COMMA SEPARATED VALUES)" .sp اغلب شما یک فایل متنی با فهرستی از مقادیر XYZ جداشده با کاما (فایل موسوم به CSV) برای کار دارید. می‌توانید به راحتی از این نوع منبع داده در \fBgdal_grid\fP استفاده کنید. تنها کاری که باید انجام دهید ساخت یک هدر مجموعه داده مجازی (VRT) برای فایل CSV خود و استفاده از آن به عنوان منبع داده ورودی برای \fBgdal_grid\fP است. می‌توانید جزئیات مربوط به قالب VRT را در صفحه توضیحات \fI\%قالب مجازی VRT \-\- OGR\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_grid dem.vrt demv.tif .EE .UNINDENT .UNINDENT .sp یا اگر تمایلی به استفاده از فایل VRT نداریم: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_grid \-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\%مقادیر جداشده با کاما (.csv)\fP حاوی جزئیات مربوط به قالب CSV پشتیبانی‌شده توسط GDAL/OGR است. .SH "ایجاد فایل‌های چندباندی (CREATING MULTIBAND FILES)" .sp ایجاد فایل‌های چندباندی به طور مستقیم با gdal_grid امکان‌پذیر نیست. می‌توان از gdal_grid چندین بار برای ایجاد یک باند به ازای هر فایل استفاده کرد، و سپس از \fI\%gdalbuildvrt\fP \-separate و پس از آن از \fI\%gdal_translate\fP بهره برد: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_grid ... 1.tif; gdal_grid ... 2.tif; gdal_grid ... 3.tif gdalbuildvrt \-separate 123.vrt 1.tif 2.tif 3.tif gdal_translate 123.vrt 123.tif .EE .UNINDENT .UNINDENT .sp یا فقط از \fI\%gdal_merge\fP برای ترکیب فایل‌های تک‌باندی به یک فایل واحد استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_grid ... a.tif; gdal_grid ... b.tif; gdal_grid ... c.tif gdal_merge \-separate a.tif b.tif c.tif \-o d.tif .EE .UNINDENT .UNINDENT .SH "کد وضعیت خروجی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، به عنوان اجرای موفق تلقی می‌گردند). .SH "رابط سی (C API)" .sp این ابزار همچنین از طریق C با تابع \fI\%GDALGrid()\fP قابل فراخوانی است. .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱: ایجاد یک رستر از منبع داده VRT با استفاده از توان عکس فاصله" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_grid \-a invdist:power=2.0:smoothing=1.0 \-txe 85000 89000 \-tye 894000 890000 \e \-outsize 400 400 \-of GTiff \-ot Float64 \-l dem dem.vrt dem.tiff .EE .UNINDENT .UNINDENT .sp این مثال یک فایل TIFF رستری را از منبع داده VRT توصیف‌شده در بخش \fI\%خواندن مقادیر جداشده با کاما\fP با استفاده از روش توان عکس فاصله ایجاد می‌کند. مقادیر برای درون‌یابی از مقدار Z رکورد هندسه خوانده خواهد شد. .SS "مثال ۲: خواندن مقادیر درون‌یابی از یک فیلد توصیفی" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal_grid \-zfield \(dqElevation\(dq \-a invdist:power=2.0:smoothing=1.0 \-txe 85000 89000 \e \-tye 894000 890000 \-outsize 400 400 \-of GTiff \-ot Float64 \-l dem dem.vrt \e dem.tiff \-\-config GDAL_NUM_THREADS ALL_CPUS .EE .UNINDENT .UNINDENT .sp این دستور همان کار دستور قبلی را انجام می‌دهد، اما مقادیر درون‌یابی را به جای رکورد هندسه از فیلد توصیفی مشخص‌شده با گزینه \fB\-zfield\fP می‌خواند. بنابراین در این حالت مختصات X و Y از هندسه گرفته شده و Z از فیلد \fI\(dqElevation\(dq\fP گرفته می‌شود. متغیر \fI\%GDAL_NUM_THREADS\fP نیز برای موازی‌سازی محاسبات تنظیم شده است. .SH "نویسندگان (AUTHORS)" Andrey Kiselev .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .