| GDAL-RASTER-TILE(1) | GDAL | GDAL-RASTER-TILE(1) |
نام (NAME)
gdal-raster-tile - ایجاد تایلها در فایلهای جداگانه از یک مجموعهداده رستر
اضافه شده در نسخه 3.11.
خلاصه دستور (SYNOPSIS)
Usage: gdal raster tile [OPTIONS] <INPUT> <OUTPUT>
Generate tiles in separate files from a raster dataset.
Positional arguments:
-i, --dataset, --input <INPUT> Input raster datasets [required] [not available in pipelines]
-o, --output <OUTPUT> Output directory [required]
Common Options:
-h, --help Display help message and exit
--json-usage Display usage as JSON document and exit
--config <KEY>=<VALUE> Configuration option [may be repeated]
-q, --quiet Quiet mode (no progress bar or warning message) [not available in pipelines]
Options:
-f, --of, --format, --output-format <OUTPUT-FORMAT> Output format (default: PNG)
--co, --creation-option <KEY>=<VALUE> Creation option [may be repeated]
--tiling-scheme <TILING-SCHEME> Tiling scheme. TILING-SCHEME=raster|WebMercatorQuad|WorldCRS84Quad|WorldMercatorWGS84Quad|GoogleCRS84Quad|PseudoTMS_GlobalMercator|GlobalGeodeticOriginLat270|LINZAntarticaMapTilegrid|APSTILE|CBMTILE|NZTM2000 (default: WebMercatorQuad)
--min-zoom <MIN-ZOOM> Minimum zoom level
--max-zoom <MAX-ZOOM> Maximum zoom level
--min-x <MIN-X> Minimum tile X coordinate
--max-x <MAX-X> Maximum tile X coordinate
--min-y <MIN-Y> Minimum tile Y coordinate
--max-y <MAX-Y> Maximum tile Y coordinate
--no-intersection-ok Whether dataset extent not intersecting tile matrix is only a warning
-r, --resampling <RESAMPLING> Resampling method for max zoom. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum (default: cubic)
--overview-resampling <OVERVIEW-RESAMPLING> Resampling method for overviews. OVERVIEW-RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum
--convention <CONVENTION> Tile numbering convention: xyz (from top) or tms (from bottom). CONVENTION=xyz|tms (default: xyz)
--tile-size <TILE-SIZE> Override default tile size
--add-alpha Whether to force adding an alpha channel
Mutually exclusive with --no-alpha
--no-alpha Whether to disable adding an alpha channel
Mutually exclusive with --add-alpha
--output-nodata <OUTPUT-NODATA> Output nodata value
--skip-blank Do not generate blank tiles
--metadata <KEY>=<VALUE> Add metadata item to output tiles [may be repeated]
--copy-src-metadata Whether to copy metadata from source dataset
--aux-xml Generate .aux.xml sidecar files when needed
--kml Generate KML files
--resume Generate only missing files
-j, --num-threads <NUM-THREADS> Number of jobs (or ALL_CPUS) (default: ALL_CPUS)
--parallel-method <PARALLEL-METHOD> Parallelization method (thread, spawn, fork). PARALLEL-METHOD=thread|spawn|fork
Advanced Options:
--if, --input-format <INPUT-FORMAT> Input formats [may be repeated] [not available in pipelines]
--oo, --open-option <KEY>=<VALUE> Open options [may be repeated] [not available in pipelines]
Advanced Resampling Options:
--excluded-values <EXCLUDED-VALUES> Tuples of values (e.g. <R>,<G>,<B> or (<R1>,<G1>,<B1>),(<R2>,<G2>,<B2>)) that must beignored as contributing source pixels during (average) resampling
--excluded-values-pct-threshold <EXCLUDED-VALUES-PCT-THRESHOLD> Minimum percentage of source pixels that must be set at one of the --excluded-values to cause the excluded value to be used as the target pixel value (default: 50)
--nodata-values-pct-threshold <NODATA-VALUES-PCT-THRESHOLD> Minimum percentage of source pixels that must be set at one of nodata (or alpha=0 or any other way to express transparent pixelto cause the target pixel value to be transparent (default: 100)
Publication Options:
--webviewer <WEBVIEWER> Web viewer to generate. WEBVIEWER=none|all|leaflet|openlayers|mapml|stac (default: all) [may be repeated]
--url <URL> URL address where the generated tiles are going to be published
--title <TITLE> Title of the map
--copyright <COPYRIGHT> Copyright for the map
--mapml-template <MAPML-TEMPLATE> Filename of a template mapml file where variables will be substituted
توضیحات (DESCRIPTION)
دستور gdal raster tile پوشهای حاوی تایلهای کوچک و متادیتا را بر اساس مشخصات OGC WMTS تولید میکند. صفحات وب ساده با نمایشگرهای مبتنی بر OpenLayers و Leaflet نیز تولید میشوند - بنابراین هر کسی میتواند به راحتی نقشههای شما را به صورت برخط کاوش کند و نیازی به نصب یا پیکربندی نرمافزارهای خاص (مانند MapServer) ندارید و نقشه با سرعت بسیار بالا در مرورگر وب نمایش داده میشود. فقط کافی است پوشه تولید شده را روی یک سرور وب بارگذاری کنید.
این ابزار به صورت پیشفرض فایلهای PNG تولید میکند، اما فرمتهای خروجی دیگر نیز قابل انتخاب هستند (مانند JPEG، WEBP، GTiff و غیره). توجه داشته باشید که همه فرمتها از انواع دادهای غیر از Byte پشتیبانی نمیکنند. فرمتهای JPEG و WEBP فقط از Byte پشتیبانی میکنند. فرمت PNG از Byte و UInt16 پشتیبانی میکند. فرمت GeoTiff میتواند از همه انواع دادهها پشتیبانی کند.
همچنین در صورت استفاده از طرح تایلبندی raster، میتوان از طرحی کاملاً منطبق با رستر ورودی از نظر مبدا مختصات و تفکیکپذیری استفاده کرد. در این طرح، تایلهای موجود در بالاترین سطح بزرگنمایی دارای همان تفکیکپذیری رستر ورودی خواهند بود.
از نسخه 3.12 نرمافزار GDAL، میتوان از gdal raster tile به عنوان آخرین مرحله از یک پایپلاین (pipeline) استفاده کرد.
گزینههای ویژه برنامه (PROGRAM-SPECIFIC OPTIONS)
- --aux-xml
- تولید فایلهای جانبی .aux.xml در صورت نیاز.
- --add-alpha
- اجبار به افزودن کانال آلفا (شفافیت). به صورت پیشفرض یک کانال آلفا اضافه میشود، مگر اینکه مجموعهداده منبع دارای مقدار nodata باشد و فرمت خروجی از آن پشتیبانی کند.
- --copy-src-metadata
- کپی کردن متادیتا از مجموعهداده منبع به تایلهای خروجی.
- --convention xyz|tms
- قرارداد شمارهگذاری تایلها:
- xyz (پیشفرض): از بالا، مطابق با مشخصات OGC Web Map Tiling Specification (WMTS).
- tms: از پایین، مطابق با مشخصات OSGeo Tile Map Service (TMS) Specification.
- --output-nodata <NODATA>
- مقدار nodata در خروجی.
- -i, --input <INPUT>
- مجموعهداده رستر ورودی [الزامی].
- --kml
- تولید متادیتای SuperOverlay برای نرمافزار Google Earth. با طرحهای تایلبندی که سطوح بزرگنمایی آنها توانی از ۲ نیست، سازگار نیست.
- --max-x <MAX-X>
- حداکثر مختصات X تایل در بالاترین سطح بزرگنمایی. میتواند برای محدود کردن فرآیند تایلبندی تنظیم شود.
- --max-y <MAX-Y>
- حداکثر مختصات Y تایل در بالاترین سطح بزرگنمایی. میتواند برای محدود کردن فرآیند تایلبندی تنظیم شود.
- --max-zoom <MAX-ZOOM>
- حداکثر سطح بزرگنمایی برای تولید. در صورت عدم تعیین، با مقایسه تفکیکپذیری مجموعهداده ورودی با نزدیکترین تفکیکپذیری در لیست ماتریسهای تایل مجموعه ماتریس تایل تعیین میشود.
- --metadata <KEY>=<VALUE>
- افزودن آیتم متادیتا به تایلهای خروجی [قابل تکرار].
- --min-x <MIN-X>
- حداقل مختصات X تایل در بالاترین سطح بزرگنمایی. میتواند برای محدود کردن فرآیند تایلبندی تنظیم شود.
- --min-y <MIN-Y>
- حداقل مختصات Y تایل در بالاترین سطح بزرگنمایی. میتواند برای محدود کردن فرآیند تایلبندی تنظیم شود.
- --min-zoom <MIN-ZOOM>
- حداقل سطح بزرگنمایی برای تولید. در صورت عدم تعیین، برابر با --max-zoom خواهد بود.
- --no-alpha
- غیرفعال کردن ایجاد کانال آلفا (شفافیت).
- --no-intersection-ok
- آیا عدم تقاطع محدوده مجموعهداده با ماتریس تایل فقط به عنوان یک هشدار در نظر گرفته شود. در غیر این صورت، به صورت پیشفرض، در صورت وقوع چنین شرایطی خطا صادر میشود.
- -j, --num-threads <value>
- تعداد وظایف همزمان برای اجرا. پیشفرض: تعداد پردازندههای شناساییشده (CPUs).
- -o, --output <OUTPUT>
- پوشه خروجی
[الزامی].
اگر پوشه وجود نداشته باشد ایجاد خواهد شد، اما پوشه والد آن باید از قبل موجود باشد.
- --overview-resampling nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum
- روش بازنمونهبرداری (resampling) مورد استفاده برای تولید سطوح بزرگنمایی پایینتر از حداکثر سطح بزرگنمایی. در صورت عدم تعیین، مقدار پیشفرض آن برابر با گزینه --resampling خواهد بود.
- --parallel-method thread|spawn|fork
- اضافه شده
در نسخه GDAL 3.12.
روش موازیسازی:
- thread: از چندریسمانی استفاده میکند، یعنی وظایف موازی درون همان فرآیند اجرا میشوند.
- spawn: زیرفرآیندهای فرزند gdal را راهاندازی میکند. روش spawn میتواند مقیاسپذیری بهتری ایجاد کند، اما نیازمند در دسترس بودن باینری gdal است. نرمافزار GDAL تلاش میکند آن را پیدا کند، اما میتوانید گزینه پیکربندی GDAL_PATH را نیز برای اشاره به پوشهای که باینری gdal در آن قرار دارد تنظیم کنید.
- fork: گونهای از spawn است که از فراخوانی سیستمی fork بدون اجرای مجدد باینری gdal استفاده میکند. این روش روی ویندوز در دسترس نیست. در سیستمهای یونیکس که در دسترس است، استفاده از این روش در فرآیندهای چندریسمانی، بهویژه در مواردی که ریسمانهای دیگر در حال انجام عملیات GDAL هستند، توصیه نمیشود زیرا میتواند باعث بنبست (deadlock) شود.
اگر گزینه --parallel-method تعیین نشود، GDAL به صورت خودکار مناسبترین روش را انتخاب میکند؛ در صورتی که باینری gdal پیدا شود و تعداد تایلهای کافی در هر وظیفه تولید گردد از spawn استفاده میکند، در غیر این صورت در لینوکس، MacOSX یا FreeBSD به fork (اگر ریسمان دیگری در حال اجرا نباشد) و در غیر این صورت به thread بازمیگردد.
- -r, --resampling nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum
- روش بازنمونهبرداری مورد استفاده برای تولید حداکثر سطح بزرگنمایی، و همچنین سطوح بزرگنمایی پایینتر در صورتی که --overview-resampling تعیین نشده باشد. پیشفرض cubic است.
- --resume
- تولید فقط فایلهای ناقص یا ناموجود. میتواند هنگام از سرگیری یک اجرای متوقفشده قبلی استفاده شود.
- --skip-blank
- عدم تولید تایلهای کاملاً خالی یا شفاف.
- --tile-size <PIXELS>
- عرض و ارتفاع یک تایل بر حسب پیکسل. مقدار پیشفرض برای طرحهای تایلبندی استاندارد ۲۵۶ است. تنظیم آن روی مقداری بالاتر، امکان تولید مجموعههای تایل با DPI بالاتر را فراهم میکند.
- --tiling-scheme <TILING-SCHEME>
- طرح برش
تایل.
پیشفرض WebMercatorQuad
است (که با
نام سازگار
با Google Maps نیز
شناخته
میشود).
پروفایلهای پایه زیر در دسترس هستند:
- raster: سیستم مرجع مختصات (CRS) برابر با CRS رستر ورودی، اندازه تایل = ۲۵۶ پیکسل، پوشش رستر در تمام سطوح بزرگنمایی.
- WebMercatorQuad: سیستم مرجع EPSG:3857 ("WGS 84 / Pseudo-Mercator")، اندازه تایل: ۲۵۶ پیکسل، پوشش کل جهان در سطح بزرگنمایی ۰، یک تایل منفرد در سطح بزرگنمایی ۰.
- WorldCRS84Quad: سیستم مرجع EPSG:4326 ("WGS 84")، اندازه تایل: ۲۵۶ پیکسل، پوشش کل جهان در سطح بزرگنمایی ۰، دو تایل در کنار هم در سطح بزرگنمایی ۰.
- WorldMercatorWGS84Quad: سیستم مرجع EPSG:3395 ("WGS 84 / World Mercator")، اندازه تایل: ۲۵۶ پیکسل، پوشش کل جهان در سطح بزرگنمایی ۰، یک تایل منفرد در سطح بزرگنمایی ۰. این طرح میتواند به عنوان گونهای از WebMercatorQuad در نظر گرفته شود با این تفاوت که روی بیضوی WGS84 کاملاً همسان (conformal) است.
- GoogleCRS84Quad: سیستم مرجع EPSG:4326 ("WGS 84")، اندازه تایل: ۲۵۶ پیکسل، پوشش کل جهان در سطح بزرگنمایی ۰، یک تایل منفرد در سطح بزرگنمایی ۰ که ۶۴ خط اول و آخر آن خالی است (مبدا بالای تایل یک عرض جغرافیایی مجازی ۱۸۰ درجه و پایین آن ۱۸۰- درجه است).
- PseudoTMS_GlobalMercator: سیستم مرجع EPSG:3857 ("WGS 84 / Pseudo-Mercator")، اندازه تایل: ۲۵۶ پیکسل، پوشش کل جهان در سطح بزرگنمایی ۰، تایلهای ۲x۲ در سطح بزرگنمایی ۰. این معادل WebMercatorQuad است اما با شیفت سطح بزرگنمایی به اندازه ۱ واحد.
- LINZAntarticaMapTileGrid: شبکه تایل نقشه قطب جنوب LINZ (منطقه دریای راس). فایل tms_LINZAntarticaMapTileGrid.json را ببینید.
- APSTILE: سیستم مرجع مختصات تایلشده مبتنی بر قطبی استریوگرافیک آلاسکا برای منطقه قطب شمال. فایل tms_MapML_APSTILE.json را ببینید.
- CBMTILE: سیستم مرجع مختصات تایلشده مبتنی بر مخروطی همشکل لامبرت برای کانادا. فایل tms_MapML_CBMTILE.json را ببینید.
- NZTM2000: شبکه تایل نقشه LINZ NZTM2000. فایل tms_NZTM2000.json را ببینید.
طرحهای تایلبندی اضافی از طریق فایلهای tms_XXXX.json موجود در دایرکتوری دادههای GDAL شناسایی میشوند.
گزینههای پیشرفته بازنمونهبرداری (Advanced Resampling Options)
- --excluded-values=<EXCLUDED-VALUES>
- چندتایی مقادیر جدا شده با کاما (معمولاً مانند "R,G,B") که به عنوان پیکسلهای منبع در طول بازنمونهبرداری نادیده گرفته میشوند. تعداد مقادیر در چندتایی باید برابر با تعداد باندها به استثنای باند آلفا باشد. چندین چندتایی از مقادیر مستثنیشده را میتوان با ساختار "(R1,G1,B1),(R2,G2,B2)" مشخص کرد. این گزینه فقط در بازنمونهبرداری میانگین (average) اعمال میشود. این مفهوم تا حدی شبیه nodata/alpha است، اما تفاوت اصلی این است که پیکسلهای منطبق بر یکی از مقادیر مستثنیشده همچنان هنگام تعیین معتبر بودن یا چگالی پیکسل هدف، معتبر در نظر گرفته میشوند.
اضافه شده در نسخه 3.11.1.
- --excluded-values-pct-threshold=<EXCLUDED-VALUES-PCT-THRESHOLD>
- حداقل درصد پیکسلهای منبع که باید روی یکی از مقادیر --excluded-values تنظیم شده باشند تا مقدار مستثنیشده که اکثریت پیکسلهای منبع را تشکیل میدهد، به عنوان مقدار پیکسل هدف استفاده شود. مقدار پیشفرض ۵۰(%) است.
اضافه شده در نسخه 3.11.1.
- --nodata-values-pct-threshold=<NODATA-VALUES-PCT-THRESHOLD>
- حداقل درصد پیکسلهای منبع که باید روی nodata (یا alpha=0 یا هر روش دیگری برای بیان پیکسل شفاف) باشند تا مقدار پیکسل هدف شفاف شود. مقدار پیشفرض ۱۰۰(%) است، به این معنی که یک پیکسل هدف تنها در صورتی شفاف خواهد بود که تمام پیکسلهای منبع مشارکتکننده شفاف باشند. این گزینه فقط در بازنمونهبرداری میانگین (average) در نظر گرفته میشود.
اضافه شده در نسخه 3.11.1.
گزینههای انتشار (Publication Options)
- --webviewer none|all|leaflet|openlayers|mapml|stac
- نمایشگر وب
برای تولید.
پیشفرض all
است. این
نمایشگرهای
وب در ریشه
پوشه خروجی
ایجاد
میشوند.
گزینه stac یک فایل stacta.json بر اساس مشخصات Spatio-Temporal Asset Catalog Tiled Assets تولید میکند که میتواند توسط درایور STACTA باز شود.
- --url
- آدرس URL که تایلهای تولید شده قرار است در آن منتشر شوند.
- --title <TITLE>
- عنوان نقشه.
- --copyright <COPYRIGHT>
- حق نشر و کپیرایت نقشه.
گزینههای MapML (MapML options)
نمایشگر وب MapML تنها در صورتی میتواند تولید شود که گزینه --convention روی مقدار پیشفرض xyz تنظیم شده باشد.
پروفایلهای زیر پشتیبانی میشوند:
- WebMercatorQuad: نگاشتشده به طرح تایلبندی OSMTILE در MapML.
- GoogleCRS84Quad: نگاشتشده به طرح تایلبندی WGS84 در MapML.
- APSTILE: برگرفته از فایل داده tms_MapML_APSTILE.json.
- CBMTILE: برگرفته از فایل داده tms_MapML_CBMTILE.json.
فایل MapML تولید شده در پوشه خروجی mapml.mapl نام دارد.
گزینههای موجود عبارتند از:
- --mapml-template <filename>
- نام فایل یک قالب mapml که متغیرها در آن جایگزین خواهند شد. در صورت عدم تعیین، فایل عمومی template_tiles.mapml از منابع داده GDAL استفاده خواهد شد.
گزینه --url همچنین برای جایگزینی ${URL} در فایل قالب MapML استفاده میشود.
گزینههای استاندارد (STANDARD OPTIONS)
- --co, --creation-option <NAME>=<VALUE>
- بسیاری از
فرمتها یک
یا چند
گزینه ساخت
اختیاری
دارند که
میتوانند
برای کنترل
جزئیات
فایل ایجاد
شده
استفاده
شوند. به
عنوان
مثال،
درایور GeoTIFF از
گزینههای
ساخت برای
کنترل
فشردهسازی
و
تایلبندی
بودن فایل
پشتیبانی
میکند.
قابل تکرار است.
گزینههای ساخت موجود بسته به درایور فرمت متفاوت هستند و برخی فرمتهای ساده اصلاً هیچ گزینه ساختی ندارند. لیست گزینههای پشتیبانیشده برای یک فرمت را میتوان با گزینه خط فرمان --formats مشاهده کرد، اما مستندات خود فرمت منبع اصلی اطلاعات درباره گزینههای ساخت درایور است. برای مشاهده گزینههای ساخت مجاز هر فرمت به مستندات اختصاصی درایورهای رستر مراجعه کنید.
- --if, --input-format <format>
- نام
فرمت/درایور
برای تلاش
جهت باز
کردن
فایل(های)
ورودی.
معمولاً
تعیین آن
ضروری
نیست، اما
میتوان از
آن برای
چشمپوشی
از تشخیص
خودکار
درایور در
مواقعی که
در انتخاب
درایور
مناسب
ناموفق
است،
استفاده
کرد. این
گزینه
میتواند
چندین بار
برای تعیین
چندین
درایور
کاندید
تکرار شود.
توجه داشته
باشید که
این گزینه
درایورها
را مجبور به
باز کردن
مجموعهداده
نمیکند. به
ویژه، برخی
درایورها
نیازمندیهایی
برای پسوند
فایل دارند.
قابل تکرار است.
- --oo, --open-option <NAME>=<VALUE>
- گزینه باز
کردن
مجموعهداده
(مختص هر
فرمت).
قابل تکرار است.
- -f, --of, --format, --output-format <OUTPUT-FORMAT>
- فرمت رستر
خروجی مورد
استفاده.
مقادیر
مجاز با
اجرای
دستور زیر
قابل
مشاهده است:
gdal --formats | grep raster | grep rw | sort
پیشفرض PNG است.
کدهای وضعیت خروجی (RETURN STATUS CODE)
برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا کد غیر صفر برمیگرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر میشوند به عنوان اجرای موفق در نظر گرفته میشوند).
مثالها (EXAMPLES)
مثال ۱: تولید تایلهای PNG با طرح تایلبندی WebMercatorQuad برای سطوح بزرگنمایی ۲ تا ۵
gdal raster tile --min-zoom=2 --max-zoom=5 input.tif output_folder
مثال ۲: تایلبندی مجدد یک رستر با استفاده از مبدا و تفکیکپذیری آن
gdal raster tile --tiling-scheme raster input.tif output_folder
مثال ۳: ایجاد یک مجموعهداده تایلشده سازگار با مشخصات Spatio-Temporal Asset Catalog Tiled Assets با استفاده از متاتایلهای Cloud-Optimized GeoTIFF به ابعاد ۴۰۹۶x۴۰۹۶
gdal raster tile --format COG --tile-size 4096 input.tif output_folder
مثال ۴: موزاییک کردن بلادرنگ چند فایل ورودی و تایلبندی آن موزاییک
gdal raster pipeline ! mosaic input*.tif ! tile output_folder
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |