GDAL-DATASET-IDENTIFY(1) GDAL GDAL-DATASET-IDENTIFY(1)

gdal-dataset-identify - شناسایی درایور بازکننده مجموعه‌داده(ها)

افزوده‌شده در نسخه 3.12.

دستور gdal dataset identify نام درایورهایی را که می‌توانند یک یا چند مجموعه‌داده را باز کنند، گزارش می‌دهد.

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

هر نام فایل یا نام پوشه. الزامی است. می‌تواند تکرار شود.
افزوده‌شده در نسخه 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 باید پیش از مشخص کردن نام، به‌طور صریح استفاده شود.

تعیین می‌کند کدام قالب خروجی استفاده شود. مقدار پیش‌فرض JSON است، یا در صورت فراخوانی از خط فرمان، متنی (text) خواهد بود.

از نسخه 3.13 GDAL به بعد، سایر قالب‌های برداری GDAL با قابلیت ایجاد (creation capabilities) نیز قابل استفاده هستند، که در این صورت باید --output مشخص شود.

پویش بازگشتی فایل‌ها/پوشه‌ها برای یافتن مجموعه‌داده‌ها.
پویش بازگشتی پوشه‌ها برای یافتن مجموعه‌داده‌ها، با اجبار به پیمایش بازگشتی در پوشه‌هایی که به عنوان قالب‌های معتبر شناخته شده‌اند.
افزوده‌شده در نسخه 3.13.

افزایش سطح جزئیات در خروجی. وجود زمین‌مرجع (georeferencing)، بهینه‌سازی ابری فایل GeoTIFF و موارد دیگر را گزارش می‌دهد.

گزارش خطاها و شکست‌ها در صورتی که نوع فایل شناسایی نشود.

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

$ gdal dataset identify NE1_50M_SR_W.tif
NE1_50M_SR_W.tif: GTiff

$ 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

$ gdal dataset identify --output out.csv --detailed -r 50m_raster/

دستور زیر درایور و جزئیات چیدمان تصویر را برمی‌گرداند: 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

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026