| GDAL-DATASET-IDENTIFY(1) | GDAL | GDAL-DATASET-IDENTIFY(1) |
نام (NAME)
gdal-dataset-identify - شناسایی درایور بازکننده مجموعهداده(ها)
افزودهشده در نسخه 3.12.
دستور gdal dataset identify نام درایورهایی را که میتوانند یک یا چند مجموعهداده را باز کنند، گزارش میدهد.
خلاصه دستور (SYNOPSIS)
Usage: gdal dataset identify [OPTIONS] <FILENAME> Identify driver opening dataset(s). Positional arguments: --input, --filename <FILENAME> File or directory name [may be repeated] [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: -o, --output <OUTPUT> Output vector dataset (created by algorithm) -f, --of, --format, --output-format <OUTPUT-FORMAT> Output format --co, --creation-option <KEY>=<VALUE> Creation option [may be repeated] --lco, --layer-creation-option <KEY>=<VALUE> Layer creation option [may be repeated] -l, --output-layer <OUTPUT-LAYER> Output layer name --overwrite Whether overwriting existing output dataset is allowed -r, --recursive Recursively scan files/folders for datasets --force-recursive Recursively scan folders for datasets, forcing recursion in folders recognized as valid formats --detailed Most detailed output. Reports the presence of georeferencing, if a GeoTIFF file is cloud optimized, etc. --report-failures Report failures if file type is unidentified
گزینهها (OPTIONS)
- --filename <FILENAME>
- هر نام فایل یا نام پوشه. الزامی است. میتواند تکرار شود.
- -o, --output <OUTPUT>
- افزودهشده
در نسخه 3.13.
مجموعهداده برداری خروجی که حداقل شامل فیلدهای filename و driver خواهد بود؛ و اگر --detailed مشخص شده باشد، همچنین شامل فیلدهای layout (که مقدار آن میتواند برای نمونه COG باشد)، file_list (فایلهای وابسته / side-car)، has_crs، has_geotransform و has_overview خواهد بود.
هنگامی که این آرگومان مشخص نشود، گزارش نتیجه به جریان خروجی استاندارد ارسال میشود؛ چه بهصورت JSON یا متنی (بسته به --output-format)، برای اجرای خط فرمان، یا در آرگومان output-string هنگام استفاده از طریق API.
توجه داشته باشید که این یک آرگومان موضعی نیست، بنابراین سوییچ -o یا --output باید پیش از مشخص کردن نام، بهطور صریح استفاده شود.
- -f, --of, --format, --output-format json|text|<OTHER-VECTOR-FORMAT>
- تعیین
میکند
کدام قالب
خروجی
استفاده
شود. مقدار
پیشفرض JSON
است، یا در
صورت
فراخوانی
از خط
فرمان،
متنی (text)
خواهد بود.
از نسخه 3.13 GDAL به بعد، سایر قالبهای برداری GDAL با قابلیت ایجاد (creation capabilities) نیز قابل استفاده هستند، که در این صورت باید --output مشخص شود.
- -r, --recursive
- پویش بازگشتی فایلها/پوشهها برای یافتن مجموعهدادهها.
- --force-recursive
- پویش بازگشتی پوشهها برای یافتن مجموعهدادهها، با اجبار به پیمایش بازگشتی در پوشههایی که به عنوان قالبهای معتبر شناخته شدهاند.
- --detailed
- افزودهشده
در نسخه 3.13.
افزایش سطح جزئیات در خروجی. وجود زمینمرجع (georeferencing)، بهینهسازی ابری فایل GeoTIFF و موارد دیگر را گزارش میدهد.
- --report-failures
- گزارش خطاها و شکستها در صورتی که نوع فایل شناسایی نشود.
کد وضعیت بازگشتی (RETURN STATUS CODE)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا مقداری غیرصفر برمیگرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر میشوند به عنوان اجرای موفقیتآمیز در نظر گرفته میشوند).
مثالها (EXAMPLES)
مثال ۱: شناسایی یک فایل منفرد
$ gdal dataset identify NE1_50M_SR_W.tif NE1_50M_SR_W.tif: GTiff
مثال ۲: شناسایی یک فایل منفرد با خروجی JSON
$ gdal dataset identify --of=JSON NE1_50M_SR_W.tif
[
{
"name": "NE1_50M_SR_W.tif",
"driver": "GTiff"
}
]
مثال ۳: حالت بازگشتی برای پویش زیرپوشهها و گزارش قالب داده
$ gdal dataset identify -r 50m_raster/ NE1_50M_SR_W/ne1_50m.jpg: JPEG NE1_50M_SR_W/ne1_50m.png: PNG NE1_50M_SR_W/ne1_50m_20pct.tif: GTiff NE1_50M_SR_W/ne1_50m_band1.tif: GTiff NE1_50M_SR_W/ne1_50m_print.png: PNG NE1_50M_SR_W/NE1_50M_SR_W.aux: HFA NE1_50M_SR_W/NE1_50M_SR_W.tif: GTiff NE1_50M_SR_W/ne1_50m_sub.tif: GTiff NE1_50M_SR_W/ne1_50m_sub2.tif: GTiff
مثال ۴: پویش بازگشتی زیرپوشهها و گزارش اطلاعات تفصیلی در یک فایل CSV
$ gdal dataset identify --output out.csv --detailed -r 50m_raster/
مثال ۵: بررسی بهینهسازی ابری فایل GeoTIFF با استفاده از --detailed
دستور زیر درایور و جزئیات چیدمان تصویر را برمیگرداند: GTiff, layout=COG, has CRS, has geotransform, has overview(s)
$ gdal dataset identify /vsicurl/https://sentinel-cogs.s3.us-west-2.amazonaws.com/sentinel-s2-l2a-cogs/36/Q/WD/2020/7/S2A_36QWD_20200701_0_L2A/TCI.tif --detailed
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |