GDAL-RASTER-INFO(1) GDAL GDAL-RASTER-INFO(1)
نام (NAME)
gdal-raster-info - دریافت اطلاعات درباره یک مجموعه‌داده شطرنجی (رستر)
افزوده شده در نگارش ۳.۱۱.
خلاصه دستور (SYNOPSIS)
Usage: gdal raster info [OPTIONS]
بازگرداندن اطلاعات درباره یک مجموعه‌داده شطرنجی (رستر).
آرگومان‌های موقعیتی:
-i, --dataset, --input مجموعه‌داده شطرنجی ورودی [اجباری] [در پایپ‌لاین‌ها در دسترس نیست]
گزینه‌های عمومی:
-h, --help نمایش پیام راهنما و خروج
--json-usage نمایش نحوه استفاده به صورت سند JSON و خروج
--config = گزینه پیکربندی [قابل تکرار]
گزینه‌ها:
-f, --of, --format, --output-format قالب خروجی. OUTPUT-FORMAT=json|text
--mm, --min-max محاسبه کمینه و بیشینه مقادیر
--stats دریافت یا محاسبه آمارها، با استفاده از تمام پیکسل‌ها
ناسازگار با --approx-stats (غیرقابل استفاده همزمان)
--approx-stats دریافت یا محاسبه آمارها، با استفاده از زیرمجموعه‌ای از پیکسل‌ها
ناسازگار با --stats (غیرقابل استفاده همزمان)
--hist دریافت یا محاسبه هیستوگرام
گزینه‌های پیشرفته:
--if, --input-format قالب‌های ورودی [قابل تکرار] [در پایپ‌لاین‌ها در دسترس نیست]
--oo, --open-option = گزینه‌های باز کردن [قابل تکرار] [در پایپ‌لاین‌ها در دسترس نیست]
--no-gcp جلوگیری از چاپ فهرست نقاط کنترل زمینی (GCP)
--no-md جلوگیری از چاپ متادیتا
--no-ct جلوگیری از چاپ جدول رنگ
--no-fl جلوگیری از چاپ فهرست فایل‌ها
--checksum محاسبه چکسام پیکسل‌ها
--list-metadata-domains, --list-mdd فهرست کردن تمام دامنه‌های متادیتای موجود برای مجموعه‌داده
--mdd, --metadata-domain گزارش متادیتا برای دامنه مشخص‌شده. از 'all' می‌توان برای گزارش متادیتا در همه دامنه‌ها استفاده کرد
گزینه‌های خاص:
--no-nodata جلوگیری از دریافت مقدار بی‌داده (nodata)
--no-mask جلوگیری از چاپ اطلاعات باند ماسک
--subdataset استفاده از زیرمجموعه‌داده با اندیس مشخص‌شده (شروع از ۱)، به جای خود مجموعه‌داده منبع
--crs-format قالب مورد استفاده برای گزارش CRS. مقدار CRS-FORMAT=AUTO|WKT2|PROJJSON (پیش‌فرض: AUTO)
توضیحات (DESCRIPTION)
دستور 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 می‌تواند به
عنوان آخرین مرحله یک پایپ‌لاین استفاده شود.
گزینه‌های زیر در دسترس هستند:
گزینه‌های اختصاصی برنامه (PROGRAM-SPECIFIC OPTIONS)
--approx-stats
خواندن و نمایش آمارهای تصویر. در صورتی که هیچ آماری در تصویر
ذخیره نشده باشد، محاسبه را اجباری می‌کند. با این حال، ممکن است بر
اساس پیش‌نمایش‌ها (overviews) یا زیرمجموعه‌ای از تمام تایل‌ها محاسبه
شوند. برای زمانی که عجله دارید و نیازی به آمارهای دقیق ندارید
مفید است.
--checksum
اجبار به محاسبه چکسام برای هر باند در مجموعه‌داده.
-f, --of, --format, --output-format json|text
قالب خروجی مورد استفاده. پیش‌فرض JSON است، و از GDAL 3.12 به بعد،
هنگام اجرا از خط فرمان مقدار text پیش‌فرض می‌باشد.
--crs-format AUTO|WKT2|PROJJSON
افزوده شده در نگارش ۳.۱۳.
قالب مورد استفاده برای گزارش CRS. در حالت پیش‌فرض AUTO، اگر CRS
بتواند با نام و کد مرجع (شناخته‌شده برای PROJ) دریافت شود، تنها
خلاصه‌ای از CRS شامل نام، شناسه (ID)، نوع و محدوده کاربرد گزارش
خواهد شد. در غیر این صورت، تعریف کامل WKT2:2019 گزارش می‌شود.
نکته:
گزینه --crs-format تنها زمانی قابل تنظیم است که
--output-format بر روی text تنظیم شده باشد. قالب متنی JSON هر
دو مورد WKT2 و PROJJSON را شامل می‌شود.
--hist گزارش اطلاعات هیستوگرام برای همه باندها.
--list-mdd
فهرست کردن تمام دامنه‌های متادیتای موجود برای مجموعه‌داده.
--mdd, --metadata-domain |all
متادیتا را با استفاده از موارد زیر اضافه می‌کند:
domain گزارش متادیتا برای دامنه مشخص‌شده.
all گزارش متادیتا برای همه دامنه‌ها.
--mm, --min-max
اجبار به محاسبه مقادیر واقعی کمینه/بیشینه برای هر باند در
مجموعه‌داده.
--no-ct
جلوگیری از چاپ جدول رنگ.
--no-fl
تنها نمایش اولین فایل از فهرست فایل‌ها.
--no-gcp
جلوگیری از چاپ فهرست نقاط کنترل زمینی (GCP). این گزینه برای
مجموعه‌داده‌هایی با تعداد بسیار زیاد GCP، مانند L1B AVHRR یا HDF4
MODIS که شامل هزاران مورد از آن‌ها هستند، می‌تواند مفید باشد.
--no-mask
جلوگیری از چاپ ماسک باند. در صورت مشخص شدن --no-nodata به طور
خودکار اعمال می‌شود.
--no-md
جلوگیری از چاپ متادیتا. برخی مجموعه‌داده‌ها ممکن است حاوی رشته‌های
متادیتای فراوانی باشند.
--no-nodata
جلوگیری از چاپ مقادیر بی‌داده (nodata). گزینه --no-mask را نیز
فعال می‌کند.
می‌تواند برای مثال هنگام پرس‌وجو از یک مجموعه‌داده دوردست GRIB2 که
دارای فایل جانبی ایندکس .idx است، همراه با --no-md مفید باشد.
--stats
خواندن و نمایش آمارهای تصویر. در صورتی که هیچ آماری در تصویر
ذخیره نشده باشد، محاسبه را اجباری می‌کند.
--subdataset
اگر مجموعه‌داده ورودی شامل چندین زیرمجموعه‌داده باشد،
زیرمجموعه‌داده با شماره n مشخص‌شده (شروع از ۱) را خوانده و نمایش
می‌دهد. این گزینه جایگزینی برای وارد کردن نام کامل زیرمجموعه‌داده
است.
گزینه‌های استاندارد (STANDARD OPTIONS)
--if, --input-format
نام قالب/درایور که برای تلاش جهت باز کردن فایل(های) ورودی
استفاده می‌شود. به طور کلی مشخص کردن آن ضروری نیست، اما در صورتی
که شناسایی خودکار درایور نتواند درایور مناسب را انتخاب کند،
می‌توان از آن برای صرف‌نظر از شناسایی خودکار استفاده کرد. این
گزینه می‌تواند چندین بار برای مشخص کردن چند درایور کاندید تکرار
شود. توجه داشته باشید که این گزینه آن درایورها را مجبور به باز
کردن حتمی مجموعه‌داده نمی‌کند. به ویژه، برخی درایورها نیازمندی‌هایی
برای پسوند فایل دارند.
قابل تکرار است.
--oo, --open-option =
گزینه باز کردن مجموعه‌داده (مختص به قالب داده).
قابل تکرار است.
کدهای وضعیت بازگشتی (RETURN STATUS CODE)
این برنامه در صورت موفقیت کد وضعیت ۰ و در صورت بروز خطا مقدار غیر صفر
را بازمی‌گرداند (خطاهای غیرمسدودکننده که به عنوان هشدار ارسال می‌شوند، به
عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
مثال‌ها (EXAMPLES)
مثال ۱: دریافت اطلاعات فایل utmsmall.tif در قالب خروجی متنی
$ 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
مثال ۲: دریافت اطلاعات فایل utmsmall.tif در قالب خروجی JSON، به همراه
آمارها
$ 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"
}
]
}
}
مثال ۳: بررسی اینکه آیا یک GeoTIFF راه دور از نوع COG است
جستجوی 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\"'
مثال ۴: بازگرداندن CRS مورد استفاده توسط رستر با استفاده از jq
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)'
نویسنده (AUTHOR)
Even Rouault
حق نشر (COPYRIGHT)
1998-2026
August 18, 2026 GDAL-RASTER-INFO(1)