eodagダウンロード - eodagソースコードのダウンロード

eodag

その他のソースコード

v3.0.1

ダウンロード

EODAG Jupyterlab 拡張機能: eodag-labextension をチェックアウトしてください。これにより、ノートブックに使いやすい UI が提供され、 eodagを使用して EO 製品を検索および参照できるようになります。

EODAG (Earth Observation Data Access Gateway) は、データプロバイダーに関係なくデータアクセスのための統一 API を提供しながら、検索、結果の集計、リモートセンシング画像のダウンロードを行うためのコマンドラインツールおよびプラグイン指向の Python フレームワークです。 EODAG SDK は、次の 3 つの機能を中心に構成されています。

製品タイプのリスト: サポートされている製品のリストとその説明
製品の検索 (製品タイプまたは UID による) : 指定された検索条件に従って製品を検索します。
製品のダウンロード : 製品を「現状のまま」ダウンロードします。

EODAG は Python で開発されています。モジュール式プラグインアーキテクチャに従って構造化されており、簡単に拡張でき、新しいデータプロバイダーを統合できます。このツールは 3 種類のプラグインで構成されています。

カタログ検索プラグイン。データの検索 (OpenSearch、CSW など)、パスの構築、クイックルックの取得、結果の結合を担当します。
プラグインをダウンロードすると、常に同じディレクトリ構成で (FTP、HTTP などを介して) データをローカルにダウンロードして取得できます。
認証プラグイン。使用される外部サービス (JSON トークン、Basic Auth、OAUTH など) でユーザーを認証するために使用されます。

v2.0 以降、EODAG は STAC クライアントまたはサーバーとして実行できます。

さらに詳しい情報については、ドキュメントをお読みください。

インストール

EODAG は PyPI で利用できます。

 python -m pip インストール eodag

そして conda-forge チャネルのcondaを使用します。

 conda install -c conda-forge eodag

重要

v3.0.0 の重大な変更: EODAG には最小限の依存関係セットが付属していることに注意してください。さらに多くの機能が必要な場合は、利用可能な追加機能のいずれかを使用してインストールしてください。

使用法

ダウンロードするには、eodag ユーザー構成ファイルに目的のプロバイダーの資格情報を入力する必要があります。ファイルは、最初の実行時に空の値で自動的に作成されます。

Python API

Python コードで API を操作するための使用例:

 from eodag import EODataAccessGatewaydag = EODataAccessGateway()search_results = dag.search(productType='S2_MSI_L1C',geom={'lonmin': 1, 'latmin': 43.5, 'lonmax': 2, 'latmax': 44}, # 受け入れますWKT ポリゴン、shapely.geometry、 ...start='2021-01-01',end='2021-01-15')product_paths = dag.download_all(search_results)

これにより、デフォルトのプロバイダーで Sentinel 2 レベル 1C 製品が検索され、見つかった製品の最初のページと、検索条件に一致する製品の推定合計数が返されます。そして、これらの製品をダウンロードします。詳細については、Python API ユーザーガイドを確認してください。

重要

v3.0.0 の重大な変更: search() メソッドは、2 つの値のタプルではなく、単一のSearchResultのみを返すようになりました。

STAC REST API

eodag インスタンスは、コマンドラインから STAC 準拠の REST API を介して公開できます ( eodag[server]が必要)。

 $ eodagserve-rest --help
使用法: eodagserve-rest [オプション]

  eodag HTTPサーバーを起動する

  EODAG_CORS_ALLOWED_ORIGINS 環境変数を設定してクロスを構成します。
  オリジン リソース共有では、カンマ区切りの URL としてオリジンを使用できます (例: 「http://somewhere,htttp://somewhere.else」)。

オプション:
  -f, --config PATH ユーザー構成ファイルへのファイル パス。
                      認証情報、デフォルトは ~/.config/eodag/eodag.yml
  -l、--locs PATH ロケーションシェープファイル構成ファイルへのファイルパス
  -d、--daemon デーモンモードで実行
  -w、 --world IPv4 0.0.0.0 (すべてのネットワーク インターフェイス) を使用して uvicorn を実行します。
                      それ以外の場合は、127.0.0.1 (localhost) にバインドします。
  -p, --port INTEGER リッスンするポート [デフォルト: 5000]
  --debug デバッグ モードで実行します (開発目的)
  --help このメッセージを表示して終了します。# run server$ eodagserve-rest# ``peps`` で利用可能な製品タイプをリストします。 jq ".collections[].id""S1_SAR_GRD""S1_SAR_OCN""S1_SAR_SLC""S2_MSI_L1C""S2_MSI_L2A"# アイテムを検索$カール"http://127.0.0.1:5000/search?collections=S2_MSI_L1C&bbox=0,43,1,44&datetime=2018-01-20/2018-01-25" | jq ".numberMatched"6# ダウンロード リンクを取得$curl "http://127.0.0.1:5000/collections/S2_MSI_L1C/items" | jq ".features[0].assets.downloadLink.href""http://127.0.0.1:5002/collections/S2_MSI_L1C/items/S2B_MSIL1C_20240917T115259_N0511_R137_T21CWS_20240917T145134/download"# download$ wget "http://127.0.0.1:5002/collections/S2_MSI_L1C/items/S2B_MSIL1C_20240917T115259_N0511_R137_T21CWS_20240917T145134/download"

eodag-server https://hub.docker.com/r/csspace/eodag-server で入手できます。

 docker run -p 5000:5000 --rm csspace/eodag-server:3.0.1

STAC ブラウザを使用して STAC API サーバーを参照することもできます。以下を実行するだけです。

 git clone https://github.com/CS-SI/eodag.gitcd eodag
docker-compose up# またはより詳細なログの場合:EODAG_LOGGING=3 docker-compose up

そして http://127.0.0.1:5001 を参照します。

詳細については、「STAC REST API の使用法」を参照してください。

コマンドラインインターフェース

CLI で遊んでみましょう。

一部の製品を検索するには:
```
 eodag 検索 --productType S2_MSI_L1C --box 1 43 2 44 --start 2021-03-01 --end 2021-03-31
```
上記のリクエストは、2021 年 3 月に、指定された境界ボックスでS2_MSI_L1C製品タイプを検索します。結果は GeoJSON ファイル (デフォルトではsearch_results.geojson ) に保存されます。
結果はページ分割されます。 --allを使用してすべてのページを一度に取得するか、 --cloudCover 20を使用して最大カバー率の 20% を持つ製品を検索することができます。利用可能なオプションの詳細については、次を参照してください。
```
 eodag 検索 --ヘルプ
```
前回の検索呼び出しの結果をダウンロードするには:
```
 eodag ダウンロード --search-results search_results.geojson
```
前回の検索呼び出しの結果クイックルックのみをダウンロードするには、次のようにします。
```
 eodag ダウンロード --quicklooks --search-results search_results.geojson
```
利用可能なすべての製品タイプとサポートされているプロバイダーをリストするには:
```
エオダグリスト
```
指定したサポートされているプロバイダーで利用可能な製品タイプをリストするには:
```
 eodag リスト -p クレオディアス
```
利用可能なすべてのオプションとコマンドを表示するには:
```
 eodag --ヘルプ
```
ログメッセージを出力するには、eodag マスターコマンドに-v追加します。たとえば、 eodag -v list 。指定するvが大きいほど (最大 3 まで)、ツールはより詳細になります。完全な詳細出力の場合は、たとえば次のように実行します: eodag -vvv list