GDAL-RASTER-INFO(1) GDAL GDAL-RASTER-INFO(1)

gdal-raster-info - دریافت اطلاعات درباره یک مجموعه‌داده شطرنجی (رستر)

افزوده شده در نگارش ۳.۱۱.

Usage: gdal raster info [OPTIONS] <INPUT>
بازگرداندن اطلاعات درباره یک مجموعه‌داده شطرنجی (رستر).
آرگومان‌های موقعیتی:
  -i, --dataset, --input <INPUT>                       مجموعه‌داده شطرنجی ورودی [اجباری] [در پایپ‌لاین‌ها در دسترس نیست]
گزینه‌های عمومی:
  -h, --help                                           نمایش پیام راهنما و خروج
  --json-usage                                         نمایش نحوه استفاده به صورت سند JSON و خروج
  --config <KEY>=<VALUE>                               گزینه پیکربندی [قابل تکرار]
گزینه‌ها:
  -f, --of, --format, --output-format <OUTPUT-FORMAT>  قالب خروجی. OUTPUT-FORMAT=json|text
  --mm, --min-max                                      محاسبه کمینه و بیشینه مقادیر
  --stats                                              دریافت یا محاسبه آمارها، با استفاده از تمام پیکسل‌ها
                                                       ناسازگار با --approx-stats (غیرقابل استفاده همزمان)
  --approx-stats                                       دریافت یا محاسبه آمارها، با استفاده از زیرمجموعه‌ای از پیکسل‌ها
                                                       ناسازگار با --stats (غیرقابل استفاده همزمان)
  --hist                                               دریافت یا محاسبه هیستوگرام
گزینه‌های پیشرفته:
  --if, --input-format <INPUT-FORMAT>                  قالب‌های ورودی [قابل تکرار] [در پایپ‌لاین‌ها در دسترس نیست]
  --oo, --open-option <KEY>=<VALUE>                    گزینه‌های باز کردن [قابل تکرار] [در پایپ‌لاین‌ها در دسترس نیست]
  --no-gcp                                             جلوگیری از چاپ فهرست نقاط کنترل زمینی (GCP)
  --no-md                                              جلوگیری از چاپ متادیتا
  --no-ct                                              جلوگیری از چاپ جدول رنگ
  --no-fl                                              جلوگیری از چاپ فهرست فایل‌ها
  --checksum                                           محاسبه چکسام پیکسل‌ها
  --list-metadata-domains, --list-mdd                  فهرست کردن تمام دامنه‌های متادیتای موجود برای مجموعه‌داده
  --mdd, --metadata-domain <METADATA-DOMAIN>           گزارش متادیتا برای دامنه مشخص‌شده. از 'all' می‌توان برای گزارش متادیتا در همه دامنه‌ها استفاده کرد
گزینه‌های خاص:
  --no-nodata                                          جلوگیری از دریافت مقدار بی‌داده (nodata)
  --no-mask                                            جلوگیری از چاپ اطلاعات باند ماسک
  --subdataset <SUBDATASET>                            استفاده از زیرمجموعه‌داده با اندیس مشخص‌شده (شروع از ۱)، به جای خود مجموعه‌داده منبع
  --crs-format <CRS-FORMAT>                            قالب مورد استفاده برای گزارش CRS. مقدار CRS-FORMAT=AUTO|WKT2|PROJJSON (پیش‌فرض: AUTO)

دستور gdal raster info اطلاعات گوناگونی را درباره مجموعه‌داده شطرنجی (رستر) پشتیبانی‌شده توسط GDAL فهرست می‌کند، و هنگام استفاده از خط فرمان آن‌ها را در جریان خروجی استاندارد، یا هنگام استفاده از API در پارامتر output بازمی‌گرداند.

موارد زیر (در صورت مشخص بودن) گزارش خواهند شد:

  • درایور قالبی که برای دسترسی به فایل استفاده شده است.
  • اندازه رستر (به پیکسل و خطوط).
  • سیستم مختصات فایل (در فرم کوتاه به صورت AUTH_NAME:CODE در صورت امکان، وگرنه OGC WKT2:2019).
  • تبدیل جغرافیایی (geotransform) مرتبط با فایل (ضرایب چرخش در حال حاضر گزارش نمی‌شوند).
  • مختصات گوشه‌ها به صورت زمین‌مرجع‌شده، و در صورت امکان طول/عرض جغرافیایی بر اساس تبدیل جغرافیایی کامل (اما نه GCPها).
  • نقاط کنترل زمینی (GCP).
  • متادیتای سراسری فایل (شامل زیرمجموعه‌داده‌ها).
  • انواع داده‌های باند (data types).
  • تفسیرهای رنگی باند.
  • اندازه بلوک باند.
  • توضیحات باند.
  • مقادیر کمینه/بیشینه باند (شناخته‌شده به صورت داخلی و احتمالاً محاسبه‌شده).
  • چکسام باند (در صورت درخواست محاسبه).
  • مقدار بی‌داده (NODATA) باند.
  • وضوح‌های بازبینی (overview resolutions) موجود برای باند.
  • نوع واحد باند (مانند "meters" یا "feet" برای باندهای ارتفاعی).
  • جدول‌های شبه‌رنگ (pseudo-color) باند.

از نگارش ۳.۱۲ جی‌دال (GDAL) به بعد، دستور gdal raster info می‌تواند به عنوان آخرین مرحله یک پایپ‌لاین استفاده شود.

گزینه‌های زیر در دسترس هستند:

خواندن و نمایش آمارهای تصویر. در صورتی که هیچ آماری در تصویر ذخیره نشده باشد، محاسبه را اجباری می‌کند. با این حال، ممکن است بر اساس پیش‌نمایش‌ها (overviews) یا زیرمجموعه‌ای از تمام تایل‌ها محاسبه شوند. برای زمانی که عجله دارید و نیازی به آمارهای دقیق ندارید مفید است.
اجبار به محاسبه چکسام برای هر باند در مجموعه‌داده.
قالب خروجی مورد استفاده. پیش‌فرض JSON است، و از GDAL 3.12 به بعد، هنگام اجرا از خط فرمان مقدار text پیش‌فرض می‌باشد.
افزوده شده در نگارش ۳.۱۳.

قالب مورد استفاده برای گزارش CRS. در حالت پیش‌فرض AUTO، اگر CRS بتواند با نام و کد مرجع (شناخته‌شده برای PROJ) دریافت شود، تنها خلاصه‌ای از CRS شامل نام، شناسه (ID)، نوع و محدوده کاربرد گزارش خواهد شد. در غیر این صورت، تعریف کامل WKT2:2019 گزارش می‌شود.

نکته:

گزینه --crs-format تنها زمانی قابل تنظیم است که --output-format بر روی text تنظیم شده باشد. قالب متنی JSON هر دو مورد WKT2 و PROJJSON را شامل می‌شود.
گزارش اطلاعات هیستوگرام برای همه باندها.
فهرست کردن تمام دامنه‌های متادیتای موجود برای مجموعه‌داده.
متادیتا را با استفاده از موارد زیر اضافه می‌کند:

domain گزارش متادیتا برای دامنه مشخص‌شده.

all گزارش متادیتا برای همه دامنه‌ها.

اجبار به محاسبه مقادیر واقعی کمینه/بیشینه برای هر باند در مجموعه‌داده.
جلوگیری از چاپ جدول رنگ.
تنها نمایش اولین فایل از فهرست فایل‌ها.
جلوگیری از چاپ فهرست نقاط کنترل زمینی (GCP). این گزینه برای مجموعه‌داده‌هایی با تعداد بسیار زیاد GCP، مانند L1B AVHRR یا HDF4 MODIS که شامل هزاران مورد از آن‌ها هستند، می‌تواند مفید باشد.
جلوگیری از چاپ ماسک باند. در صورت مشخص شدن --no-nodata به طور خودکار اعمال می‌شود.
جلوگیری از چاپ متادیتا. برخی مجموعه‌داده‌ها ممکن است حاوی رشته‌های متادیتای فراوانی باشند.
جلوگیری از چاپ مقادیر بی‌داده (nodata). گزینه --no-mask را نیز فعال می‌کند.

می‌تواند برای مثال هنگام پرس‌وجو از یک مجموعه‌داده دوردست GRIB2 که دارای فایل جانبی ایندکس .idx است، همراه با --no-md مفید باشد.

خواندن و نمایش آمارهای تصویر. در صورتی که هیچ آماری در تصویر ذخیره نشده باشد، محاسبه را اجباری می‌کند.
اگر مجموعه‌داده ورودی شامل چندین زیرمجموعه‌داده باشد، زیرمجموعه‌داده با شماره n مشخص‌شده (شروع از ۱) را خوانده و نمایش می‌دهد. این گزینه جایگزینی برای وارد کردن نام کامل زیرمجموعه‌داده است.

نام قالب/درایور که برای تلاش جهت باز کردن فایل(های) ورودی استفاده می‌شود. به طور کلی مشخص کردن آن ضروری نیست، اما در صورتی که شناسایی خودکار درایور نتواند درایور مناسب را انتخاب کند، می‌توان از آن برای صرف‌نظر از شناسایی خودکار استفاده کرد. این گزینه می‌تواند چندین بار برای مشخص کردن چند درایور کاندید تکرار شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز کردن حتمی مجموعه‌داده نمی‌کند. به ویژه، برخی درایورها نیازمندی‌هایی برای پسوند فایل دارند.

قابل تکرار است.

گزینه باز کردن مجموعه‌داده (مختص به قالب داده).

قابل تکرار است.

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

$ gdal raster info utmsmall.tif
Driver: GTiff/GeoTIFF
Files: utmsmall.tif
Size is 100, 100
Coordinate Reference System:
  - name: NAD27 / UTM zone 11N
  - ID: EPSG:26711
  - type: Projected
  - projection type: Transverse Mercator
  - units: metre
Data axis to CRS axis mapping: 1,2
Origin = (440720.000000000000000,3751320.000000000000000)
Pixel Size = (60.000000000000000,-60.000000000000000)
Metadata:
  AREA_OR_POINT=Area
Image Structure Metadata:
  INTERLEAVE=BAND
Corner Coordinates:
Upper Left  (  440720.000, 3751320.000) (117d38'28.21"W, 33d54' 8.47"N)
Lower Left  (  440720.000, 3745320.000) (117d38'26.75"W, 33d50'53.66"N)
Upper Right (  446720.000, 3751320.000) (117d34'34.59"W, 33d54' 9.62"N)
Lower Right (  446720.000, 3745320.000) (117d34'33.28"W, 33d50'54.82"N)
Center      (  443720.000, 3748320.000) (117d36'30.71"W, 33d52'31.66"N)
Band 1 Block=100x81 Type=Byte, ColorInterp=Gray

$ gdal raster info --format=JSON --stats utmsmall.tif
{
  "description":"utmsmall.tif",
  "driverShortName":"GTiff",
  "driverLongName":"GeoTIFF",
  "files":[
    "utmsmall.tif"
  ],
  "size":[
    100,
    100
  ],
  "coordinateSystem":{
    "wkt":"PROJCRS[\"NAD27 / UTM zone 11N\",\n    BASEGEOGCRS[\"NAD27\",\n        DATUM[\"North American Datum 1927\",\n            ELLIPSOID[\"Clarke 1866\",6378206.4,294.978698213898,\n                LENGTHUNIT[\"metre\",1]]],\n        PRIMEM[\"Greenwich\",0,\n            ANGLEUNIT[\"degree\",0.0174532925199433]],\n        ID[\"EPSG\",4267]],\n    CONVERSION[\"Transverse Mercator\",\n        METHOD[\"Transverse Mercator\",\n            ID[\"EPSG\",9807]],\n        PARAMETER[\"Latitude of natural origin\",0,\n            ANGLEUNIT[\"degree\",0.0174532925199433],\n            ID[\"EPSG\",8801]],\n        PARAMETER[\"Longitude of natural origin\",-117,\n            ANGLEUNIT[\"degree\",0.0174532925199433],\n            ID[\"EPSG\",8802]],\n        PARAMETER[\"Scale factor at natural origin\",0.9996,\n            SCALEUNIT[\"unity\",1],\n            ID[\"EPSG\",8805]],\n        PARAMETER[\"False easting\",500000,\n            LENGTHUNIT[\"metre\",1],\n            ID[\"EPSG\",8806]],\n        PARAMETER[\"False northing\",0,\n            LENGTHUNIT[\"metre\",1],\n            ID[\"EPSG\",8807]]],\n    CS[Cartesian,2],\n        AXIS[\"easting\",east,\n            ORDER[1],\n            LENGTHUNIT[\"metre\",1]],\n        AXIS[\"northing\",north,\n            ORDER[2],\n            LENGTHUNIT[\"metre\",1]],\n    ID[\"EPSG\",26711]]",
    "dataAxisToSRSAxisMapping":[
      1,
      2
    ]
  },
  "geoTransform":[
    440720.0,
    60.0,
    0.0,
    3751320.0,
    0.0,
    -60.0
  ],
  "metadata":{
    "":{
      "AREA_OR_POINT":"Area"
    },
    "IMAGE_STRUCTURE":{
      "INTERLEAVE":"BAND"
    }
  },
  "cornerCoordinates":{
    "upperLeft":[
      440720.0,
      3751320.0
    ],
    "lowerLeft":[
      440720.0,
      3745320.0
    ],
    "lowerRight":[
      446720.0,
      3745320.0
    ],
    "upperRight":[
      446720.0,
      3751320.0
    ],
    "center":[
      443720.0,
      3748320.0
    ]
  },
  "wgs84Extent":{
    "type":"Polygon",
    "coordinates":[
      [
        [
          -117.6420428,
          33.9023684
        ],
        [
          -117.6416377,
          33.848257
        ],
        [
          -117.5767844,
          33.8485775
        ],
        [
          -117.5771485,
          33.9026895
        ],
        [
          -117.6420428,
          33.9023684
        ]
      ]
    ]
  },
  "bands":[
    {
      "band":1,
      "block":[
        100,
        81
      ],
      "type":"Byte",
      "colorInterpretation":"Gray",
      "minimum":0.0,
      "maximum":255.0,
      "mean":154.621,
      "stdDev":54.251,
      "metadata":{
        "":{
          "STATISTICS_MINIMUM":"0",
          "STATISTICS_MAXIMUM":"255",
          "STATISTICS_MEAN":"154.6212",
          "STATISTICS_STDDEV":"54.250980733624",
          "STATISTICS_VALID_PERCENT":"100"
        }
      }
    }
  ],
  "stac":{
    "proj:shape":[
      100,
      100
    ],
    "proj:wkt2":"PROJCRS[\"NAD27 / UTM zone 11N\",\n    BASEGEOGCRS[\"NAD27\",\n        DATUM[\"North American Datum 1927\",\n            ELLIPSOID[\"Clarke 1866\",6378206.4,294.978698213898,\n                LENGTHUNIT[\"metre\",1]]],\n        PRIMEM[\"Greenwich\",0,\n            ANGLEUNIT[\"degree\",0.0174532925199433]],\n        ID[\"EPSG\",4267]],\n    CONVERSION[\"Transverse Mercator\",\n        METHOD[\"Transverse Mercator\",\n            ID[\"EPSG\",9807]],\n        PARAMETER[\"Latitude of natural origin\",0,\n            ANGLEUNIT[\"degree\",0.0174532925199433],\n            ID[\"EPSG\",8801]],\n        PARAMETER[\"Longitude of natural origin\",-117,\n            ANGLEUNIT[\"degree\",0.0174532925199433],\n            ID[\"EPSG\",8802]],\n        PARAMETER[\"Scale factor at natural origin\",0.9996,\n            SCALEUNIT[\"unity\",1],\n            ID[\"EPSG\",8805]],\n        PARAMETER[\"False easting\",500000,\n            LENGTHUNIT[\"metre\",1],\n            ID[\"EPSG\",8806]],\n        PARAMETER[\"False northing\",0,\n            LENGTHUNIT[\"metre\",1],\n            ID[\"EPSG\",8807]]],\n    CS[Cartesian,2],\n        AXIS[\"easting\",east,\n            ORDER[1],\n            LENGTHUNIT[\"metre\",1]],\n        AXIS[\"northing\",north,\n            ORDER[2],\n            LENGTHUNIT[\"metre\",1]],\n    ID[\"EPSG\",26711]]",
    "proj:epsg":26711,
    "proj:projjson":{
      "$schema":"https://proj.org/schemas/v0.7/projjson.schema.json",
      "type":"ProjectedCRS",
      "name":"NAD27 / UTM zone 11N",
      "base_crs":{
        "name":"NAD27",
        "datum":{
          "type":"GeodeticReferenceFrame",
          "name":"North American Datum 1927",
          "ellipsoid":{
            "name":"Clarke 1866",
            "semi_major_axis":6378206.4,
            "inverse_flattening":294.978698213898
          }
        },
        "coordinate_system":{
          "subtype":"ellipsoidal",
          "axis":[
            {
              "name":"Geodetic latitude",
              "abbreviation":"Lat",
              "direction":"north",
              "unit":"degree"
            },
            {
              "name":"Geodetic longitude",
              "abbreviation":"Lon",
              "direction":"east",
              "unit":"degree"
            }
          ]
        },
        "id":{
          "authority":"EPSG",
          "code":4267
        }
      },
      "conversion":{
        "name":"Transverse Mercator",
        "method":{
          "name":"Transverse Mercator",
          "id":{
            "authority":"EPSG",
            "code":9807
          }
        },
        "parameters":[
          {
            "name":"Latitude of natural origin",
            "value":0,
            "unit":"degree",
            "id":{
              "authority":"EPSG",
              "code":8801
            }
          },
          {
            "name":"Longitude of natural origin",
            "value":-117,
            "unit":"degree",
            "id":{
              "authority":"EPSG",
              "code":8802
            }
          },
          {
            "name":"Scale factor at natural origin",
            "value":0.9996,
            "unit":"unity",
            "id":{
              "authority":"EPSG",
              "code":8805
            }
          },
          {
            "name":"False easting",
            "value":500000,
            "unit":"metre",
            "id":{
              "authority":"EPSG",
              "code":8806
            }
          },
          {
            "name":"False northing",
            "value":0,
            "unit":"metre",
            "id":{
              "authority":"EPSG",
              "code":8807
            }
          }
        ]
      },
      "coordinate_system":{
        "subtype":"Cartesian",
        "axis":[
          {
            "name":"Easting",
            "abbreviation":"",
            "direction":"east",
            "unit":"metre"
          },
          {
            "name":"Northing",
            "abbreviation":"",
            "direction":"north",
            "unit":"metre"
          }
        ]
      },
      "id":{
        "authority":"EPSG",
        "code":26711
      }
    },
    "proj:transform":[
      60.0,
      0.0,
      440720.0,
      0.0,
      -60.0,
      3751320.0
    ],
    "raster:bands":[
      {
        "data_type":"uint8",
        "stats":{
          "minimum":0.0,
          "maximum":255.0,
          "mean":154.621,
          "stddev":54.251
        }
      }
    ],
    "eo:bands":[
      {
        "name":"b1",
        "description":"Gray"
      }
    ]
  }
}

جستجوی LAYOUT=COG در Image Structure Metadata. مثال زیر از jq استفاده می‌کند و اگر تصویر راه دور یک COG باشد، مقدار true را بازمی‌گرداند. Bash

$ gdal raster info 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 --of=JSON \
| jq '.metadata.IMAGE_STRUCTURE.LAYOUT == "COG"'
PowerShell
> gdal raster info 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 --of=JSON `
| jq '.metadata.IMAGE_STRUCTURE.LAYOUT == \"COG\"'

Bash

gdal raster info in.tif --of json | jq -r '.stac."proj:projjson".id | .authority + ":" + (.code|tostring)'
PowerShell
gdal raster info in.tif --of json | jq -r '.stac.\"proj:projjson\".id | .authority + \":\" + (.code|tostring)'

Even Rouault <even.rouault@spatialys.com>

1998-2026

August 18, 2026