نام (NAME)

ogrtindex - ایجاد نمایه کاشی (tileindex)

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

Usage: ogrtindex [--help] [--long-usage] [--help-general]
                 [-lnum <n>]... [-lname <name>]... [-of <output_format>]
                 [-tileindex <tileindex>] [-write_absolute_path]
                 [-skip_different_projection] [-t_srs <srs_def>]
                 [-src_srs_name <field_name>]
                 [-src_srs_format {AUTO|WKT|EPSG|PROJ}]
                 [-accept_different_schemas]
                 <output_dataset> <src_dataset>...

توضیحات (DESCRIPTION)

برنامهٔ ogrtindex می‌تواند برای ایجاد یک tileindex به کار رود - فایلی شامل فهرستی از شناسه‌های مجموعه‌ای از فایل‌های دیگر به همراه گستره‌های مکانی آن‌ها. این ابزار در اصل برای استفاده به‌همراه MapServer جهت دسترسی کاشی‌بندی‌شده به لایه‌ها با استفاده از نوع اتصال OGR در نظر گرفته شده است.

نکته:

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

دستور gdal vector index را ببینید.

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

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

-lnum <n>: افزودن لایهٔ شمارهٔ n از هر فایل مبدأ به نمایه کاشی.

-lname <name>: افزودن لایه‌ای با نام name از هر فایل مبدأ به نمایه کاشی.

-f <output_format>: انتخاب نام قالب خروجی. حالت پیش‌فرض، ساخت یک shapefile است.

-tileindex <field_name>: نامی که برای فیلد نام مجموعه داده استفاده می‌شود. پیش‌فرض LOCATION است.

-write_absolute_path: نام فایل‌ها با مسیر مطلق نوشته می‌شوند.

-skip_different_projection: تنها لایه‌هایی که مرجع تصویر (projection ref) یکسانی با لایه‌های پیش‌تر واردشده در نمایه کاشی دارند، وارد خواهند شد.

-t_srs <target_srs>: گسترهٔ فایل‌های ورودی به سامانه مرجع مختصات مقصدِ مورد نظر تبدیل خواهد شد. استفاده از این گزینه فایل‌هایی تولید می‌کند که با نسخهٔ MapServer < 7.2 سازگار نیستند. حالت پیش‌فرض، چندضلعی‌های مستطیلی ساده‌ای در همان سامانه مرجع مختصات لایه‌های برداری ورودی ایجاد می‌کند.

-src_srs_name <field_name>: نام فیلدی برای ذخیره SRS مربوط به هر کاشی. این نام فیلد می‌تواند به عنوان مقدار کلیدواژهٔ TILESRS در نسخهٔ MapServer >= 7.2 استفاده شود.

-src_srs_format {AUTO|WKT|EPSG|PROJ}: قالبی که SRS هر کاشی باید بر اساس آن نوشته شود. قالب‌های موجود عبارتند از: AUTO، WKT، EPSG، PROJ.

-accept_different_schemas: به‌طور پیش‌فرض، ogrtindex بررسی می‌کند که تمامی لایه‌های واردشده در نمایه دارای شمای مشخصه‌های (attribute schemas) یکسانی باشند. اگر این گزینه را مشخص کنید، این آزمایش غیرفعال خواهد شد. آگاه باشید که نمایه حاصل ممکن است با MapServer ناسازگار باشد!

اگر هیچ آرگومان -lnum یا -lname مشخص نشود، فرض بر این است که تمامی لایه‌های موجود در مجموعه‌داده‌های مبدأ باید به عنوان رکوردهای مستقل به نمایه کاشی افزوده شوند.

اگر نمایه کاشی از قبل وجود داشته باشد، داده‌ها به آن ضمیمه می‌شوند؛ در غیر این صورت ایجاد خواهد شد.

وضعیت خروج (EXIT STATUS)

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

مثال‌ها (EXAMPLES)

مثال ۱

این مثال یک shapefile به نام (tindex.shp) شامل نمایه کاشی لایه‌های BL2000_LINK در تمامی فایل‌های NTF موجود در دایرکتوری wrk ایجاد می‌کند:

ogrtindex tindex.shp wrk/*.NTF

نویسندگان (AUTHORS)

Frank Warmerdam <warmerdam@pobox.com>, Silke Reimer <silke@intevation.de>

کپی‌رایت و تکثیر (COPYRIGHT)

1998-2026