Mapowanie na zbiorze ImageCollection

Aby zastosować funkcję do każdego Image w użyciu w funkcji ImageCollection:imageCollection.map(). Jedynym argumentem funkcji map() jest funkcja, która przyjmuje jeden parametr: ee.Image. Na przykład ten kod dodaje pasek z oznaczeniem czasowym do każdego obrazu w kolekcji.

Edytor kodu (JavaScript)

// Load a Landsat 8 collection for a single path-row, 2021 images only.
var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')
  .filterDate('2021', '2022')
  .filter(ee.Filter.eq('WRS_PATH', 44))
  .filter(ee.Filter.eq('WRS_ROW', 34));

// This function adds a band representing the image timestamp.
var addTime = function(image) {
  return image.addBands(image.getNumber('system:time_start'));
};

// Map the function over the collection and display the result.
print(collection.map(addTime));

Konfiguracja Pythona

Informacje o interfejsie Python API i o używaniu pakietu geemap do programowania interaktywnego znajdziesz na stronie Python Environment.

import ee
import geemap.core as geemap

Colab (Python)

# Load a Landsat 8 collection for a single path-row, 2021 images only.
collection = (
    ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')
    .filterDate('2021', '2022')
    .filter(ee.Filter.eq('WRS_PATH', 44))
    .filter(ee.Filter.eq('WRS_ROW', 34))
)


# This function adds a band representing the image timestamp.
def add_time(image):
  return image.addBands(image.getNumber('system:time_start'))


# Map the function over the collection and display the result.
display(collection.map(add_time))

Pamiętaj, że w zdefiniowanej funkcji metoda getNumber() służy do tworzenia nowej wartości Image na podstawie wartości numerycznej właściwości. Jak wspomniano w sekcjach Zmniejsz i Kompozycja, pasmo czasowe jest przydatne do modelowania liniowego zmian i tworzenia kompozycji.

Funkcja mapowania ma ograniczone możliwości wykonywania operacji. W szczególności nie może modyfikować zmiennych poza funkcją, drukować niczego ani używać instrukcji if w JavaScript i for w Pythonie. Możesz jednak używać funkcji ee.Algorithms.If() do wykonywania operacji warunkowych w zmapowanej funkcji. Na przykład:

Edytor kodu (JavaScript)

// Load a Landsat 8 collection for a single path-row, 2021 images only.
var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')
  .filterDate('2021', '2022')
  .filter(ee.Filter.eq('WRS_PATH', 44))
  .filter(ee.Filter.eq('WRS_ROW', 34));

// This function uses a conditional statement to return the image if
// the solar elevation > 40 degrees. Otherwise it returns a "zero image".
var conditional = function(image) {
  return ee.Algorithms.If(ee.Number(image.get('SUN_ELEVATION')).gt(40),
                          image,
                          ee.Image(0));
};

// Map the function over the collection and print the result. Expand the
// collection and note that 7 of the 22 images are now "zero images'.
print('Expand this to see the result', collection.map(conditional));

Konfiguracja Pythona

Informacje o interfejsie Python API i o używaniu pakietu geemap do programowania interaktywnego znajdziesz na stronie Python Environment.

import ee
import geemap.core as geemap

Colab (Python)

# Load a Landsat 8 collection for a single path-row, 2021 images only.
collection = (
    ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')
    .filterDate('2021', '2022')
    .filter(ee.Filter.eq('WRS_PATH', 44))
    .filter(ee.Filter.eq('WRS_ROW', 34))
)


# This function uses a conditional statement to return the image if
# the solar elevation > 40 degrees. Otherwise it returns a "zero image".
def conditional(image):
  return ee.Algorithms.If(
      ee.Number(image.get('SUN_ELEVATION')).gt(40), image, ee.Image(0)
  )


# Map the function over the collection and print the result. Expand the
# collection and note that 7 of the 22 images are now "zero images'.
display('Expand this to see the result', collection.map(conditional))

Sprawdź listę obrazów w wyjściowym zbiorze obrazów ImageCollection i zwróć uwagę, że gdy warunek oceniany przez algorytm If() jest spełniony, wyjście zawiera stały obraz. Chociaż przykład dotyczy funkcji warunkowej po stronie serwera (więcej informacji o działaniu po stronie klienta i serwera w Earth Engine), na ogół należy unikać funkcji If() i zamiast tego używać filtrów.