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       GDAL-DATASET-IDENTIFY(1)