gdal_edit
既存の GDAL データセットのさまざまな情報を編集します.
概要
gdal_edit [--help] [--help-general] [-ro] [-a_srs <srs_def>]
[-a_ullr <ulx> <uly> <lrx> <lry>] [-a_ulurll <ulx> <uly> <urx> <ury> <llx> <lly>]
[-tr <xres> <yres>] [-unsetgt] [-unsetrpc] [-a_nodata <value>] [-unsetnodata]
[-a_coord_epoch <epoch>] [-unsetepoch]
[-unsetstats] [-stats] [-approx_stats]
[-setstats <min> <max> <mean> <stddev>]
[-scale <value>] [-offset <value>] [-units <value>]
[-colorinterp_<X> {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...}]...
[-gcp <pixel> <line> <easting> <northing> [<elevation>]]...
[-unsetmd] [-oo <NAME>=<VALUE>]... [-mo <META-TAG>=<VALUE>]...
<datasetname>
説明
gdal_edit は,既存の GDAL データセットのさまざまな情報(投影,ジオトランスフォーム,ノーデータ,メタデータ)を編集するために使用できます.
既存のデータセットに対する更新アクセスをサポートするラスターフォーマットのみで動作します.
注意
フォーマットによっては,更新された情報の古い値がファイル内に "ゴースト" 状態で残っている場合があります.GDAL API を介してアクセスできなくなっても,このような場合があります.例えば, GTiff -- GeoTIFF File Format フォーマットの場合です(これは完全なリストではありません).
注釈
gdal_edit は Python ユーティリティであり,GDAL Python バインディングが利用可能な場合のみ利用可能です.
- --help
このヘルプメッセージを表示して終了します
- --help-general
一般的な GDAL コマンドラインオプションの使用方法を簡単に表示して終了します.
- -ro
データセットを読み取り専用で開きます.データセットを更新モードで使用することを拒否するドライバには便利かもしれません.この場合,更新された情報は PAM
.aux.xmlファイルに保存されます.
- -a_srs <srs_def>
ターゲット座標系を定義します.この座標系はデータセットに書き込まれます.空の文字列または None が指定された場合,既存の座標系が削除されます(TIFF/GeoTIFF の場合,それ以外はうまくサポートされないかもしれません).
- -a_coord_epoch <epoch>
データセットの座標エポックを割り当て/上書きします.小数年(例:2021.3)として指定します.
Added in version 3.9.
- -unsetepoch
データセットの座標エポックを削除します.
Added in version 3.9.
- -a_ullr <ulx> <uly> <lrx> <lry>
データセットのジオリファレンスされた境界を割り当て/上書きします.
- -a_ulurll <ulx> <uly> <urx> <ury> <llx> <lly>
データセットのジオリファレンスされた境界を3つの点から割り当て/上書きします:左上,右上,左下.
-a_ullrとは異なり,これは回転したデータセット(座標系の軸に平行でないエッジ)もサポートします.Added in version 3.1.
- -tr <xres> <yres>
ターゲット解像度を設定します.値はジオリファレンスされた単位で表される必要があります.両方とも正の値である必要があります.
- -unsetgt
ジオリファレンス情報を削除します.
- -unsetrpc
RPC 情報を削除します.
Added in version 2.4.
- -unsetstats
バンド統計情報を削除します.
Added in version 2.0.
- -stats
バンド統計を計算して保存します.
Added in version 2.0.
- -setstats <min> <max> <mean> <stddev>
バンド統計のユーザー定義値(最小値,最大値,平均値,標準偏差)を保存します.値のいずれかが None に設定されている場合,実際の統計値がファイルから計算され,そのうち None に設定されたものが実際の統計値から使用されます.
Added in version 2.4.
- -approx_stats
バンド統計を計算して保存します.
Added in version 2.0.
- -a_nodata <value>
指定されたノーデータ値を出力バンドに割り当てます.
- -unsetnodata
既存のノーデータ値を削除します.
Added in version 2.1.
- -scale <value>
出力バンドに指定されたスケール値を割り当てます.単一のスケール値が提供された場合,すべてのバンドに設定されます.代わりに,バンドごとに1つのスケール値を提供できます.この場合,スケール値の数はバンドの数と一致する必要があります.スケールが必要ない場合,値を 1 に設定することをお勧めします.スケールとオフセットは一般的に一緒に使用されます.たとえば,スケールとオフセットは,精度が 0.1 で-100 から始まる符号なし 16 ビット整数ファイルに標高を格納するために使用されるかもしれません.真の値は次のように計算されます: true_value = (pixel_value * scale) + offset
注釈
これらの値は, gdal_translate 実行中に -unscale を使用して適用できます.
Added in version 2.2.
- -offset <value>
出力バンドに指定されたオフセット値を割り当てます.単一のオフセット値が提供された場合,すべてのバンドに設定されます.代わりに,バンドごとに1つのオフセット値を提供できます.この場合,オフセット値の数はバンドの数と一致する必要があります.オフセットが必要ない場合,値を 0 に設定することをお勧めします.詳細についてはスケールを参照してください.
Added in version 2.2.
- -units <value>
出力バンドに単位を割り当てます.
Added in version 3.1.
- -colorinterp_<X> {red|green|blue|alpha|gray|undefined|pan|coastal|rededge|nir|swir|mwir|lwir|...}
バンド X (X は 1 から始まる有効なバンド番号) の色の解釈を変更します.
Added in version 2.3.
- -gcp pixel <line> <easting> <northing> [<elevation>]
指定された地上制御点をデータセットに追加します.このオプションは,複数回提供して GCP のセットを提供できます.
- -mo <META-TAG>=<VALUE>
可能であれば,出力データセットに設定するメタデータキーと値を渡します.このメタデータは,
-unsetmdも指定されていない限り,既存のメタデータ項目に追加されます.
- -oo <NAME>=<VALUE>
オープンオプション(フォーマット固有).
Added in version 2.0.
-a_ullr, -a_ulurll, -tr および -unsetgt オプションは排他的です.
-unsetstats と -stats または -approx_stats オプションは排他的です.
例
gdal_edit -mo DATUM=WGS84 -mo PROJ=GEODETIC -a_ullr 7 47 8 46 test.ecw
gdal_edit -scale 1e3 1e4 -offset 0 10 twoBand.tif