Dockerを使用したCOG/STACジェネレーター

概要

GeoTIFFデータとconfig.jsonファイルを入力データとして受け取り、API用のJAXA Earth Database として使用できるCOGファイルとSTACファイルを生成するジェネレーターです。

ジェネレーターの使い方

まず、Dockerをインストールします。次に、以下のファイルをダウンロードして解凍します。

COG_STAC_generator.zip

続いて、作業ディレクトリをDockerfileの場所に変更します。その場所で、以下のコマンドを実行します。

$ docker-compose up -d --build

dockerコンテナ内でmain.pyを実行することで、COG/STACを生成することができます。

入力パラメータの説明

Parameters in main.py

main.pyでパラメータを設定します。

表1 : 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

Dateフォルダの種類は以下のとおりです。

表2 : 日付フォルダの種類

日付型

例

説明

YYYY-MM-DD

2022-01-01, 2022-12-31, など

毎日、8日間、半月ごとのデータ

YYYY-MM

2022-01, 2022-12, など

月次データ

YYYY

2022, 2023, など

年間データ

DDD

001, 365, など

毎日の通常データ

MM-DD

01-01, 12-31, など

半月の通常データ

MM

01, 12, など

月次通常データ

json の構成パラメーター

jsonファイル内のパラメータは、GeoTIFFファイルの位置を特定し、STACファイルを生成するために使用されます。

表3 : jsonの構成パラメーター

名前

親

子

説明

id

N/A

N/A

プロダクトID

description

N/A

N/A

プロダクトの説明

title

N/A

N/A

プロダクト名

keywords

N/A

N/A

プロダクトののキーワード。プラットフォーム、センサー、プロバイダーなど

providers

N/A

name, roles, url

プロバイダー情報一覧

name

providers

N/A

プロバイダー名

roles

providers

N/A

プロバイダーのロールリスト

url

providers

N/A

プロバイダーの URL

license

N/A

N/A

"proprietaryで修正

extent

N/A

spatial, temporal

プロダクトの空間的および時間的範囲

spatial

extent

bbox

プロダクトのの空間的範囲

bbox

spatial

N/A

プロダクトのバウンディングボックス

temporal

extent

interval

プロダクトの時間的範囲

interval

temporal

N/A

プロダクトの間隔

duration

N/A

N/A

プロダクトの有効期間

  • 1D (daily)

  • 8D (8-day)

  • HM (Half monthly)

  • 1M (monthly)

  • 1Y (yearly)

summaries

N/A

platform,

instrument,

je:epsg,

je:stad_date_format,

je:cog_level_max,

je:ppu_max,

je:stac_version

プロダクトの概要

platform

summaries

N/A

プロダクトのプラットフォーム

instrument

summaries

N/A

プロダクトの観測装置/センサ

je:epsg

summaries

N/A

プロダクトのEPSG

  • 4326 (EQR:Equi-Rectangular)

  • 3995 (North pole)

  • 3031 (South pole)

je:stac_date_format

summaries

N/A

STACの日付型

  • YYYY-MM/DD

  • YYYY-MM

  • YYYY

  • DDD

  • MM-DD

  • MM

je:cog_level_max

summaries

N/A

プロダクトの最大COGレベル

je:ppu_max

summaries

N/A

プロダクトの最大PPU(Pixel Per Unit)

je:stac_version

summaries

N/A

プロダクトのSTACバージョン

sci:publications

N/A

N/A

プロダクトに関する論文リスト

assets

N/A

multiple product names

プロダクトのアセット。名前を指定する。例：NDVI_AVE

product name

(be modified)

assets

title,

roles,

classification:classes,

source,

cog

プロダクトのソース元と変換パラメーター

title

product name

N/A

プロダクト名

roles

product name

N/A

プロダクトリストのロール

  • data (通常データ)

  • data-mask (マスクとして使用されるデータ)

  • visual (可視のみを表示)

classification:classes

product name

N/A

プロダクトのクラスデータ

source

product name

path,

dn

dn2value

GeoTIFFソースの情報

path

source

dir,

wildcard

layer_number

GeoTIFFソースのパス情報

dir

path

N/A

GeoTIFFソースのディレクトリ

wildcard

path

N/A

GeoTIFF ファイルを検索および検出するためのワイルドカード

layer_number

path

N/A

GeoTIFFファイルのレイヤー番号

dn

source

data_type,

nodata,

error

GeoTIFFファイル内のデジタル番号情報

data_type

dn

N/A

GeoTIFFファイルのdata型

  • uint8

  • int8

  • uint16

  • int16

  • float32

nodata

dn

N/A

GeoTIFF ファイルのnodata値

error

dn

N/A

GeoTIFFファイルのエラー値

dn2value

source

slope,

offset

変換パラメータのスロープ/オフセット

cog

product name

value,

dn2value,

dn,

pint

COG情報を出力

value

cog

def_interp,

unit

COG値の情報を出力

def_interp

value

N/A

COG値の補間方法

  • bilinear

  • nearest

unit

value

N/A

プロダクトのユニット

dn2value

cog

slope,

offset

変換パラメータのスロープ/オフセット

dn

cog

data_type,

min,

max,

nodata

COGのデジタル番号情報

data_type

dn

N/A

COGのData型

  • uint8

  • int8

  • uint16

  • int16

  • float32

min

dn

N/A

COGの最小値

max

dn

N/A

COGの最大値

nodata

dn

N/A

COGのnodata値

pint

cog

N/A

COGにおけるフォトメトリック解釈

  • MINISWHITE

  • MINISBLACK

  • RGB

  • PALETTE

links

N/A

rel,

href,

type

ライセンスに関するリンク

rel

links

N/A

リンクカテゴリー

href

links

N/A

リンク先URL

type

links

N/A

リンクタイプ