gdal_footprint

Added in version 3.8.0.

ラスターのフットプリントを計算します.

概要

gdal_footprint [--help] [--help-general]
   [-b <band>]... [-combine_bands union|intersection]
   [-oo <NAME>=<VALUE>]... [-ovr <index>]
   [-srcnodata "<value>[ <value>]..."]
   [-t_cs pixel|georef] [-t_srs <srs_def>] [-split_polys]
   [-convex_hull] [-densify <value>] [-simplify <value>]
   [-min_ring_area <value>] [-max_points <value>|unlimited]
   [-of <ogr_format>] [-lyr_name <dst_layername>]
   [-location_field_name <field_name>] [-no_location]
   [-write_absolute_path]
   [-dsco <name>=<value>]... [-lco <name>=<value>]... [-overwrite] [-q]
   <src_filename> <dst_filename>

説明

gdal_footprint ユーティリティは,ラスターファイルのフットプリントを計算するために使用できます.ノーデータ値(または一般的にはラスターバンドに付属するマスクバンド)を考慮し,有効なピクセルが存在する領域に対応するポリゴン/マルチポリゴンを生成し,出力ベクトルファイルに書き込みます.

nearblack ユーティリティは,適切なマスクバンドを生成するための前処理ステップとして実行できます.

--help

このヘルプメッセージを表示して終了します

--help-general

一般的な GDAL コマンドラインオプションの使用方法を簡単に表示して終了します.

-b <band>

興味のあるバンド. 1 からラスターのバンド数までの間.複数回指定できます.指定しない場合,すべてのバンドが考慮されます.複数のバンドが組み合わされる方法は, -combine_bands で制御されます.

-combine_bands union|intersection

選択されたバンドのマスクバンドがベクトル化される前に,単一のマスクバンドを生成する方法を定義します.デフォルト値は union です:つまり,ピクセルが選択されたバンドの少なくとも 1 つで有効である場合,有効です.``intersection`` は,ピクセルがすべての選択されたバンドで有効である場合のみ有効です.

-ovr <index>

ソースラスターにオーバービューがある場合に使用するソースファイルのオーバービューレベルを指定します.デフォルトでは,完全な解像度レベルが使用されます.インデックスは 0 から始まり,つまり 0 は最初のオーバービューレベルを意味します.このオプションは, -srcnodata と相互排他です.

-srcnodata "<value>[ <value>]..."

入力バンドのノーデータ値を設定します(各バンドに異なる値を指定できます).単一の値が指定された場合,すべての選択されたバンドに適用されます.複数の値が指定された場合,選択されたバンドの数と同じ数の値が必要であり,すべての値を引用符で囲んで単一のオペレーティングシステム引数としてまとめる必要があります.オプションが指定されていない場合,各選択されたバンドの固有のマスクバンドが使用されます.

-t_cs pixel|georef

ターゲット座標系.デフォルトでは,入力データセットがジオリファレンスされている場合,``georef`` が暗黙的に指定されます.つまり,フットプリントジオメトリはラスターの CRS(または -t_srs で指定された CRS)の座標として表されます.``pixel`` を指定すると,フットプリントジオメトリの座標は列と行のインデックスです.

-t_srs <srs_def>

出力ファイルのターゲット CRS. <srs_def> は通常の GDAL/OGR 形式,完全な WKT,PROJ.4,EPSG:n または WKT を含むファイルのいずれかである可能性があります.このオプションを指定すると, -t_cs georef が暗黙的に指定されます.フットプリントは,ソースラスターの CRS から指定された CRS に再投影されます.

-split_polys

指定された場合,マルチポリゴンは,それぞれが単一のポリゴンを持つ複数のフィーチャとして分割されます.

-convex_hull

指定された場合,(マルチ)ポリゴンの凸包が計算されます.

-densify <value>

このオプションの指定値は,出力ジオメトリの連続する2点間の最大距離です.距離の単位は, -t_cs が pixel の場合はピクセル,それ以外の場合はソースラスターのジオリファレンス単位です.このオプションは, -t_srs によって暗黙的に指定された再投影の前に適用されます.

-simplify <value>

このオプションの指定値は, OGRGeometry::Simplify() メソッドを使用して出力ジオメトリの連続する点をマージするために使用される許容値です.距離の単位は, -t_cs が pixel の場合はピクセル,それ以外の場合はターゲットベクトルデータセットのジオリファレンス単位です.このオプションは, -t_srs によって暗黙的に指定された再投影の後に適用されます.

-min_ring_area <value>

リングの面積の最小値.面積の単位は, -t_cs が pixel の場合は平方ピクセル,それ以外の場合はターゲットベクトルデータセットのジオリファレンス単位です.このオプションは, -t_srs によって暗黙的に指定された再投影の後に適用されます.

-max_points <value>|unlimited

各出力ジオメトリの最大点数(各リングの終了点をカウントしない,これは常に最初の点と同じです).デフォルト値は 100 です.``unlimited`` を使用して,その制限を解除できます.

-q

進行状況モニターとその他のエラー以外の出力を抑制します.

-oo <NAME>=<VALUE>

データセットオープンオプション(フォーマット固有)

-of <ogr_format>

出力フォーマットを選択します.短いフォーマット名を使用します.指定されていない場合は,ファイルの拡張子から推測されます

-location_field_name <field_name>

Added in version 3.9.0.

入力データセットのパスが格納される結果のベクトルデータセットのフィールドの名前を指定します.デフォルトのフィールド名は "location" です.入力データセットのパスの書き込みを防ぐには, -no_location を使用します

-no_location

Added in version 3.9.0.

出力ベクトルデータセットのフィールドとして入力データセットのパスの書き込みをオフにします.

-write_absolute_path

Added in version 3.9.0.

入力データセットの絶対パスの書き込みを有効にします.デフォルトでは,ファイル名はコマンドラインで指定されたとおりに場所フィールドに書き込まれます.

-lco <NAME>=<VALUE>

レイヤ作成オプション(フォーマット固有)

-dsco <NAME>=<VALUE>

データセット作成オプション(フォーマット固有)

-lyr_name <value>

ターゲットレイヤの名前.指定されていない場合は footprint です.

-overwrite

ターゲットレイヤが存在する場合は上書きします.

<src_filename>

ソースラスターファイル名.

<dst_filename>

出力ベクトルファイル名.ファイルと出力レイヤが存在する場合,新しいフットプリントが追加されます. -overwrite が使用されていない限りです.

ベクトル化後の幾何学的操作は,次の順序で適用されます:

C API

このユーティリティは,C からも GDALFootprint() で呼び出すことができます.

例

  • WGS 84 経度,緯度座標を使用して,GeoTIFF ファイルのフットプリントを GeoJSON ファイルとして計算します

    gdal_footprint -t_srs EPSG:4326 input.tif output.geojson