.\" 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-RASTER-INDEX" "1" "Aug 18, 2026" "" "GDAL" .SH "نام (NAME)" gdal-raster-index \- ایجاد یک نمایه برداری از مجموعه‌داده‌های رستر .sp افزوده‌شده در نسخه 3.11. .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster index [OPTIONS] ... ایجاد نمایه برداری از مجموعه‌داده‌های رستر. آرگومان‌های مکانی: \-i, \-\-input مجموعه‌داده‌های رستر ورودی [تکرارپذیر] [الزامی] \-o, \-\-output مجموعه‌داده برداری خروجی [الزامی] گزینه‌های عمومی: \-h, \-\-help نمایش پیام راهنما و خروج \-\-json\-usage نمایش نحوه استفاده در قالب سند JSON و خروج \-\-config = گزینه پیکربندی [تکرارپذیر] \-q, \-\-quiet حالت بی‌صدا (بدون نوار پیشرفت یا پیام هشدار) [در خطوط لوله در دسترس نیست] گزینه‌ها: \-f, \-\-of, \-\-format, \-\-output\-format قالب خروجی \-\-co, \-\-creation\-option = گزینه ایجاد [تکرارپذیر] \-\-lco, \-\-layer\-creation\-option = گزینه ایجاد لایه [تکرارپذیر] \-\-overwrite امکان بازنویسی مجموعه‌داده خروجی موجود ناسازگار با \-\-update \-\-update باز کردن مجموعه‌داده موجود در حالت به‌روزرسانی ناسازگار با \-\-overwrite \-\-overwrite\-layer امکان بازنویسی لایه خروجی موجود \-\-append امکان الحاق به لایه موجود \-\-nln, \-\-output\-layer نام لایه خروجی \-\-recursive کاوش بازگشتی دایرکتوری‌های ورودی \-\-filename\-filter الگویی که نام فایل‌ها در دایرکتوری‌های ورودی باید از آن پیروی کنند (نویسه‌های عام \(aq*\(aq و \(aq?\(aq) [تکرارپذیر] \-\-min\-pixel\-size حداقل اندازه پیکسل بر حسب وسعت مکانی به ازای هر پیکسل (تفکیک‌پذیری) برای انتخاب رستر \-\-max\-pixel\-size حداکثر اندازه پیکسل بر حسب وسعت مکانی به ازای هر پیکسل (تفکیک‌پذیری) برای انتخاب رستر \-\-location\-name نام فیلد حاوی مسیر رستر (پیش‌فرض: location) \-\-absolute\-path ذخیره مسیر مجموعه‌داده‌های ورودی به صورت مسیر مطلق \-\-output\-crs سامانه مرجع مختصات (CRS) خروجی \-\-metadata = افزودن متادیتای مجموعه‌داده [تکرارپذیر] \-\-skip\-errors نادیده گرفتن خطاهای مربوط به مجموعه‌داده‌های ورودی \-\-profile پروفایل مجموعه‌داده خروجی. PROFILE=none|STAC\-GeoParquet (پیش‌فرض: none) \-\-base\-url آدرس پایه (Base URL) برای href در STAC\-GeoParquet \-\-id\-method نحوه استخراج \(aqid\(aq در STAC\-GeoParquet. ID\-METHOD=filename|md5|metadata\-item (پیش‌فرض: filename) \-\-id\-metadata\-item نام آیتم متادیتا مورد استفاده برای تعیین \(aqid\(aq در STAC\-GeoParquet (پیش‌فرض: id) \-\-source\-crs\-field\-name نام فیلد جهت ذخیره CRS هر مجموعه‌داده \-\-source\-crs\-format قالب نگارش CRS هر مجموعه‌داده. SOURCE\-CRS\-FORMAT=auto|WKT|EPSG|PROJ (پیش‌فرض: auto) .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp دستور \fBgdal raster index\fP یک مجموعه‌داده برداری ایجاد می‌کند که شامل یک رکورد برای هر فایل رستر ورودی، یک مشخصه حاوی نام فایل و یک هندسه چندضلعی مشخص‌کننده محدوده رستر است. این خروجی برای استفاده در \X'tty: link http://mapserver.org'\fI\%MapServer\fP\X'tty: link' به عنوان یک نمایه تایل‌های رستر (raster tileindex) مناسب است. .sp برای گسترشی از این دستور که فایل‌هایی جهت استفاده به عنوان ورودی برای درایور \fI\%GTI\fP ایجاد می‌کند، به \fI\%gdal driver gti create\fP مراجعه کنید. .sp گزینه‌های زیر در دسترس هستند: .SH "گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)" .INDENT 0.0 .TP .B \-\-absolute\-path مسیر مطلق فایل‌های رستر در فایل نمایه ذخیره می‌شود. به طور پیش‌فرض، نام فایل‌های رستر دقیقاً همان‌گونه که در خط فرمان مشخص شده‌اند در فایل قرار می‌گیرند. .UNINDENT .INDENT 0.0 .TP .B \-\-base\-url افزوده‌شده در نسخه 3.13. .sp آدرس پایه (Base URL) برای ویژگی \fBhref\fP از ویژگی \fIid\fP در یک نمایه STAC\-GeoParquet. .UNINDENT .INDENT 0.0 .TP .B \-\-filename\-filter الگویی که نام فایل‌های موجود در دایرکتوری‌های ورودی باید از آن پیروی کنند. کاراکتر \(aq*\(aq یک نویسه عمومی (wildcard) است که با هر تعداد نویسه از جمله تهی تطابق می‌یابد. کاراکتر \(aq?\(aq یک نویسه عمومی است که با یک تک‌نویسه مطابقت دارد. مقایسه‌ها بدون توجه به بزرگی و کوچکی حروف (case-insensitive) انجام می‌شوند. می‌توان چندین فیلتر مشخص کرد. .sp برای مثال: \fB\-\-filename\-filter \(dq*.tif,*.tiff\(dq\fP .UNINDENT .INDENT 0.0 .TP .B \-\-id\-metadata\-item افزوده‌شده در نسخه 3.13. .sp نام آیتم متادیتا برای تنظیم ویژگی \fIid\fP در STAC\-GeoParquet. پیش‌فرض \fBid\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-id\-method filename|md5|metadata\-item افزوده‌شده در نسخه 3.13. .sp نحوه اشتقاق ویژگی \fIid\fP در STAC\-GeoParquet: .INDENT 7.0 .IP \(bu 2 \fBfilename\fP (پیش‌فرض): فقط نام فایل (بدون دایرکتوری، ولی با پسوند) استفاده می‌شود. .IP \(bu 2 \fBmd5\fP: مقدار MD5Sum فایل محاسبه شده و نام فایل به آن الحاق می‌شود. .IP \(bu 2 \fBmetadata\-item\fP: مقدار آیتم متادیتای مشخص‌شده با \fI\%\-\-id\-metadata\-item\fP از هر مجموعه‌داده مبدأ استفاده می‌شود. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-location\-name نام فیلد خروجی برای نگهداری مسیر یا موقعیت رسترهای نمایه‌شده. نام فیلد پیش‌فرض \fBlocation\fP است. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-pixel\-size حداکثر اندازه پیکسل بر حسب وسعت مکانی به ازای هر پیکسل (تفکیک‌پذیری) که یک رستر باید داشته باشد تا انتخاب شود. اندازه پیکسل پس از بازتصویر وسعت آن به CRS مقصد که توسط \fI\%\-\-output\-crs\fP تعیین شده است، سنجیده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-metadata = نوشتن یک آیتم متادیتای دلخواه لایه، برای قالب‌هایی که از متادیتای لایه پشتیبانی می‌کنند. این گزینه می‌تواند تکرار شود. .UNINDENT .INDENT 0.0 .TP .B \-\-min\-pixel\-size حداقل اندازه پیکسل بر حسب وسعت مکانی به ازای هر پیکسل (تفکیک‌پذیری) که یک رستر باید داشته باشد تا انتخاب شود. اندازه پیکسل پس از بازتصویر وسعت آن به CRS مقصد که توسط \fI\%\-\-output\-crs\fP تعیین شده است، سنجیده می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-output\-crs هندسه‌های فایل‌های ورودی به سامانه مرجع مختصات مقصد مورد نظر تبدیل خواهند شد. حالت پیش‌فرض، چندضلعی‌های مستطیلی ساده‌ای در همان سامانه مرجع مختصات رسترهای ورودی ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-profile none|STAC\-GeoParquet افزوده‌شده در نسخه 3.13. .sp پروفایل مجموعه‌داده خروجی را تعیین می‌کند. در صورت انتخاب \fBSTAC\-GeoParquet\fP، یک فایل Parquet منطبق بر مشخصات \X'tty: link https://radiantearth.github.io/stac-geoparquet-spec/latest'\fI\%STAC\-GeoParquet\fP\X'tty: link' ایجاد می‌شود (مشروط بر آنکه قالب Parquet نیز انتخاب شده باشد). چنین فایلی توسط درایور \fI\%GTI driver\fP قابل خواندن است. تنظیم \fBSTAC\-GeoParquet\fP همچنین به طور ضمنی سامانه مرجع مختصات مقصد را روی EPSG:4326 تنظیم می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-recursive تعیین می‌کند که آیا دایرکتوری‌های ورودی باید به صورت بازگشتی کاوش شوند یا خیر. .UNINDENT .INDENT 0.0 .TP .B \-\-skip\-errors افزوده‌شده در نسخه 3.12. .sp نادیده گرفتن خطاهای مربوط به مجموعه‌داده‌های ورودی. .UNINDENT .INDENT 0.0 .TP .B \-\-source\-crs\-field\-name نام فیلد برای ذخیره CRS هر تایل. این نام فیلد می‌تواند به عنوان مقدار کلمه کلیدی TILESRS در MapServer استفاده شود. .UNINDENT .INDENT 0.0 .TP .B \-\-source\-crs\-format auto|WKT|EPSG|PROJ قالبی که CRS هر تایل باید بر اساس آن نوشته شود. انواع مجاز عبارتند از: \fBauto\fP، \fBWKT\fP، \fBEPSG\fP و \fBPROJ\fP. این گزینه باید به همراه \fI\%\-\-source\-crs\-field\-name\fP استفاده شود. .UNINDENT .SH "گزینه‌های استاندارد (STANDARD OPTIONS)" .INDENT 0.0 .TP .B \-\-append امکان الحاق عوارض به لایه یا لایه‌های موجود را فراهم می‌کند. در صورتی که مجموعه‌داده خروجی هنوز وجود نداشته باشد، آن را نیز ایجاد می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-co, \-\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد دارند که می‌توانند برای کنترل ویژگی‌های خاص فایل ایجادشده استفاده شوند. به عنوان مثال، درایور GeoTIFF از گزینه‌های ایجاد برای کنترل فشرده‌سازی و تایل‌بندی شدن فایل پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ایجاد در دسترس بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً گزینه ایجادی ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات خود قالب، منبع معتبر اطلاعات درباره گزینه‌های ایجاد درایور است. برای مشاهده گزینه‌های مجاز ایجاد برای هر قالب، به مستندات اختصاصی قالب در بخش \fI\%Raster drivers\fP مراجعه کنید. .UNINDENT .INDENT 0.0 .TP .B \-\-lco, \-\-layer\-creation\-option = بسیاری از قالب‌ها یک یا چند گزینه اختیاری ایجاد لایه دارند که می‌توانند برای کنترل ویژگی‌های خاص لایه ایجادشده به کار روند. برای مثال، درایور GeoPackage از گزینه‌های ایجاد لایه برای کنترل شناسه عارضه یا نام ستون هندسه، تنظیم شناسه یا توضیحات و غیره پشتیبانی می‌کند. .sp می‌تواند تکرار شود. .sp گزینه‌های ایجاد لایه در دسترس بسته به درایور قالب متفاوت است و برخی قالب‌های ساده اصلاً گزینه ایجاد لایه ندارند. فهرستی از گزینه‌های پشتیبانی‌شده برای یک قالب را می‌توان با گزینه خط فرمان \fI\%\-\-formats\fP مشاهده کرد، اما مستندات خود قالب، مرجع اصلی اطلاعات درباره گزینه‌های ایجاد درایور است. برای مشاهده گزینه‌های مجاز ایجاد لایه برای هر قالب، به مستندات اختصاصی در بخش \fI\%Vector drivers\fP مراجعه کنید. .sp توجه داشته باشید که گزینه‌های ایجاد لایه با گزینه‌های ایجاد مجموعه‌داده متفاوت هستند. .UNINDENT .INDENT 0.0 .TP .B \-f, \-\-of, \-\-format, \-\-output\-format تعیین قالب برداری خروجی مورد استفاده. مقادیر مجاز با اجرای دستور زیر قابل مشاهده است: \fBgdal \-\-formats | grep vector | grep rw | sort\fP .UNINDENT .INDENT 0.0 .TP .B \-\-nln, \-\-output\-layer تعیین نامی برای لایه برداری خروجی. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite اجازه دادن به برنامه برای بازنویسی فایل یا مجموعه‌داده هدف موجود. در غیر این صورت، به طور پیش‌فرض، اگر فایل یا مجموعه‌داده هدف از قبل وجود داشته باشد، \fBgdal\fP خطا می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-overwrite\-layer امکان بازنویسی لایه برداری خروجی موجود را فراهم می‌کند. .UNINDENT .INDENT 0.0 .TP .B \-\-update تعیین می‌کند که مجموعه‌داده خروجی باید در حالت به‌روزرسانی باز شود. مستلزم آن است که از قبل وجود داشته باشد. .UNINDENT .SH "کد وضعیت بازگشتی (RETURN STATUS CODE)" .sp این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقدار غیر صفر بازمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار صادر می‌شوند، اجرای موفقیت‌آمیز در نظر گرفته می‌شوند). .SH "مثال‌ها (EXAMPLES)" .SS "مثال ۱" .sp ایجاد یک GeoPackage حاوی یک رکورد برای هر تصویر کشف‌شده توسط این ابزار در پوشه \fBdoq\fP. هر رکورد حاوی اطلاعاتی است که به مکان تصویر اشاره دارد و همچنین یک شکل مستطیل محدودکننده که مرزهای تصویر را نشان می‌دهد: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster index doq/*.tif doq_index.gpkg .EE .UNINDENT .UNINDENT .SS "مثال ۲" .sp از گزینه \fI\%\-\-output\-crs\fP نیز می‌توان برای تبدیل تمام هندسه‌های رستر ورودی به یک سیستم تصویر خروجی یکسان استفاده کرد: .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster index \-\-output\-crs EPSG:4326 \-\-source\-crs\-field\-name=src_srs *.tif tile_index_mixed_crs.gpkg .EE .UNINDENT .UNINDENT .SS "مثال ۳: ایجاد یک نمایه منطبق بر STAC-GeoParquet" .INDENT 0.0 .INDENT 3.5 .sp .EX gdal raster index \-\-profile STAC\-GeoParquet *.tif index.parquet .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" Even Rouault .SH "حق نشر (COPYRIGHT)" 1998-2026 .\" Generated by docutils manpage writer. .