| GDAL-RASTER-INFO(1) | GDAL | GDAL-RASTER-INFO(1) |
نام (NAME)
gdal-raster-info - دریافت اطلاعات درباره یک مجموعهداده شطرنجی (رستر)
افزوده شده در نگارش ۳.۱۱.
خلاصه دستور (SYNOPSIS)
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)
توضیحات (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 گزارش میشود.
نکته:
- --hist
- گزارش اطلاعات هیستوگرام برای همه باندها.
- --list-mdd
- فهرست کردن تمام دامنههای متادیتای موجود برای مجموعهداده.
- --mdd, --metadata-domain <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>
- اگر مجموعهداده ورودی شامل چندین زیرمجموعهداده باشد، زیرمجموعهداده با شماره n مشخصشده (شروع از ۱) را خوانده و نمایش میدهد. این گزینه جایگزینی برای وارد کردن نام کامل زیرمجموعهداده است.
گزینههای استاندارد (STANDARD OPTIONS)
- --if, --input-format <format>
- نام
قالب/درایور
که برای
تلاش جهت
باز کردن
فایل(های)
ورودی
استفاده
میشود. به
طور کلی
مشخص کردن
آن ضروری
نیست، اما
در صورتی که
شناسایی
خودکار
درایور
نتواند
درایور
مناسب را
انتخاب
کند،
میتوان از
آن برای
صرفنظر از
شناسایی
خودکار
استفاده
کرد. این
گزینه
میتواند
چندین بار
برای مشخص
کردن چند
درایور
کاندید
تکرار شود.
توجه داشته
باشید که
این گزینه
آن
درایورها
را مجبور به
باز کردن
حتمی
مجموعهداده
نمیکند. به
ویژه، برخی
درایورها
نیازمندیهایی
برای پسوند
فایل دارند.
قابل تکرار است.
- --oo, --open-option <NAME>=<VALUE>
- گزینه باز
کردن
مجموعهداده
(مختص به
قالب داده).
قابل تکرار است.
کدهای وضعیت بازگشتی (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"'
> 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)'
gdal raster info in.tif --of json | jq -r '.stac.\"proj:projjson\".id | .authority + \":\" + (.code|tostring)'
نویسنده (AUTHOR)
Even Rouault <even.rouault@spatialys.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |