Berechnungen mit Bildern

Nachdem Sie nun wissen, wie Sie ein Bild laden und anzeigen, können Sie eine Berechnung darauf anwenden. Sie können beispielsweise die Neigung des Geländes berechnen, indem Sie das SRTM-Höhenbild an die Methode slope des Pakets ee.Terrain übergeben.

Code-Editor (JavaScript)

// Load the SRTM image.
var srtm = ee.Image('CGIAR/SRTM90_V4');

// Apply an algorithm to an image.
var slope = ee.Terrain.slope(srtm);

// Display the result.
Map.setCenter(-112.8598, 36.2841, 9); // Center on the Grand Canyon.
Map.addLayer(slope, {min: 0, max :60}, 'slope');

Beachten Sie, dass im Code ee.Terrain.slope(srtm) das Bild srtm als Argument für den Algorithmus zur Berechnung der Neigung angegeben wird. Das Ergebnis sollte ungefähr so aussehen wie in Abbildung 3.

Tutorial_api_03_slope.png
Abbildung 3. Bild mit geneigten Armlehnen

Bildmathematik

In der Klasse ee.Image gibt es auch Methoden, die für ein Bildobjekt aufgerufen werden können. Angenommen, Sie möchten Berechnungen mit Bildbändern durchführen (manchmal auch als Bandberechnung oder Kartenalgebra bezeichnet). Beispielsweise könnten Sie an trigonometrischen Vorgängen für ein Bild mit einem bestimmten Seitenverhältnis interessiert sein. Konvertieren Sie dazu zuerst ein Bild der Ausrichtung in Radiant und rufen Sie dann sin() dafür auf. Wir verwenden das Image srtm wieder,

Code-Editor (JavaScript)

// Get the aspect (in degrees).
var aspect = ee.Terrain.aspect(srtm);

// Convert to radians, compute the sin of the aspect.
var sinImage = aspect.divide(180).multiply(Math.PI).sin();

// Display the result.
Map.addLayer(sinImage, {min: -1, max: 1}, 'sin');

Das Ergebnis sollte ungefähr so aussehen wie in Abbildung 4. Es lohnt sich, den aspect.divide(180).multiply(Math.PI).sin()-Code genauer anzusehen. Durch die Verkettung mehrerer Methoden wie dieser wird im Code Folgendes angegeben: „Teile den Aspekt durch 180, multipliziere das Ergebnis mit π und berechne schließlich den Sinus.“ Wenn Sie Methoden auf diese Weise kombinieren, können Sie komplexe mathematische Operationen für Bilder ausführen. Eine vollständige Liste der mathematischen Operationen, add(), subtract(), multiply() usw. finden Sie in der Image-Dokumentation.

Tutorial_api_04_sin.png
Abbildung 4. Sinus des Geländeaspekts.

Bildstatistiken

Eine weitere nützliche Klasse von Vorgängen für Bilder ist die Berechnung von Pixelstatistiken in Bildbereichen oder Raster-Vektor-Overlays. Wenn Sie Statistiken in Earth Engine berechnen möchten, verwenden Sie einen Reducer, der durch Klassen im Paket ee.Reducer dargestellt wird. Angenommen, Sie interessieren sich für die durchschnittliche Höhe in einer bestimmten Region. Sie können eine Region definieren, indem Sie mit den Zeichentools für Geometrie ein Polygon zeichnen. Wenn Sie eine Region interaktiv zeichnen möchten, rufen Sie das Polygon-Zeichentool () auf, digitalisieren Sie ein Polygon über dem gewünschten Bereich und klicken Sie auf Beenden, wenn Sie fertig sind. Das resultierende ee.Geometry-Objekt wird automatisch geometry genannt und oben im Skript als Import hinzugefügt. Benennen Sie diese Variable in „polygon“ um, indem Sie in den Importen auf den Variablennamen klicken und den neuen Namen eingeben.

Rufen Sie als Nächstes mit dem folgenden Code den durchschnittlichen Pixelwert im Polygon ab:

Code-Editor (JavaScript)

// Compute the mean elevation in the polygon.
var meanDict = srtm.reduceRegion({
  reducer: ee.Reducer.mean(),
  geometry: polygon,
  scale: 90
});

// Get the mean from the dictionary and print it.
var mean = meanDict.get('elevation');
print('Mean elevation', mean);

Hier gibt es einige Dinge zu beachten. Beachten Sie zuerst, dass reduceRegion() eine Methode ist, die für Image-Objekte verfügbar ist. Weitere Informationen zum Reduzieren von Regionen Zweitens werden die Methodenargumente in einem JavaScript-Objekt bereitgestellt, das als einzelnes Argument übergeben wird. (Die Schlüssel des Objekts sind die Namen der Methodenparameter. Die Werte sind die Argumente für die Methode. Drittens gibt der Parameter reducer den Typ der zu berechnenden Statistik an und der Parameter geometry die Region, in der die Statistik berechnet werden soll. Der Parameter scale ist die zu verwendende Pixelgröße in Metern. Um Unklarheiten zu vermeiden, sollten Sie bei Reduzierungen immer den Maßstab angeben, da die Earth Engine den geeigneten Maßstab möglicherweise nicht automatisch aus den Eingaben ermitteln kann. (Weitere Informationen zum Maßstab in Earth Engine)

Der Rückgabewert von reduceRegion() ist ein Dictionary, in dem die Schlüssel Bandnamen und die Werte die Pixelstatistiken für die Bänder sind. Die Methode get() für ein Dictionary gibt den Wert zurück, der dem als Argument angegebenen Schlüssel entspricht. In diesem Fall hat das Bild srtm ein Band, „elevation“. Der Beispielcode ruft diese Statistik also aus dem Wörterbuch ab und gibt sie aus.

Wenn Sie diesen Code ausführen und eine Fehlermeldung wie die folgende erhalten:

Mach dir deshalb keine Gedanken! Es gibt mehrere Möglichkeiten, den Fehler zu beheben. Die Methode reduceRegion() prüft, ob Sie wirklich so viele Pixel in Ihre Berechnung einbeziehen möchten. So soll verhindert werden, dass Sie versehentlich etwas Unüberlegtes tun, z. B. versuchen, den Mittelwert jedes 1-Meter-Pixels weltweit zu berechnen (tun Sie das nicht). Um den Fehler zu beheben, setzen Sie entweder den Parameter bestEffort auf true, indem Sie dem Parameter-Dictionary bestEffort: true hinzufügen, oder setzen Sie den Parameter maxPixels auf einen Wert, der höher als der Standardwert von 10 Millionen Pixeln ist, oder beides. Wenn bestEffort „true“ ist, berechnet Earth Engine den Maßstab automatisch neu, sodass maxPixels nicht überschritten wird.

Exkurs: Maßstab in der Earth Engine

Im vorherigen Beispiel ist scale auf ungefähr die native Auflösung des SRTM-Bildes festgelegt. So finden Sie die native Auflösung eines Bildes heraus:

Code-Editor (JavaScript)

var scale = srtm.projection().nominalScale();
print('SRTM scale in meters', scale);

Wenn Sie einen kleineren Maßstab als die native Auflösung angeben, wird das Eingabebild in Earth Engine mit dem Nearest-Neighbor-Verfahren neu abgetastet und alle kleineren Pixel werden in die Berechnung einbezogen. Wenn Sie den Maßstab vergrößern, verwendet Earth Engine Eingabepixel aus einer aggregierten Version der Eingabe, d.h., es werden Pixel aus einer höheren Ebene der Bildpyramide abgerufen. Weitere Informationen dazu, wie die Earth Engine mit der Skalierung umgeht, finden Sie in diesem Dokument.

Bisher haben Sie mit einem einzelnen Bild mit einem einzelnen Band gearbeitet. Auf der nächsten Seite erfahren Sie mehr über Multiband-Bilder und Bildersammlungen.