Earth Engine ist so konzipiert, dass Sie sich bei Berechnungen selten Gedanken über Kartenprojektionen machen müssen. Wie beim Maßstab wird die Projektion, in der Berechnungen stattfinden, auf „Pull“-Basis bestimmt. Insbesondere werden Eingaben in der Ausgabeprojektion angefordert. Die Ausgabe kann über einen Funktionsparameter (z.B. crs), Code-Editor- und geemap-Kartenobjekte (mit einer Maps-Mercator-Projektion (EPSG:3857)) oder mit einem reproject()-Aufruf bestimmt werden. Wenn Sie Bilder im Code-Editor oder in geemap anzeigen, werden Eingaben in Maps Mercator angefordert. Betrachten Sie den folgenden Vorgang für ein MODIS-Bild mit einer sinusförmigen Projektion:
Code-Editor (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
Die Reihenfolge der Vorgänge für dieses Codebeispiel ist in Abbildung 1 dargestellt. Beachten Sie, dass die Projektion der Eingabe durch die Ausgabe bestimmt wird, insbesondere durch die Maps Mercator-Projektion der Kartendarstellung im Code-Editor. Diese Projektion wird durch die Abfolge der Vorgänge zurückgegeben, sodass die Eingaben in Maps Mercator in einem Maßstab angefordert werden, der durch die Zoomstufe der Karte bestimmt wird.
In Earth Engine werden Projektionen durch ein Koordinatenreferenzsystem (CRS oder den Parameter crs vieler Methoden) angegeben. Sie können die Projektion eines Bildes prüfen, indem Sie projection() dafür aufrufen:
Code-Editor (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())
Wenn Sie nominalScale() für das von projection() zurückgegebene ee.Projection aufrufen, können Sie die native Auflösung des Bildes ermitteln. Die native Auflösung ist der nominale Pixelmaßstab in Metern der niedrigsten Ebene der Bildpyramide. Da jedes Band eines Bildes einen anderen Maßstab und/oder eine andere Projektion haben kann, wird möglicherweise ein Fehler wie der folgende angezeigt, wenn Sie projection() für ein Bild mit mindestens einem Band aufrufen, das nicht dieselbe Projektion wie die anderen hat:
Die Standardprojektion
Sofern Ihre Berechnung nicht in einer bestimmten Projektion erfolgen muss, ist es im Allgemeinen nicht erforderlich, eine Projektion anzugeben. Nur bei mehrdeutigen Ausgaben müssen Sie in Earth Engine eine Projektion und/oder einen Maßstab angeben. Mehrdeutigkeiten können entstehen, wenn ein ImageCollection mit Bildern mit unterschiedlichen Projektionen reduziert wird (d.h. ein zusammengesetztes Bild erstellt wird). Ein Bild, das ein Mosaik aus Eingabebildern mit unterschiedlichen Projektionen ist, hat die Standardprojektion WGS84 mit einem Maßstab von 1 Grad.
Wenn diese Standardprojektion für Ihre Analyse nicht geeignet ist (z.B. weil sie zu grob ist oder Sie Resampling-Artefakte in nachfolgenden Berechnungen wie der Geländeanalyse verhindern müssen), können Sie mit image.setDefaultProjection(crs) eine andere Standardprojektion festlegen. So wird sichergestellt, dass Earth Engine, wenn für eine Berechnung mit dem Bild eine Projektion ausgewählt werden muss, die angegebene Projektion und nicht WGS84 im Maßstab von 1 Grad verwendet.
Beispiel:
Code-Editor (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())
Wenn Sie versuchen, ein solches Bild in einer Berechnung zu verwenden, wird möglicherweise ein Fehler wie der folgende angezeigt:
Im Allgemeinen ist eine Aggregation im Maßstab von 1 Grad nicht erwünscht oder beabsichtigt. Daher gibt Earth Engine diese freundliche Erinnerung aus, um eine vollständige Spezifikation für die Ausgabe zu erhalten.
Nutzer finden dieses Verhalten oft verwirrend und machen sich Sorgen um die „verlorenen“ Projektionsinformationen. Die Pixel werden jedoch erst berechnet, wenn sie benötigt werden (weitere Informationen). Zu diesem Zeitpunkt gibt es immer eine Ausgabeprojektion, die die Anfrage begleitet und angibt, wie das Komposit berechnet werden soll.
In den allermeisten Anwendungsfällen ist das Fehlen einer Projektion kein Problem, sondern sogar eine wertvolle Optimierung, da die Ergebnisse auf jeder Zoomstufe als Vorschau angezeigt werden können, ohne dass die Berechnung der vollen Auflösung abgeschlossen sein muss. Das bedeutet jedoch, dass die Ausgabe bei verschiedenen Zoomstufen unterschiedlich aussehen kann.
Wenn das optimierte Anzeigebild nicht ausreicht, kann die Berechnung in einer bestimmten Projektion erzwungen werden, indem die Ausgabe wie im folgenden Abschnitt beschrieben neu projiziert wird.
Reproject
Mit der Methode reproject() können Sie erzwingen, dass Vorgänge in einer bestimmten Projektion ausgeführt werden. Wenn Sie reproject() verwenden, werden die Eingaben in der Projektion angefordert, die im reproject()-Aufruf angegeben ist.
Berechnungen in Ihrem Code vor dem Aufruf von reproject() werden in der angegebenen Projektion ausgeführt. So können Sie beispielsweise erzwingen, dass ein Komposit in einer bestimmten Projektion erstellt wird:
Code-Editor (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)
In einigen Fällen ist eine feste Projektion erforderlich, z. B.:
- Berechnung von Gradienten (z. B.
ee.Terrain.gradientoderee.Terrain.slope) reduceResolution, wenn Sie Pixel mit höherer Auflösung in Pixel mit niedrigerer Auflösung zusammenfassen möchten. (Weitere Informationen zum Reduzieren der Auflösung)
Funktionen im Paket ee.Terrain (z.B. slope, aspect, hillshade) berechnen Werte basierend auf benachbarten Pixeln und reagieren empfindlich auf Resampling-Artefakte, die während der Reprojektion entstehen. Wenn die Projektion der Berechnung von der nativen Projektion des DEM abweicht, kann das standardmäßige Resampling nach dem Nearest-Neighbor-Verfahren künstliche Muster in der Ausgabe erzeugen. Die besten Ergebnisse erzielen Sie, wenn Sie die Geländeanalyse in der nativen Projektion des DEM durchführen. Wenn Sie mit einem ImageCollection von DEM-Kacheln arbeiten, erstellen Sie ein Mosaik und verwenden Sie setDefaultProjection() mit der nativen Projektion der Sammlung, damit die Analyse im richtigen Raster ausgeführt wird, wie im Abschnitt Standardprojektion beschrieben.
Es gibt mehrere Gründe, warum Sie reproject() nur verwenden sollten, wenn es unbedingt erforderlich ist. Angenommen, Sie projizieren ein Element neu und fügen es der Karte hinzu. Wenn der im reproject()-Aufruf angegebene Maßstab viel kleiner ist als die Zoomstufe der Karte, fordert Earth Engine alle Eingaben in einem sehr kleinen Maßstab über einen sehr großen räumlichen Bereich an. Dies kann dazu führen, dass zu viele Daten auf einmal angefordert werden, was zu einem Fehler führt.
Wenn die endgültige Ausgabe in einer anderen Projektion als der im reproject()-Aufruf angegebenen erfolgt, führt dies zu einer weiteren Umprojektion. Dies ist ein weiterer Grund, warum Sie reproject() in Ihrem Code mit Vorsicht verwenden sollten. Im folgenden Beispiel wird das MODIS-Bild zuerst in WGS84 und dann in Maps Mercator umprojiziert, um es auf der Karte im Code-Editor anzuzeigen:
Code-Editor (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
Abbildung 2 zeigt den Ablauf der Vorgänge für dieses einfache Beispiel einer Reprojektion. Die erste Reprojektion ist explizit, wie im Aufruf von reproject() angegeben. Die zweite Reprojektion erfolgt implizit und wird von Earth Engine automatisch durchgeführt, um das Ergebnis auf der Karte anzuzeigen. Beachten Sie auch, dass die Informationen darüber, welche Projektion verwendet werden soll, von der Anfrage zurück zur Eingabe weitergegeben werden.