Docker を使った COG/STAC ジェネレーター
概要
GeoTIFFデータと設定JSONファイルを入力として受け取り、JAXA Earth Database for API と互換性のある COG および STAC ファイルを生成するジェネレーターです。
ジェネレーターの使い方
- 環境に Docker をインストール します。
-
ジェネレーターパッケージを ダウンロードして解凍 します。
-
Dockerfileがあるディレクトリに移動します。 - 以下を実行します：
その後、Dockerコンテナ内で main.py を実行してCOG/STACを生成できます。
入力パラメータの説明
main.py のパラメータ
| パラメータ | 説明 |
|---|---|
root_local |
環境上のCOG/STAC出力先 |
bucket |
使用するバケット名 |
ftype |
"cog" で固定 |
version_path |
"v1" で固定 |
version_full |
JAXA Earth API の STAC バージョン |
GeoTIFF の準備
準備したGeoTIFFは日付フォルダ配下に配置する必要があります。ジェネレーターはフォルダ名から日付を検出します：
sample_geotiff/
├── 2020-01-01/
│ ├── sample_LST.tif
│ └── sample_LST_QA_flag.tif
└── 2020-01-09/
├── sample_LST.tif
└── sample_LST_QA_flag.tif
サポートされている日付フォルダ形式：
| 日付形式 | 例 | 説明 |
|---|---|---|
| YYYY-MM-DD | 2022-01-01 | 日別・8日別・半月別データ |
| YYYY-MM | 2022-01 | 月別データ |
| YYYY | 2022 | 年別データ |
| DDD | 001, 365 | 日別平年値データ |
| MM-DD | 01-01, 12-31 | 半月別平年値データ |
| MM | 01, 12 | 月別平年値データ |
JSON の設定パラメータ
JSONの設定ファイルは、GeoTIFFファイルの場所とSTACファイルの生成方法を制御します。
トップレベルパラメータ：
| 名前 | 説明 |
|---|---|
id |
プロダクトID |
description |
プロダクトの説明 |
title |
プロダクトのタイトル |
keywords |
キーワード：プラットフォーム、センサー、プロバイダーなど |
providers |
プロバイダー情報リスト（name、roles、url） |
license |
"proprietary" で固定 |
extent |
空間的・時間的範囲 |
duration |
期間: 1D、8D、HM、1M、1Y |
sci:publications |
文献リスト |
summaries パラメータ：
| 名前 | 説明 |
|---|---|
platform |
プロダクトのプラットフォーム |
instrument |
プロダクトの機器/センサー |
je:epsg |
EPSG: 4326（EQR）、3995（北極）、3031（南極） |
je:stac_date_format |
日付形式: YYYY-MM/DD、YYYY-MM、YYYY、DDD、MM-DD、MM |
je:cog_level_max |
プロダクトの最大COGレベル |
je:ppu_max |
プロダクトの最大PPU（Pixels Per Unit） |
je:stac_version |
プロダクトのSTACバージョン |
assets / プロダクトパラメータ：
| 名前 | 説明 |
|---|---|
title |
プロダクトのタイトル |
roles |
data、data-mask、または visual |
classification:classes |
プロダクトのクラスデータ |
source.path.dir |
GeoTIFFソースディレクトリ |
source.path.wildcard |
GeoTIFFファイル検索のワイルドカード |
source.path.layer_number |
GeoTIFFファイルのレイヤー番号 |
source.dn.data_type |
データ型: uint8、int8、uint16、int16、float32 |
source.dn.nodata |
Nodataの値 |
source.dn.error |
エラー値 |
source.dn2value |
変換パラメータ: slope、offset |
cog.value.def_interp |
補間方法: bilinear または nearest |
cog.value.unit |
プロダクトの単位 |
cog.dn.data_type |
出力COGのデータ型 |
cog.dn.min / .max |
出力COGの最小/最大値 |
cog.dn.nodata |
出力COGのNodata値 |
cog.dn2value |
COG出力の変換パラメータ: slope、offset |