Obliczenia z użyciem obrazów

Teraz, gdy wiesz już, jak wczytać i wyświetlić obraz, czas zastosować do niego obliczenia. Możesz na przykład obliczyć nachylenie terenu, przekazując obraz wysokościowy SRTM do metody slope pakietu ee.Terrain.

Edytor kodu (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');

Zwróć uwagę, że w kodzie ee.Terrain.slope(srtm) obraz srtm jest podany jako argument algorytmu nachylenia. Wynik powinien wyglądać mniej więcej tak jak na rysunku 3.

Tutorial_api_03_slope.png
Rysunek 3. Obraz nachylenia.

Matematyka na obrazach

W klasie ee.Image są też metody, które można wywołać na obiekcie obrazu. Załóżmy na przykład, że chcesz wykonać pewne obliczenia matematyczne przy użyciu pasm obrazu (czasami nazywane obliczeniami na pasmach lub algebrą map). Możesz na przykład wykonać operacje trygonometryczne na obrazie ekspozycji. Aby to zrobić, najpierw przekonwertuj obraz ekspozycji na radiany, a następnie wywołaj na nim funkcję sin(). Wykorzystanie naszego obrazu srtm,

Edytor kodu (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');

Wynik powinien wyglądać mniej więcej tak jak na rysunku 4. Warto przyjrzeć się bliżej kodowi aspect.divide(180).multiply(Math.PI).sin(). Połączenie kilku metod w ten sposób oznacza, że kod „dzieli aspekt przez 180, mnoży wynik przez π i na koniec oblicza sinus”. Łącząc metody w ten sposób, możesz wykonywać na obrazach złożone operacje matematyczne. Pełną listę operacji matematycznych, takich jak add(), subtract(), multiply(), znajdziesz w dokumentacji Image.

Tutorial_api_04_sin.png
Rysunek 4. Sinus aspektu terenu.

Statystyki obrazu

Inna przydatna klasa operacji na obrazach obejmuje obliczanie statystyk pikseli w regionach obrazu lub nakładkach rastrowo-wektorowych. Aby obliczyć statystyki w Earth Engine, użyj reduktora reprezentowanego przez klasy w pakiecie ee.Reducer. Załóżmy na przykład, że interesuje Cię średnia wysokość w danym regionie. Region możesz zdefiniować, rysując wielokąt za pomocą narzędzi do rysowania geometrii. Aby interaktywnie narysować region, wybierz narzędzie do rysowania wielokątów (), a następnie narysuj wielokąt nad interesującym Cię obszarem i kliknij Zakończ. Zwróć uwagę, że wynikowy obiekt ee.Geometry automatycznie otrzymuje nazwę geometry i jest dodawany jako import u góry skryptu. Zmień nazwę tej zmiennej na „polygon”, klikając nazwę zmiennej w importach i wpisując nową nazwę.

Następnie uzyskaj średnią wartość piksela w wielokącie, używając tego kodu:

Edytor kodu (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);

Warto zwrócić uwagę na kilka kwestii. Po pierwsze, zauważ, że reduceRegion() to metoda dostępna dla obiektów Image (więcej informacji o redukowaniu regionów znajdziesz tutaj). Po drugie, argumenty metody są podawane w obiekcie w JavaScripcie, który jest przekazywany jako pojedynczy argument. (klucze obiektu to nazwy parametrów metody. Wartości to argumenty metody). Po trzecie, parametr reducer określa typ statystyki do obliczenia, a parametr geometry określa region, w którym statystyka ma zostać obliczona. Parametr scale to rozmiar piksela w metrach. Aby uniknąć niejednoznaczności, zawsze określaj skalę podczas redukcji, ponieważ Earth Engine może nie być w stanie automatycznie określić odpowiedniej skali na podstawie danych wejściowych. (więcej informacji o skali w Earth Engine).

Ostatnia wartość zwracana przez funkcję reduceRegion() to słownik, w którym kluczami są nazwy pasm, a wartościami statystyki pikseli dla pasm. Metoda get() w słowniku zwraca wartość odpowiadającą kluczowi podanemu jako argument. W tym przypadku obraz srtm ma 1 pasmo, „wysokość”, więc przykładowy kod pobiera tę statystykę ze słownika i ją wyświetla.

Jeśli po uruchomieniu tego kodu pojawi się błąd podobny do tego:

Nie martw się. Aby rozwiązać ten problem, możesz wykonać kilka czynności. Metoda reduceRegion() sprawdza, czy na pewno chcesz uwzględnić w obliczeniach tak wiele pikseli. Ma to zapobiec przypadkowemu wykonaniu nieprzemyślanej czynności, takiej jak próba obliczenia średniej dla każdego piksela o boku 1 metra na świecie (nie rób tego). Aby rozwiązać ten problem, ustaw parametr bestEffort na true, dodając bestEffort: true do słownika parametrów, lub ustaw parametr maxPixels na wartość wyższą niż domyślna, czyli 10 mln pikseli, albo wykonaj obie te czynności. Jeśli bestEffort ma wartość true, Earth Engine automatycznie ponownie obliczy skalę, aby nie przekroczyć maxPixels.

Dygresja: skala w Earth Engine

W poprzednim przykładzie parametr scale jest ustawiony na wartość zbliżoną do natywnej rozdzielczości obrazu SRTM. Rozdzielczość natywną obrazu możesz sprawdzić za pomocą:

Edytor kodu (JavaScript)

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

Jeśli określisz skalę mniejszą niż rozdzielczość natywna, Earth Engine ponownie spróbkuje obraz wejściowy, używając najbliższego sąsiada, a następnie uwzględni wszystkie te mniejsze piksele w obliczeniach. Jeśli ustawisz większą skalę, Earth Engine będzie używać pikseli wejściowych z zagregowanej wersji danych wejściowych (czyli pobierać piksele z wyższego poziomu piramidy obrazu). Więcej informacji o tym, jak Earth Engine obsługuje skalę, znajdziesz w tym dokumencie.

Do tej pory pracowaliśmy z jednym obrazem z jednym pasmem. Na następnej stronie dowiesz się więcej o obrazach wielopasmowych i kolekcjach obrazów.