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 ] [-sd ] [-oo =]... [-if ]... [-mdd |all] توضیحات (DESCRIPTION) برنامه gdalinfo اطلاعات گوناگونی را درباره یک مجموعه‌داده شطرنجی پشتیبانی‌شده در GDAL فهرست می‌کند. پارامترهای خط فرمان زیر می‌توانند با هر ترتیبی مشخص شوند نکته: معادل در رابط خط فرمان جدید "gdal": دستور gdal raster info را ببینید. --help نمایش این پیام راهنما و خروج --help-general نمایش پیام کاربرد مختصر برای گزینه‌های عمومی خط فرمان GDAL و خروج. -json نمایش خروجی در قالب json. از نسخه 3.6 در GDAL، این مورد شامل جفت‌های کلید-مقدار کاربردی برای ساخت یک مورد STAC است، از جمله آمارها و نمودارهای فراوانی (هیستوگرام) در صورتی که به ترتیب پرچم‌های -stats یا -hist داده شده باشند. -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 |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 اگر مجموعه‌داده ورودی شامل چندین زیرمجموعه‌داده (subdataset) باشد، خواندن و نمایش زیرمجموعه‌داده با شماره n مشخص‌شده (شروع از 1). این گزینه‌ای جایگزین برای ارائه نام کامل زیرمجموعه‌داده است. -proj4 گزارش یک رشته PROJ.4 متناظر با سیستم مختصات فایل. -oo = گزینه باز کردن مجموعه‌داده (وابسته به قالب). -if نام قالب/درایور برای باز کردن فایل(های) ورودی. معمولاً نیازی به تعیین آن نیست، اما می‌توان از آن برای صرف‌نظر از تشخیص خودکار درایور، در مواقعی که در انتخاب درایور مناسب ناموفق است، استفاده کرد. این گزینه می‌تواند چندین بار برای مشخص کردن چندین درایور نامزد تکرار شود. توجه داشته باشید که این گزینه آن درایورها را به باز کردن مجموعه‌داده وادار نمی‌کند. به ویژه، برخی درایورها الزامات خاصی روی پسوند فایل دارند. در نسخه 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 حق نشر (COPYRIGHT) 1998-2026 August 18, 2026 GDALINFO(1)