Earth Engine は、計算時に地図の投影法について心配する必要がほとんどないように設計されています。スケールと同様に、計算が行われる投影は「プル」ベースで決定されます。具体的には、出力プロジェクションで入力がリクエストされます。出力は、関数パラメータ(crs など)、コードエディタと geemap マップ オブジェクト(マップ メルカトル(EPSG:3857)投影法を使用)、または reproject() 呼び出しによって決定されます。コードエディタまたは geemap で画像を表示すると、入力はメルカトル図法でリクエストされます。正弦波投影の MODIS 画像に対する次のオペレーションを考えてみましょう。
コードエディタ(JavaScript)
// The input image has a SR-ORG:6974 (sinusoidal) projection. var image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0); // Normalize the image and add it to the map. var rescaled = image.unitScale(-2000, 10000); var visParams = {min: 0.15, max: 0.7}; Map.addLayer(rescaled, visParams, 'Rescaled');
import ee import geemap.core as geemap
Colab(Python)
# The input image has a SR-ORG:6974 (sinusoidal) projection. image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0) # Normalize the image and add it to the map. rescaled = image.unitScale(-2000, 10000) vis_params = {'min': 0.15, 'max': 0.7} m = geemap.Map() m.add_layer(rescaled, vis_params, 'Rescaled') m
このコードサンプルのオペレーションの順序を図 1 に示します。入力の投影は出力によって決まります。具体的には、コードエディタの地図表示の地図メルカトル投影です。この投影は、一連のオペレーションを通じて逆方向に伝播され、地図のズームレベルによって決定される縮尺で、入力がメルカトル図法でリクエストされます。
Earth Engine では、投影は座標参照系(CRS または多くのメソッドの crs パラメータ)によって指定されます。画像の投影を確認するには、画像に対して projection() を呼び出します。
コードエディタ(JavaScript)
var image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select(0); print('Projection, crs, and crs_transform:', image.projection()); print('Scale in meters:', image.projection().nominalScale());
import ee import geemap.core as geemap
Colab(Python)
image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select(0) display('Projection, crs, and crs_transform:', image.projection()) display('Scale in meters:', image.projection().nominalScale())
projection() から返された ee.Projection で nominalScale() を呼び出すと、画像のネイティブ解像度を特定できます。ネイティブ解像度は、画像ピラミッドの最下位レベルの公称ピクセル スケール(メートル単位)です。画像の各バンドは異なるスケールや投影を持つことができるため、他のバンドと同じ投影を持たないバンドが少なくとも 1 つある画像で projection() を呼び出すと、次のようなエラーが表示されることがあります。
デフォルトの投影
特定の投影で計算を行う必要がある場合を除き、通常は投影を指定する必要はありません。出力が曖昧な場合にのみ、Earth Engine で投影法やスケールを指定する必要があります。異なる投影法の画像を含む ImageCollection コンテナ イメージ を縮小する(コンポジットを作成する)と、曖昧さが生じる可能性があります。異なる投影法の入力画像を合成またはモザイク化した画像には、デフォルトの投影法(1 度のスケールの WGS84)が適用されます。このデフォルトの投影法が分析に適していない場合(粗すぎる場合や、地形分析などの下流の計算でリサンプリング アーティファクトを防ぐ必要がある場合など)は、image.setDefaultProjection(crs) を使用して別のデフォルトを設定できます。これにより、Earth Engine が画像を含む計算の投影を選択する必要がある場合、1 度スケールの WGS84 ではなく、指定された投影が使用されます。次に例を示します。
コードエディタ(JavaScript)
var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA'); var mosaic = collection.filterDate('2018-01-01', '2019-01-01').mosaic(); print(mosaic.projection());
import ee import geemap.core as geemap
Colab(Python)
collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA') mosaic = collection.filterDate('2018-01-01', '2019-01-01').mosaic() display(mosaic.projection())
このような画像を計算で使用しようとすると、次のようなエラーが表示されることがあります。
一般に、1 度のスケールでの集計は望ましくないか、意図されていないため、Earth Engine は、出力の完全な仕様を提供するように、この親切なリマインダーを提供します。
この動作はユーザーを混乱させることが多く、「失われた」投影情報について心配することがありますが、ピクセルは必要になるまで実際には計算されません(詳細)。その時点で、コンポジットの計算方法を指定したリクエストに付随する出力投影が常に存在します。
ほとんどのユースケースでは、投影がないことは問題ではなく、実際には貴重な最適化です。これにより、完全な解像度の計算が完了するのを待つことなく、任意のズームレベルで結果をプレビューできます。ただし、ズームレベルによって出力が異なる場合があります。
最適化された表示画像が不十分な場合は、次のセクションで説明するように、出力を再投影することで、特定の投影で計算を強制できます。
再投影
reproject() メソッドを使用すると、特定の投影でオペレーションを強制的に実行できます。reproject() を使用すると、reproject() 呼び出しで指定された投影で入力がリクエストされます。reproject() 呼び出しの前のコード内の計算は、指定された投影法で行われます。たとえば、特定の投影でコンポジットを強制的に生成するには、次のようにします。
コードエディタ(JavaScript)
// Some projection that is suitable for your area of interest. var proj = ee.Projection(...); var output = collection.reduce(...).reproject(proj);
import ee import geemap.core as geemap
Colab(Python)
# Some projection that is suitable for your area of interest. proj = ee.Projection(...) output = collection.reduce(...).reproject(proj)
固定投影が必要なケースには、次のようなものがあります。
- 勾配の計算(
ee.Terrain.gradient、ee.Terrain.slopeなど)。 reduceResolution。高解像度のピクセルを低解像度に集約する場合に使用します。(解像度の低減の詳細)。
ee.Terrain パッケージの関数(slope、aspect、hillshade など)は、隣接するピクセルに基づいて値を計算し、再投影中に発生するリサンプリング アーティファクトの影響を受けやすくなります。計算の投影が DEM のネイティブ投影と異なる場合、デフォルトの最近傍リサンプリングによって、出力に人工的なパターンが作成されることがあります。最適な結果を得るには、DEM のネイティブ投影で地形分析を行います。DEM タイルの ImageCollection を使用する場合は、モザイクを作成し、コレクションのネイティブ投影で setDefaultProjection() を使用して、デフォルトの投影セクションで説明されているように、分析が正しいグリッドで実行されるようにします。
どうしても必要な場合を除き、reproject() の使用を避けるべき理由はいくつかあります。たとえば、再投影したものを地図に追加するとします。reproject() 呼び出しで指定したスケールが地図のズームレベルよりもはるかに小さい場合、Earth Engine は非常に広い空間範囲にわたって、非常に小さいスケールですべての入力をリクエストします。これにより、一度に大量のデータがリクエストされ、エラーが発生する可能性があります。
最終的な出力が reproject() 呼び出しで指定されたものとは異なる投影法である場合、別の再投影が発生します。これは、コードで reproject() を使用する際に注意が必要なもう一つの理由です。次の例では、MODIS 画像を最初に WGS84 に再投影し、次にマップ メルカトルに再投影して、コードエディタ マップに表示します。
コードエディタ(JavaScript)
// The input image has a SR-ORG:6974 (sinusoidal) projection. var image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0); // Operations *before* the reproject call will be done in the projection // specified by reproject(). The output results in another reprojection. var reprojected = image .unitScale(-2000, 10000) .reproject('EPSG:4326', null, 500); Map.addLayer(reprojected, {min: 0.15, max: 0.7}, 'Reprojected');
import ee import geemap.core as geemap
Colab(Python)
# The input image has a SR-ORG:6974 (sinusoidal) projection. image = ee.Image('MODIS/061/MOD13A1/2014_05_09').select(0) # Operations *before* the reproject call will be done in the projection # specified by reproject(). The output results in another reprojection. reprojected = image.unitScale(-2000, 10000).reproject('EPSG:4326', None, 500) m = geemap.Map() m.add_layer(reprojected, {'min': 0.15, 'max': 0.7}, 'Reprojected') m
図 2 は、このシンプルな再投影の例に対応するオペレーションのフローを示しています。最初の再投影は、reproject() 呼び出しで指定されているように明示的です。2 回目の再投影は暗黙的に行われ、結果を地図上に表示するために Earth Engine によって自動的に実行されます。また、使用するプロジェクションに関する情報がリクエストから入力に反映されることも確認してください。