gdalinfo
ラスターデータセットに関する情報をリストします。
概要
gdalinfo [--help] [--help-general]
[-json] [-mm] [-stats | -approx_stats] [-hist]
[-nogcp] [-nomd] [-norat] [-noct] [-nofl] [-nonodata] [-nomask]
[-checksum] [-listmdd] [-mdd <domain>|all]
[-proj4] [-wkt_format {WKT1|WKT2|<other_format>}]...
[-sd <subdataset>] [-oo <NAME>=<VALUE>]... [-if <format>]...
<datasetname>
説明
gdalinfo プログラムは多彩なGDALサポートラスターデータセットについての情報をリストします
以下のコマンドラインパラメータを任意の順序で利用できます
- --help
このヘルプを表示して終了します
- --help-general
一般的なGDALコマンドラインオプションの簡単な利用方法メッセージを表示して 終了します。
- -json
json 形式で出力を表示します。GDAL 3.6以降, STAC item を生成するために便利なkey-valueペアを作成する機能を含みます。さらに
-statsまたは-histフラグが渡された場合はそれぞれ統計とヒストグラムが作成されます。
- -mm
データセット内の各バンドの正確な最小値/最大値を強制的に計算します。
- -stats
画像の統計情報を読み取って表示します。 統計情報が画像に保存されていない場合は 計算を強制します。
- -approx_stats
画像の統計情報を読み取って表示します。 統計情報が画像に保存されていない場合は 計算を強制します。 ただしオーバービューや全タイルのサブセットを利用して計算が 行われることがあります。 急いでいて正確な統計が必ずしも必要ない場合は便利です。
- -hist
すべてのバンドのヒストグラム情報をレポートします。
- -nogcp
グランドコントロールポイントリストの出力を抑制します。この機能は膨大な GCPを保有するデータセット, 例えば L1B AVHRR や HDF4 MODIS のような 数千のGCPを保有するデータセットに利用する時に便利です。
- -nomd
メタデータの出力を抑制します。いくつかのデータセットは多数のメタデータ文字列を保有しています。
- -norat
ラスター属性テープルの出力を抑制します。
- -noct
カラーテーブルの出力を抑制します。
- -nonodata
Added in version 3.10.
NODATAの出力を抑制します。
-nomaskを含みます。たとえば .idx サイドカーファイルを持つリモートGRIB2データセットを問い合わせる場合に便利です。
-nomdと一緒に利用します。
- -checksum
データセット内の各バンドのチェックサムの計算を行います。
- -listmdd
データセットで利用可能なメタデータ ドメインを一覧表示します。
- -mdd <domain>|all
以下を利用してメタデータを追加します:
domain指定されたドメインのメタデータをレポートします。allすべてのドメインのメタデータをレポートします。
- -nofl
ファイルリストの先頭のファイルのみ表示します。
- -wkt_format WKT1|WKT2|WKT2_2015|WKT2_2018|WKT2_2019
SRSを表示するために使用されるWKT形式。現在サポートされている値は次のとおりです:
WKT1WKT2(WKT の最新バージョン, 現在 WKT2_2019)WKT2_2015WKT2_2018(非推奨)WKT2_2019Added in version 3.0.0.
- -sd <n>
入力データセットに多くのサブデータセットが含まれる場合は 指定された番号
n(１から始まる)のサブデータセットを読んで表示します。 これは完全なサブセット名称を指定する方法の代替として利用できます。
- -proj4
指定ファイルの座標系に対応するPROJ.4文字列をレポートします。
- -oo <NAME>=<VALUE>
データセットオープンオプション (フォーマット固有)。
- -if <format>
入力ファイルを開くために試行する Format/driver 名。 通常は指定する必要はありませんが、適切なドライバーを選択できなかった場合に自動ドライバー検出をスキップするために使用できます。 このオプションは候補となるドライバーを複数回指定するために複数回繰り返すことができます。これらのドライバーにデータセットを開くように強制するものでないことに注意して下さい。特に一部のドライバーにはファイル拡張子に関する要件があります。
Added in version 3.2.
gdalinfo は以下のすべての情報を表示します (既知の場合):
ファイルアクセスに利用したフォーマットドライバー
ラスターサイズ(ピクセル数と行数)
ファイルの座標系 (OGC WKT形式)
ファイルに関連つけられた地理変換(回転係数は 現在報告されません)。
角の座標はジオリファレンスされ、可能な場合は完全な地理変換に基づいた 経度/緯度が (しかしGCPではない)表示されます。
グランドコントロールポイント。
ファイル全体 (サブデータセットを含む)のメタデータ。
バンドデータタイプ
バンド色の解釈。
バンドブロックサイズ。
バンドの説明。
バンドの最小値/最大値(内部的に既知のデータまたは計算されたもの)。
バンドチェックサム (計算が要求された場合)。
バンドのNODATA値。
バンドの縮小画像の解像度。
バンドの単位タイプ(例. 標高バンドの場合 "meters" または "feet" )。
バンド疑似カラーテーブル
C API
このユーティリティはC言語から呼び出すこともできます GDALInfo().
Added in version 2.1.
例
gdalinfo ~/openev/utm.tif
Driver: GTiff/GeoTIFF
Size is 512, 512
Coordinate System is:
PROJCS["NAD27 / UTM zone 11N",
GEOGCS["NAD27",
DATUM["North_American_Datum_1927",
SPHEROID["Clarke 1866",6378206.4,294.978698213901]],
PRIMEM["Greenwich",0],
UNIT["degree",0.0174532925199433]],
PROJECTION["Transverse_Mercator"],
PARAMETER["latitude_of_origin",0],
PARAMETER["central_meridian",-117],
PARAMETER["scale_factor",0.9996],
PARAMETER["false_easting",500000],
PARAMETER["false_northing",0],
UNIT["metre",1]]
Origin = (440720.000000,3751320.000000)
Pixel Size = (60.000000,-60.000000)
Corner Coordinates:
Upper Left ( 440720.000, 3751320.000) (117d38'28.21"W, 33d54'8.47"N)
Lower Left ( 440720.000, 3720600.000) (117d38'20.79"W, 33d37'31.04"N)
Upper Right ( 471440.000, 3751320.000) (117d18'32.07"W, 33d54'13.08"N)
Lower Right ( 471440.000, 3720600.000) (117d18'28.50"W, 33d37'35.61"N)
Center ( 456080.000, 3735960.000) (117d28'27.39"W, 33d45'52.46"N)
Band 1 Block=512x16 Type=Byte, ColorInterp=Gray
上記の度、分、秒で表された角の座標を10進数で表したい場合は gdalinfo -jsonのメンバー wgs84Extent について調べてください:
gdalinfo -json byte.tif を利用してJSON出力を行った例
{
"description":"byte.tif",
"driverShortName":"GTiff",
"driverLongName":"GeoTIFF",
"files":[
"byte.tif"
],
"size":[
20,
20
],
"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[\"UTM zone 11N\",\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[\"(E)\",east,\n ORDER[1],\n LENGTHUNIT[\"metre\",1]],\n AXIS[\"(N)\",north,\n ORDER[2],\n LENGTHUNIT[\"metre\",1]],\n USAGE[\n SCOPE[\"Engineering survey, topographic mapping.\"],\n AREA[\"North America - between 120°W and 114°W - onshore. Canada - Alberta; British Columbia; Northwest Territories; Nunavut. Mexico. United States (USA) - California; Idaho; Nevada; Oregon; Washington.\"],\n BBOX[26.93,-120,78.13,-114]],\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,
3750120.0
],
"lowerRight":[
441920.0,
3750120.0
],
"upperRight":[
441920.0,
3751320.0
],
"center":[
441320.0,
3750720.0
]
},
"wgs84Extent":{
"type":"Polygon",
"coordinates":[
[
[
-117.6420428,
33.9023684
],
[
-117.6419617,
33.8915461
],
[
-117.6289846,
33.8916131
],
[
-117.629064,
33.9024353
],
[
-117.6420428,
33.9023684
]
]
]
},
"bands":[
{
"band":1,
"block":[
20,
20
],
"type":"Byte",
"colorInterpretation":"Gray",
"metadata":{
}
}
],
"stac":{
"proj:shape":[
20,
20
],
"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[\"UTM zone 11N\",\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[\"(E)\",east,\n ORDER[1],\n LENGTHUNIT[\"metre\",1]],\n AXIS[\"(N)\",north,\n ORDER[2],\n LENGTHUNIT[\"metre\",1]],\n USAGE[\n SCOPE[\"Engineering survey, topographic mapping.\"],\n AREA[\"North America - between 120°W and 114°W - onshore. Canada - Alberta; British Columbia; Northwest Territories; Nunavut. Mexico. United States (USA) - California; Idaho; Nevada; Oregon; Washington.\"],\n BBOX[26.93,-120,78.13,-114]],\n ID[\"EPSG\",26711]]",
"proj:epsg":26711,
"proj:projjson":{
"$schema":"https://proj.org/schemas/v0.6/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,
"semi_minor_axis":6356583.8
}
},
"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":"UTM zone 11N",
"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":"E",
"direction":"east",
"unit":"metre"
},
{
"name":"Northing",
"abbreviation":"N",
"direction":"north",
"unit":"metre"
}
]
},
"scope":"Engineering survey, topographic mapping.",
"area":"North America - between 120°W and 114°W - onshore. Canada - Alberta; British Columbia; Northwest Territories; Nunavut. Mexico. United States (USA) - California; Idaho; Nevada; Oregon; Washington.",
"bbox":{
"south_latitude":26.93,
"west_longitude":-120,
"north_latitude":78.13,
"east_longitude":-114
},
"id":{
"authority":"EPSG",
"code":26711
}
},
"proj:transform":[
440720.0,
60.0,
0.0,
3751320.0,
0.0,
-60.0
],
"raster:bands":[
{
"data_type":"uint8"
}
],
"eo:bands":[
{
"name":"b1",
"description":"Gray"
}
]
}
}