نام (NAME)

gdal_retile - تایل‌بندی مجدد مجموعه‌ای از تایل‌ها و/یا ساخت سطوح هرمی تایل‌بندی‌شده

خلاصه دستور (SYNOPSIS)

gdal_retile [--help] [--help-general]
               [-v] [-co <NAME>=<VALUE>]... [-of <out_format>] [-ps <pixelWidth> <pixelHeight>]
               [-overlap <val_in_pixel>]
               [-ot  {Byte/Int8/Int16/UInt16/UInt32/Int32/Float32/Float64/
                       CInt16/CInt32/CFloat32/CFloat64}]'
               [ -tileIndex <tileIndexName> [-tileIndexField <tileIndexFieldName>]]
               [-csv <fileName> [-csvDelim <delimiter>]]
               [-s_srs <srs_def>]  [-pyramidOnly]
               [-r {near|bilinear|cubic|cubicspline|lanczos}]
               -levels <numberoflevels>
               [-useDirForEachRow] [-resume]
               -targetDir <TileDirectory> <input_file> <input_file>...

توضیحات (DESCRIPTION)

این ابزار مجموعه‌ای از تایل(های) ورودی را مجدداً تایل‌بندی می‌کند. تمام تایل(های) ورودی باید در یک سامانه مختصات یکسان زمین‌مرجع شده باشند و تعداد باندهای آن‌ها مطابقت داشته باشد. ماتریس تبدیل مختصات (geotransform matrix) تایل‌های ورودی نباید شامل جملات دوران باشد.

به صورت اختیاری سطوح هرمی (pyramid levels) ایجاد می‌شوند. تمام سطوح هرمی از تایل‌های ورودی ایجاد می‌شوند (نه از سطوح قبلی).

امکان تولید شیپ‌فایل برای خروجی تایل‌بندی‌شده وجود دارد.

اگر تعداد تایل‌های ورودی شما از بافر خط فرمان فراتر می‌رود، از گزینه عمومی --optfile استفاده کنید.

نکته:

ابزار gdal_retile یک ابزار پایتون است و تنها در صورتی در دسترس خواهد بود که بایندرهای پایتون GDAL نصب باشند.

پیشنهاد:

معادل در واسط خط فرمان جدید "gdal":

به gdal raster tile مراجعه کنید (تا حدودی معادل است).

--help: نمایش این پیام راهنما و خروج.

--help-general: نمایش یک پیام مختصر از کاربرد گزینه‌های عمومی خط فرمان GDAL و خروج.

-targetDir <directory>: دایرکتوری که خروجی تایل‌ها در آن ایجاد می‌شود. هرم‌ها در زیردایرکتوری‌هایی با شماره‌گذاری از 1 ذخیره می‌شوند. نام تایل‌های ایجادشده دارای یک الگوی شماره‌گذاری بوده و شامل نام تایل(های) مبدأ است.

-of <format>: انتخاب قالب خروجی. در صورت عدم تعیین، قالب از روی پسوند فایل حدس زده می‌شود. از نام کوتاه قالب استفاده کنید.

-co <NAME>=<VALUE>: بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد دارند که می‌توان از آن‌ها برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده کرد. برای نمونه، درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و تعیین اینکه آیا فایل باید تایل‌بندی شود یا خیر پشتیبانی می‌کند.
گزینه‌های ایجاد موجود بسته به درایور قالب متفاوت است و برخی قالب‌های ساده هیچ گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان --format مشاهده کرد، اما مستندات مربوط به همان قالب مرجع قطعی اطلاعات درباره گزینه‌های ایجاد درایور است. برای گزینه‌های مجاز ایجاد هر قالب، به مستندات اختصاصی قالب در Raster drivers مراجعه کنید.

-ot <type>: اجبار باندهای تصویر خروجی به داشتن یک نوع داده مشخص پشتیبانی‌شده توسط درایور، که می‌تواند یکی از موارد زیر باشد: Byte، Int8، UInt16، Int16، UInt32، Int32، UInt64، Int64، Float32، Float64، CInt16، CInt32، CFloat32 یا CFloat64.

-ps <pixelsize_x> <pixelsize_y>: اندازه پیکسل مورد استفاده برای فایل خروجی. در صورت عدم تعیین، مقدار پیش‌فرض 256 x 256 است.

-overlap <val_in_pixel>: هم‌پوشانی بر حسب پیکسل بین تایل‌های متوالی. در صورت عدم تعیین، مقدار پیش‌فرض 0 است.

-levels <numberOfLevels>: تعداد سطوح هرمی که باید ساخته شود.

-v: تولید خروجی پرجزئیات از عملیات تایل‌بندی به موازات انجام آن‌ها.

-pyramidOnly: عدم انجام تایل‌بندی مجدد، فقط هرم‌ها ساخته شوند.

-r <algorithm>: الگوریتم بازنمونه‌برداری، پیش‌فرض near است.

-s_srs <srs_def>: مرجع مکانی مبدأ مورد استفاده. سامانه‌های مختصاتی که می‌توانند ارسال شوند هر موردی است که توسط فراخوانی OGRSpatialReference.SetFromUserInput() پشتیبانی می‌شود، شامل EPSG، PCS و GCSها (مانند EPSG:4296)، تعاریف PROJ.4 یا نام یک فایل ‎.prj حاوی متن WKT. اگر هیچ srs_def ارائه نشود، srs_def تایل‌های مبدأ استفاده می‌شود (در صورت وجود). srs_def به تایل‌های ایجادشده (در صورت امکان) و به شیپ‌فایل(های) اختیاری منتقل خواهد شد.

-tileIndex <tileIndexName>: نام شیپ‌فایل حاوی نمایه تایل(های) خروجی.

-tileIndexField <tileIndexFieldName>: نام مشخصه حاوی نام تایل.

-csv <csvFileName>: نام فایل CSV حاوی اطلاعات زمین‌مرجع تایل(ها). این فایل شامل ۵ ستون است: tilename,minx,maxx,miny,maxy

-csvDelim <column delimiter>: جداکننده ستون مورد استفاده در فایل CSV؛ مقدار پیش‌فرض نقطه ویرگول ";" است.

-useDirForEachRow: به طور معمول تایل‌های تصویر پایه همان‌گونه که در -targetDir شرح داده شده است ذخیره می‌شوند. برای تصاویر بزرگ، برخی سیستم‌های فایل در صورتی که تعداد فایل‌ها در یک دایرکتوری بسیار زیاد باشد دچار افت کارایی می‌شوند که باعث می‌شود gdal_retile در زمان معقول به پایان نرسد. استفاده از این پارامتر ساختار خروجی متفاوتی ایجاد می‌کند. تایل‌های تصویر پایه در زیردایرکتوری با نام 0 ذخیره می‌شوند و هرم‌ها در زیردایرکتوری‌هایی با شماره‌های 1، 2 و... درون هر یک از این دایرکتوری‌ها، سطح دیگری از زیردایرکتوری‌ها ایجاد می‌شود که از 0 تا n بسته به تعداد سطرهای تایل مورد نیاز برای هر سطح شماره‌گذاری شده‌اند. در نهایت، هر دایرکتوری فقط شامل تایل‌های مربوط به یک سطر برای یک سطح خاص است. برای تصاویر بزرگ ممکن است بهبود کارایی تا ضریب N حاصل شود.

-resume: حالت ادامه‌یافتن (Resume). فقط فایل‌های ناموجود تولید می‌شوند.

کد وضعیت بازگشتی (RETURN STATUS CODE)

برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیرصفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).

نویسنده (AUTHOR)

Christian Mueller <christian.mueller@nvoe.at>

حق نشر (COPYRIGHT)

1998-2026

August 18, 2026