gdaltindex

ラスタータイルインデックスとして OGR でサポートされたデータセットを作成します.

概要

gdaltindex [--help] [--help-general]
        [-overwrite] [-recursive] [-filename_filter <val>]...
        [-min_pixel_size <val>] [-max_pixel_size <val>]
        [-f <format>] [-tileindex <field_name>] [-write_absolute_path]
        [-skip_different_projection] [-t_srs <target_srs>]
        [-src_srs_name <field_name>] [-src_srs_format {AUTO|WKT|EPSG|PROJ}]
        [-lyr_name <name>] [-lco <NAME>=<VALUE>]...
        [-gti_filename <name>]
        [-tr <xres> <yres>] [-te <xmin> <ymin> <xmax> <ymax>]
        [-ot <datatype>] [-bandcount <val>] [-nodata <val>[,<val>...]]
        [-colorinterp <val>[,<val>...]] [-mask]
        [-mo <KEY>=<VALUE>]...
        [-fetch_md <gdal_md_name> <fld_name> <fld_type>]...
        <index_file> <file_or_dir> [<file_or_dir>]...

説明

このプログラムは, 各入力ラスタファイルに対するレコードを持ち, ファイル名を含む属性と, ラスタを囲むポリゴンジオメトリを持つ OGR でサポートされたデータセットを作成します. この出力は, ラスタータイルインデックスとして MapServer で使用するために適しています, または GTI ドライバの入力として使用できます.

--help

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

--help-general

一般的な GDAL コマンドラインオプションの簡単な使用メッセージを表示して終了します.

-overwrite

Added in version 3.9.

タイルインデックスが既に存在する場合は上書きします.

-recursive

Added in version 3.9.

Whether directories specified in <file_or_dir> should be explored recursively.

-filename_filter <val>

Added in version 3.9.

ディレクトリに含まれるファイル名が従うべきパターンです. '*' は, 0 個以上の任意の文字を含む任意の数の文字に一致するワイルドカード文字です. '?' は, 1 文字に一致するワイルドカード文字です. 比較は大文字小文字を区別せずに行われます. 複数のフィルタを指定できます.

例: -filename_filter "*.tif" -filename_filter "*.tiff"

-min_pixel_size <val>

Added in version 3.9.

ラスタが選択されるために持っているべきピクセルサイズの最小値 (解像度) です. ピクセルサイズは, その範囲を -t_srs で定義されたターゲット SRS に再投影した後に評価されます.

-max_pixel_size <val>

Added in version 3.9.

ラスタが選択されるために持っているべきピクセルサイズの最大値 (解像度) です. ピクセルサイズは, その範囲を -t_srs で定義されたターゲット SRS に再投影した後に評価されます.

-f <format>

出力タイルインデックスファイルの OGR フォーマットです. GDAL 2.3 以降, 指定されていない場合, フォーマットは拡張子から推測されます (以前は ESRI Shapefile でした).

-tileindex <field_name>

インデックスされたラスタのファイルパス/位置を保持するための出力フィールド名です. デフォルトのタイルインデックスフィールド名は location です.

-write_absolute_path

ラスタファイルの絶対パスがタイルインデックスファイルに格納されます. デフォルトでは, ラスタファイル名はコマンドラインで指定されたとおりにファイルに配置されます.

-skip_different_projection

タイルインデックスに挿入されたファイルと同じ投影法を持つファイルのみが挿入されます (-t_srs が指定されていない限り). デフォルトでは投影法をチェックせず, すべての入力を受け入れます.

-t_srs <target_srs>

入力ファイルのジオメトリは, 目的のターゲット座標参照系に変換されます. デフォルトでは, 入力ラスタと同じ座標参照系で単純な矩形ポリゴンが作成されます.

-src_srs_name <field_name>

各タイルの SRS を格納するフィールドの名前です. このフィールド名は, MapServer の TILESRS キーワードの値として使用できます.

-src_srs_format {AUTO|WKT|EPSG|PROJ}

各タイルの SRS を書き込む形式です. タイプは AUTO, WKT, EPSG, PROJ になります. このオプションは, -src_srs_format と一緒に使用する必要があります.

-lyr_name <name>

出力タイルインデックスファイルに作成/追加するレイヤ名です.

-lco <NAME>=<VALUE>

Added in version 3.9.

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

<index_file>

作成/追加する出力ファイルの名前です. デフォルトのデータセットは存在しない場合に作成されますが, 既に存在する場合は既存のデータセットに追加されます.

<file_or_dir>

入力 GDAL ラスタファイルです. 複数のファイルをスペースで区切って指定できます. ワイルドカードも使用できます. -write_absolute_path オプションが使用されていない限り, ここで指定されたスタイルでファイルの場所が格納されます.

GDAL 3.9 以降, これはディレクトリ名にすることもできます. -recursive オプションを使用してサブディレクトリに再帰することもできます.

ソースファイルのリストを指定するために一般的なオプション --optfile filelist.txt を使用することもできます.

GDAL GTI ドライバで使用するためのオプション

gdaltindex は, GTI ドライバで使用するために適したタイルインデックスを生成するために使用できます. 2 つの可能性があります:

  • gdaltindex によって生成されたベクトルタイルインデックスを GTI ドライバの入力として直接使用する

  • または, データベースなどのファイルベースでないフォーマットや, レイヤメタデータ項目の設定をサポートしていないベクトルフォーマットでの使用を容易にするための小さな XML .gti ラッパーファイルを生成します.

レイヤメタデータをサポートするフォーマットは, 例えば GeoPackage (-f GPKG), FlatGeoBuf (-f FlatGeoBuf) または PostGIS (-f PG) です

GTI ドライバがインデックス内の最初のタイルを開いてそれらを推測することを避けるために, -tr と -ot の設定が推奨されます. タイルに nodata またはマスクバンドがある場合, -nodata と -mask も設定する必要があります.

GTI のコンテキストでは, タイルインデックスで参照されるすべてのタイルの範囲は単一の SRS で表現する必要があります. したがって, 入力タイルが異なる SRS を持つ可能性がある場合, -t_srs または -skip_different_projection を指定する必要があります.

-gti_filename <name>

Added in version 3.9.

GDAL GTI / バーチャルラスタタイルインデックスドライバの入力として使用できる XML バーチャルタイルインデックスファイルのファイル名です. レイヤメタデータ項目の書き込みをサポートしていないベクトルフォーマットにタイルインデックスを書き込む場合に便利です.

-tr <xres> <yres>

Added in version 3.9.

SRS 単位あたりのピクセルのターゲット解像度です.

-gti_filename が指定されている場合, またはレイヤメタデータをサポートするフォーマットの場合, XML バーチャルタイルインデックスに書き込まれます. RESX と RESY レイヤメタデータ項目として書き込まれます.

-te <xmin> <ymin> <xmax> <ymax>

Added in version 3.9.

SRS 単位のターゲット範囲です.

-gti_filename が指定されている場合, またはレイヤメタデータをサポートするフォーマットの場合, XML バーチャルタイルインデックスに書き込まれます. MINX, MINY, MAXX および MAXY レイヤメタデータ項目として書き込まれます.

-ot <datatype>

Added in version 3.9.

タイルインデックスのタイルのデータ型: Byte, Int8, UInt16, Int16, UInt32, Int32, UInt64, Int64, Float32, Float64, CInt16, CInt32, CFloat32 または CFloat64

-gti_filename が指定されている場合, またはレイヤメタデータをサポートするフォーマットの場合, XML バーチャルタイルインデックスに書き込まれます. DATA_TYPE レイヤメタデータ項目として書き込まれます.

-bandcount <val>

Added in version 3.9.

タイルインデックスのタイルのバンド数です.

-gti_filename が指定されている場合, またはレイヤメタデータをサポートするフォーマットの場合, XML バーチャルタイルインデックスに書き込まれます. BAND_COUNT レイヤメタデータ項目として書き込まれます.

N と N+1 バンドのタイルの組み合わせは許可されており, (N+1) 番目のバンドの色の解釈がアルファである場合, 許可されます. その場合, N+1 の値をバンド数として書き込む必要があります.

-nodata または -colorinterp が指定されていて複数の値を持つ場合, バンド数もその数から推測されます.

-nodata <val>[,<val>...]

Added in version 3.9.

タイルインデックスのタイルの nodata 値です.

-gti_filename が指定されている場合, またはレイヤメタデータをサポートするフォーマットの場合, XML バーチャルタイルインデックスに書き込まれます. NODATA レイヤメタデータ項目として書き込まれます.

-colorinterp <val>[,<val>...]

Added in version 3.9.

タイルインデックスのタイルの色の解釈: red, green, blue, alpha, gray, undefined.

-gti_filename が指定されている場合, またはレイヤメタデータをサポートするフォーマットの場合, XML バーチャルタイルインデックスに書き込まれます. COLOR_INTERPRETATION レイヤメタデータ項目として書き込まれます.

-mask

Added in version 3.9.

タイルインデックスのタイルにマスクバンドがあるかどうかです.

-gti_filename が指定されている場合, またはレイヤメタデータをサポートするフォーマットの場合, XML バーチャルタイルインデックスに書き込まれます. MASK_BAND レイヤメタデータ項目として書き込まれます.

-mo <KEY>=<VALUE>

Added in version 3.9.

レイヤメタデータをサポートするフォーマットのための任意のレイヤメタデータ項目を書き込みます. このオプションは繰り返すことができます.

注釈

このオプションは -gti_filename と一緒に使用できません

-fetch_md <gdal_md_name> <fld_name> <fld_type>

Added in version 3.9.

ラスタタイルからメタデータ項目を取得し, タイルインデックスのフィールドとして書き込みます.

<gdal_md_name> はラスタメタデータ項目の名前である必要があります. {PIXEL_SIZE} は, ピクセルサイズを示す特別な名前として使用できます.

<fld_name> はタイルインデックスに作成するフィールドの名前である必要があります.

<fld_type> は作成するタイプの名前である必要があります. String, Integer, Integer64, Real, Date, DateTime のいずれか

このオプションは繰り返すことができます.

例: -fetch_md TIFFTAG_DATETIME creation_date DateTime

例

  • ユーティリティが doq フォルダで見つけた画像ごとにレコードを持つ shapefile (doq_index.shp) を生成します. 各レコードには, 画像の場所を指す情報と, 画像の境界を示す境界矩形シェイプが含まれます:

gdaltindex doq_index.shp doq/*.tif

  • 前と同じコマンドを実行しますが, 今回は Shapefile の代わりに GeoPackage を作成します.

gdaltindex -f GPKG doq_index.gpkg doq/*.tif

  • -t_srs オプションを使用して, すべての入力ラスタを同じ出力投影に変換することもできます:

gdaltindex -t_srs EPSG:4326 -src_srs_name src_srs tile_index_mixed_srs.shp *.tif

  • テキストファイルにリストされたファイルからタイルインデックスを作成し, GDAL GTI / バーチャルラスタタイルインデックスドライバで使用するためのメタデータを作成します.

gdaltindex tile_index.gti.gpkg -ot Byte -tr 60 60 -colorinterp Red,Green,Blue --optfile my_list.txt

C API

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

関連項目

Common options for raster programs for other command-line options, and in particular the --optfile switch that can be used to specify a list of input datasets.