| GDALTINDEX(1) | GDAL | GDALTINDEX(1) |
نام (NAME)
gdaltindex - ساخت یک shapefile به عنوان نمایه کاشی رستر.
خلاصه دستور (SYNOPSIS)
Usage: gdaltindex [--help] [--long-usage] [--help-general]
[-overwrite] [-recursive] [-filename_filter <val>]...
[-min_pixel_size <val>] [-max_pixel_size <val>]
[-of <output_format>] [-tileindex <field_name>]
[-write_absolute_path] [-skip_different_projection]
[-t_srs <srs_def>] [-src_srs_name <field_name>]
[-src_srs_format {AUTO|WKT|EPSG|PROJ}] [-lyr_name <name>]
[-lco <NAME>=<VALUE>]... [-gti_filename <filename>]
[-tr <xres> <yres>] [-te <xmin> <ymin> <xmax> <ymax>]
[-ot <datatype>] [-bandcount <val>] [-nodata <val>]...
[-colorinterp <val>]... [-mask] [-mo <name>=<value>]...
[-fetch_md <gdal_md_name> <fld_name> <fld_type>]... [--quiet]
<index_file> <file_or_dir>...
توضیحات (DESCRIPTION)
این برنامه یک مجموعه داده پشتیبانی‌شده توسط OGR را ایجاد می‌کند که برای هر فایل رستر ورودی یک رکورد، یک مشخصه حاوی نام فایل، و یک هندسه چندضلعی که محدوده رستر را مشخص می‌کند دارد. این خروجی برای استفاده در MapServer به عنوان یک نمایه کاشی رستر، یا به عنوان ورودی برای درایور GTI مناسب است.
نکته:
ببینید: gdal raster index.
- --help
- نمایش این پیام راهنما و خروج
- --help-general
- نمایش یک پیام کاربردی کوتاه برای گزینه‌های خط فرمان عمومی GDAL و خروج.
- -q, --quiet
- نادیده گرفتن پیام‌های پیشرفت و سایر خروجی‌های غیرخطا.
- -overwrite
- در نگارش 3.9
اضافه شد.
رونویسی نمایه کاشی در صورت وجود داشتن از قبل.
- -recursive
- در نگارش 3.9
اضافه شد.
اینکه آیا دایرکتوری‌های مشخص‌شده در <file_or_dir> باید به‌صورت بازگشتی پیمایش شوند یا خیر.
- -filename_filter <val>
- در نگارش 3.9
اضافه شد.
الگویی که نام‌های فایل‌های موجود در دایرکتوری‌های مشخص‌شده توسط <file_or_dir> باید از آن پیروی کنند. '*' یک نویسه عام (wildcard) است که با هر تعداد از هر نویسه‌ای از جمله هیچ تطابق دارد. '?' یک نویسه عام است که با یک نویسه منفرد مطابقت می‌کند. مقایسه‌ها بدون حساسیت به بزرگی و کوچکی حروف انجام می‌شوند. می‌توان چندین فیلتر مشخص کرد.
برای مثال: -filename_filter "*.tif" -filename_filter "*.tiff"
- -min_pixel_size <val>
- در نگارش 3.9
اضافه شد.
حداقل اندازه پیکسل از نظر وسعت مکانی به ازای هر پیکسل (تفکیک‌پذیری) که یک رستر باید داشته باشد تا انتخاب شود. اندازه پیکسل پس از بازتصویر وسعت آن به SRS هدف تعریف‌شده توسط -t_srs ارزیابی می‌شود.
- -max_pixel_size <val>
- در نگارش 3.9
اضافه شد.
حداکثر اندازه پیکسل از نظر وسعت مکانی به ازای هر پیکسل (تفکیک‌پذیری) که یک رستر باید داشته باشد تا انتخاب شود. اندازه پیکسل پس از بازتصویر وسعت آن به SRS هدف تعریف‌شده توسط -t_srs ارزیابی می‌شود.
- -of <output_format>
- قالب OGR فایل نمایه کاشی خروجی. در صورت مشخص نشدن، قالب از پسوند پرونده حدس زده می‌شود.
- -tileindex <field_name>
- نام فیلد خروجی برای نگهداری مسیر/مکان فایل رسترهای نمایه‌شده. نام فیلد پیش‌فرض نمایه کاشی location است.
- -write_absolute_path
- مسیر مطلق فایل‌های رستر در فایل نمایه کاشی ذخیره می‌شود. به‌طور پیش‌فرض، نام فایل‌های رستر دقیقاً همان‌گونه که در خط فرمان مشخص شده‌اند در فایل قرار می‌گیرند.
- -skip_different_projection
- تنها فایل‌هایی که تصویر سیستم مختصات یکسانی با فایل‌های درج‌شده قبلی در tileindex دارند درج خواهند شد (مگر اینکه -t_srs مشخص شده باشد). حالت پیش‌فرض تصویر را بررسی نمی‌کند و تمام ورودی‌ها را می‌پذیرد.
- -t_srs <target_srs>
- هندسه‌های فایل‌های ورودی به سامانه مرجع مختصات هدف تبدیل خواهند شد. حالت پیش‌فرض، چندضلعی‌های مستطیلی ساده‌ای در همان سامانه مرجع مختصات رسترهای ورودی ایجاد می‌کند.
- -src_srs_name <field_name>
- نام فیلد برای ذخیره SRS هر کاشی. این نام فیلد می‌تواند به عنوان مقدار کلیدواژه TILESRS در MapServer استفاده شود.
- -src_srs_format {AUTO|WKT|EPSG|PROJ}
- قالبی که SRS هر کاشی باید با آن نوشته شود. انواع می‌توانند AUTO، WKT، EPSG، PROJ باشند. این گزینه باید به همراه -src_srs_format استفاده شود.
- -lyr_name <name>
- نام لایه برای ایجاد یا الحاق به آن در فایل نمایه کاشی خروجی.
- -lco <NAME>=<VALUE>
- در نگارش 3.9
اضافه شد.
گزینه ایجاد لایه (مخصوص قالب)
- <index_file>
- نام فایل خروجی برای ایجاد یا الحاق به آن. در صورت عدم وجود، مجموعه داده پیش‌فرض ایجاد خواهد شد، در غیر این صورت به مجموعه داده موجود الحاق می‌شود.
از GDAL 3.9 به بعد، این مقدار می‌تواند نام یک دایرکتوری نیز باشد. -recursive را نیز می‌توان برای پیمایش بازگشتی زیردایرکتوری‌ها به کار برد.
همچنین امکان استفاده از گزینهٔ عمومی --optfile filelist.txt برای تعیین فهرستی از فایل‌های مبدأ وجود دارد.
گزینه‌های ویژه برای استفاده توسط درایور GDAL GTI (OPTIONS SPECIFIC TO USE BY THE GDAL GTI DRIVER)
دستور gdaltindex می‌تواند برای تولید یک نمایه تایل (tile index) مناسب برای استفاده توسط درایور GTI استفاده شود. دو امکان وجود دارد:
- یا استفادهٔ مستقیم از نمایه تایل برداری تولید شده توسط gdaltindex به عنوان ورودی درایور GTI
- یا تولید یک فایل پوششی کوچک XML .gti، برای استفادهٔ آسان‌تر با فرمت‌های غیرفایلی مانند پایگاه‌های داده، یا برای فرمت‌های برداری که از تنظیم موارد فرادادهٔ لایه پشتیبانی نمی‌کنند.
فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند برای نمونه عبارتند از GeoPackage (-of GPKG)، FlatGeoBuf (-of FlatGeoBuf) یا PostGIS (-of PG)
تنظیم -tr و -ot توصیه می‌شود تا درایور GTI مجبور نباشد با باز کردن نخستین تایل موجود در نمایه، آن‌ها را استنتاج کند. اگر تایل‌ها دارای باند nodata یا mask باشند، -nodata و -mask نیز باید تنظیم شوند.
در چارچوب GTI، محدودهٔ (extent) تمامی تایل‌های ارجاع‌داده‌شده در نمایه تایل باید در یک SRS واحد بیان شود. در نتیجه، اگر تایل‌های ورودی ممکن است دارای SRS متفاوتی باشند، باید -t_srs یا -skip_different_projection مشخص شود.
- -gti_filename <name>
- در نسخهٔ 3.9
اضافه شد.
نام فایل نمایه تایل مجازی XML برای تولید، که می‌تواند به عنوان ورودی برای درایور GDAL GTI / Virtual Raster Tile Index استفاده شود. این گزینه زمانی می‌تواند مفید باشد که نمایه تایل را در یک فرمت برداری می‌نویسید که از نوشتن موارد فرادادهٔ لایه پشتیبانی نمی‌کند.
- -tr <xres> <yres>
- در نسخهٔ 3.9
اضافه شد.
وضوح (resolution) هدف در واحد SRS بر پیکسل.
در صورت تعیین -gti_filename در فایل XML Virtual Tile Index، یا به عنوان موارد فرادادهٔ لایهٔ RESX و RESY برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود.
- -te <xmin> <ymin> <xmax> <ymax>
- در نسخهٔ 3.9
اضافه شد.
محدودهٔ (extent) هدف در واحد SRS.
در صورت تعیین -gti_filename در فایل XML Virtual Tile Index، یا به عنوان موارد فرادادهٔ لایهٔ MINX، MINY، MAXX و MAXY برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود.
- -ot <datatype>
- در نسخهٔ 3.9
اضافه شد.
نوع دادهٔ تایل‌های نمایه تایل: Byte، Int8، UInt16، Int16، UInt32، Int32، UInt64، Int64، Float32، Float64، CInt16، CInt32، CFloat32 یا CFloat64
در صورت تعیین -gti_filename در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ DATA_TYPE برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود.
- -bandcount <val>
- در نسخهٔ 3.9
اضافه شد.
تعداد باندهای تایل‌های نمایه تایل.
در صورت تعیین -gti_filename در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ BAND_COUNT برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود.
ترکیبی از تایل‌های با N و 1+N باند مجاز است، به شرطی که تفسیر رنگ باند (1+N)ام از نوع alpha باشد. در این شرایط مقدار 1+N باید به عنوان تعداد باند نوشته شود.
اگر -nodata یا -colorinterp مشخص شده باشند و چندین مقدار داشته باشند، تعداد باندها نیز از آن تعداد استنتاج می‌شود.
- -nodata <val>[,<val>...]
- در نسخهٔ 3.9
اضافه شد.
مقدار nodata تایل‌های نمایه تایل.
در صورت تعیین -gti_filename در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ NODATA برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود.
- -colorinterp <val>[,<val>...]
- در نسخهٔ 3.9
اضافه شد.
تفسیر رنگ تایل‌های نمایه تایل: red، green، blue، alpha، gray، undefined.
در صورت تعیین -gti_filename در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ COLOR_INTERPRETATION برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود.
- -mask
- در نسخهٔ 3.9
اضافه شد.
آیا تایل‌های موجود در نمایه تایل دارای باند ماسک هستند یا خیر.
در صورت تعیین -gti_filename در فایل XML Virtual Tile Index، یا به عنوان مورد فرادادهٔ لایهٔ MASK_BAND برای فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند نوشته می‌شود.
- -mo <KEY>=<VALUE>
- در نسخهٔ 3.9
اضافه شد.
نوشتن یک مورد فرادادهٔ دلخواه برای لایه، در فرمت‌هایی که از فرادادهٔ لایه پشتیبانی می‌کنند. این گزینه می‌تواند تکرار شود.
نکته:
- -fetch_md <gdal_md_name> <fld_name> <fld_type>
- در نسخهٔ 3.9
اضافه شد.
دریافت یک مورد فراداده از تایل رستر و نوشتن آن به عنوان یک فیلد در نمایه تایل.
<gdal_md_name> باید نام مورد فرادادهٔ رستر باشد. می‌توان از {PIXEL_SIZE} به عنوان یک نام ویژه برای تعیین اندازهٔ پیکسل استفاده کرد.
<fld_name> باید نام فیلدی باشد که در نمایه تایل ایجاد می‌شود.
<fld_type> باید نام نوع فیلد ایجادشونده باشد. یکی از مقادیر String، Integer، Integer64، Real، Date، DateTime
این گزینه می‌تواند تکرار شود.
برای نمونه: -fetch_md TIFFTAG_DATETIME creation_date DateTime
مثال ۱
تولید یک shapefile (doq_index.shp) با یک رکورد به ازای هر تصویری که این ابزار در پوشهٔ doq پیدا می‌کند. هر رکورد حاوی اطلاعاتی است که به مکان تصویر اشاره دارد و همچنین یک شکل مستطیل محاطی که محدودهٔ تصویر را نشان می‌دهد:
gdaltindex doq_index.shp doq/*.tif
مثال ۲
اجرای همان دستور قبلی، اما این بار به جای Shapefile یک GeoPackage ایجاد می‌کنیم.
gdaltindex -of GPKG doq_index.gpkg doq/*.tif
مثال ۳
گزینهٔ -t_srs همچنین می‌تواند برای تبدیل تمام رسترهای ورودی به یک سیستم تصویر خروجی یکسان استفاده شود:
gdaltindex -t_srs EPSG:4326 -src_srs_name src_srs tile_index_mixed_srs.shp *.tif
مثال ۴
ایجاد یک نمایه کاشی (tile index) از فایل‌های فهرست‌شده در یک فایل متنی، با متاداده‌های مناسب جهت استفاده توسط درایور GDAL GTI / Virtual Raster Tile Index.
gdaltindex tile_index.gti.gpkg -ot Byte -tr 60 60 -colorinterp Red,Green,Blue --optfile my_list.txt
وضعیت خروج (EXIT STATUS)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
رابط برنامه‌نویسی C (C API)
این ابزار همچنین از طریق C با GDALTileIndex() قابل فراخوانی است.
همچنین ببینید (SEE ALSO)
برای سایر گزینه‌های خط فرمان، و به‌ویژه سوئیچ --optfile که می‌تواند برای تعیین فهرستی از مجموعه‌داده‌های ورودی استفاده شود، بخش Common options for raster programs را ببینید.
نویسندگان (AUTHORS)
Frank Warmerdam <warmerdam@pobox.com>
کپی‌رایت و تکثیر (COPYRIGHT)
1998-2026
| August 18, 2026 |