| GDALINFO(1) | GDAL | GDALINFO(1) |
نام (NAME)
gdalinfo - فهرست کردن اطلاعات گوناگون درباره یک مجموعه‌داده شطرنجی پشتیبانی‌شده در GDAL
خلاصه دستور (SYNOPSIS)
Usage: gdalinfo [--help] [--long-usage] [--help-general]
[-json] [-mm]
[[-stats]|[-approx_stats]]
[-hist]
[-nogcp] [-nomd] [-norat] [-noct] [-nofl] [-nonodata] [-nomask]
[-checksum] [-listmdd] [-proj4]
[-wkt_format <WKT1|WKT1_ESRI|WKT2|WKT2_2015|WKT2_2018|WKT2_2019>]
[-sd <n>] [-oo <NAME>=<VALUE>]... [-if <format>]...
[-mdd <domain>|all]
<dataset_name>
توضیحات (DESCRIPTION)
برنامه gdalinfo اطلاعات گوناگونی را درباره یک مجموعه‌داده شطرنجی پشتیبانی‌شده در GDAL فهرست می‌کند.
پارامترهای خط فرمان زیر می‌توانند با هر ترتیبی مشخص شوند
نکته:
معادل در
رابط خط
فرمان جدید
"gdal":
دستور gdal raster info را ببینید.
- --help
- نمایش این پیام راهنما و خروج
- --help-general
- نمایش پیام کاربرد مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج.
- -mm
- محاسبه اجباری مقادیر واقعی کمینه/بیشینه (min/max) برای هر باند در مجموعه‌داده.
- -stats
- خواندن و نمایش آمارهای تصویر. محاسبه اجباری در صورتی که هیچ آماری در تصویر ذخیره نشده باشد.
- -approx_stats
- خواندن و نمایش آمارهای تصویر. محاسبه اجباری در صورتی که هیچ آماری در تصویر ذخیره نشده باشد. با این حال، ممکن است این آمارها بر اساس پیش‌نمایش‌ها (overviews) یا زیرمجموعه‌ای از تمام کاشی‌ها (tiles) محاسبه شوند. مناسب زمانی که عجله دارید و به آمارهای دقیق نیازی ندارید.
- -hist
- گزارش اطلاعات نمودار فراوانی (هیستوگرام) برای تمامی باندها.
- -nogcp
- جلوگیری از چاپ فهرست نقاط کنترل زمینی (GCPs). این گزینه می‌تواند برای مجموعه‌داده‌هایی با تعداد بسیار زیادی GCP، مانند L1B AVHRR یا HDF4 MODIS که شامل هزاران مورد هستند، مفید باشد.
- -nomd
- جلوگیری از چاپ فراداده (metadata). برخی مجموعه‌داده‌ها ممکن است شامل رشته‌های فراداده بسیار زیادی باشند.
- -norat
- جلوگیری از چاپ جدول ویژگی‌های شطرنجی (raster attribute table).
- -noct
- جلوگیری از چاپ جدول رنگ (color table).
- -nonodata
- در نسخه 3.10
اضافه شد.
جلوگیری از چاپ nodata. به طور ضمنی گزینه -nomask را فعال می‌کند.
می‌تواند برای مثال هنگام پرس‌وجوی یک مجموعه‌داده دوردست GRIB2 که دارای فایل جانبی شاخص .idx است، همراه با -nomd مفید باشد.
- -nomask
- در نسخه 3.10
اضافه شد.
جلوگیری از چاپ ماسک باند. در صورت مشخص شدن -nonodata به طور خودکار فعال می‌شود.
- -checksum
- محاسبه اجباری چکسام (checksum) برای هر باند در مجموعه‌داده.
- -listmdd
- فهرست کردن تمامی دامنه‌های فراداده (metadata domains) موجود برای مجموعه‌داده.
- -mdd <domain>|all
- افزودن
فراداده با
استفاده از:
domain گزارش فراداده برای دامنه مشخص‌شده.
all گزارش فراداده برای تمامی دامنه‌ها.
- -nofl
- نمایش تنها نخستین فایل از فهرست فایل‌ها.
- -wkt_format WKT1|WKT1_ESRI|WKT2|WKT2_2015|WKT2_2018|WKT2_2019
- قالب WKT
استفاده‌شده
برای نمایش
SRS (سیستم
مرجع
مکانی). در
حال حاضر
مقادیر
پشتیبانی‌شده
عبارتند از:
WKT1
WKT1_ESRI
WKT2 (جدیدترین نسخه WKT، در حال حاضر WKT2_2019)
WKT2_2015
WKT2_2018 (منسوخ‌شده)
WKT2_2019
در نسخه 3.0.0 اضافه شد.
- -sd <n>
- اگر مجموعه‌داده ورودی شامل چندین زیرمجموعه‌داده (subdataset) باشد، خواندن و نمایش زیرمجموعه‌داده با شماره n مشخص‌شده (شروع از 1). این گزینه‌ای جایگزین برای ارائه نام کامل زیرمجموعه‌داده است.
- -proj4
- گزارش یک رشته PROJ.4 متناظر با سیستم مختصات فایل.
- -oo <NAME>=<VALUE>
- گزینه باز کردن مجموعه‌داده (وابسته به قالب).
- -if <format>
- نام
قالب/درایور
برای باز
کردن
فایل(های)
ورودی.
معمولاً
نیازی به
تعیین آن
نیست، اما
می‌توان از
آن برای
صرف‌نظر از
تشخیص
خودکار
درایور، در
مواقعی که
در انتخاب
درایور
مناسب
ناموفق
است،
استفاده
کرد. این
گزینه
می‌تواند
چندین بار
برای مشخص
کردن چندین
درایور
نامزد
تکرار شود.
توجه داشته
باشید که
این گزینه
آن
درایورها
را به باز
کردن
مجموعه‌داده
وادار
نمی‌کند. به
ویژه، برخی
درایورها
الزامات
خاصی روی
پسوند فایل
دارند.
در نسخه 3.2 اضافه شد.
ابزار gdalinfo تمامی موارد زیر را (در صورت وجود) گزارش خواهد کرد:
- درایور قالبی که برای دسترسی به فایل استفاده شده است.
- اندازه شطرنجی (بر حسب پیکسل و خط).
- سیستم مختصات برای فایل (در قالب OGC WKT).
- تبدیل جغرافیایی (geotransform) مرتبط با فایل (ضرایب چرخشی در حال حاضر گزارش نمی‌شوند).
- مختصات گوشه‌ها به صورت زمین‌مرجع‌شده، و در صورت امکان طول/عرض جغرافیایی بر اساس تبدیل جغرافیایی کامل (نه نقاط GCP).
- نقاط کنترل زمینی (GCPs).
- فراداده سراسری فایل (شامل زیرمجموعه‌داده‌ها).
- انواع داده باندها.
- تفسیرهای رنگی باندها.
- اندازه بلوک باند.
- توضیحات باندها.
- مقادیر کمینه/بیشینه باند (شناخته‌شده به صورت داخلی و احتمالاً محاسبه‌شده).
- چکسام باند (در صورت درخواست محاسبه).
- مقدار NODATA باند.
- تفکیک‌پذیری‌های پیش‌نمایش (overview) موجود برای باند.
- نوع واحد باند (به عنوان مثال "meters" یا "feet" برای باندهای ارتفاعی).
- جداول شبه‌رنگ (pseudo-color) باند.
کد وضعیت بازگشتی (RETURN STATUS CODE)
این برنامه در صورت موفقیت کد وضعیت 0 و در صورت بروز خطا کد غیر صفر برمی‌گرداند (خطاهای غیرمسدودکننده که به صورت هشدار صادر می‌شوند، به عنوان اجرای موفقیت‌آمیز در نظر گرفته می‌شوند).
رابط سی (C API)
این ابزار از طریق C نیز با تابع GDALInfo() قابل فراخوانی است.
مثال‌ها (EXAMPLES)
مثال ۱: قالب خروجی پیش‌فرض
$ gdalinfo utmsmall.tif
Driver: GTiff/GeoTIFF
Files: utmsmall.tif
Size is 100, 100
Coordinate System is:
PROJCRS["NAD27 / UTM zone 11N",
BASEGEOGCRS["NAD27",
DATUM["North American Datum 1927",
ELLIPSOID["Clarke 1866",6378206.4,294.978698213898,
LENGTHUNIT["metre",1]]],
PRIMEM["Greenwich",0,
ANGLEUNIT["degree",0.0174532925199433]],
ID["EPSG",4267]],
CONVERSION["Transverse Mercator",
METHOD["Transverse Mercator",
ID["EPSG",9807]],
PARAMETER["Latitude of natural origin",0,
ANGLEUNIT["degree",0.0174532925199433],
ID["EPSG",8801]],
PARAMETER["Longitude of natural origin",-117,
ANGLEUNIT["degree",0.0174532925199433],
ID["EPSG",8802]],
PARAMETER["Scale factor at natural origin",0.9996,
SCALEUNIT["unity",1],
ID["EPSG",8805]],
PARAMETER["False easting",500000,
LENGTHUNIT["metre",1],
ID["EPSG",8806]],
PARAMETER["False northing",0,
LENGTHUNIT["metre",1],
ID["EPSG",8807]]],
CS[Cartesian,2],
AXIS["easting",east,
ORDER[1],
LENGTHUNIT["metre",1]],
AXIS["northing",north,
ORDER[2],
LENGTHUNIT["metre",1]],
ID["EPSG",26711]]
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
مثال ۲: خروجی JSON
برای مختصات گوشه‌ها در قالب درجه اعشاری به جای درجه، دقیقه، ثانیه بالا، عضو wgs84Extent در دستور gdalinfo -json را بررسی کنید:
نمونه‌ای از خروجی JSON با دستور gdalinfo -json 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",
"metadata":{
}
}
],
"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"
}
],
"eo:bands":[
{
"name":"b1",
"description":"Gray"
}
]
}
}
نویسنده (AUTHOR)
Frank Warmerdam <warmerdam@pobox.com>
حق نشر (COPYRIGHT)
1998-2026
| August 18, 2026 |