ee.ImageCollection.filter

  • ImageCollection.filter() allows you to apply a filter to an ImageCollection, resulting in a new collection containing only the images that match the filter criteria.

  • The filter argument accepts a Filter object, such as one created with ee.Filter.eq, to define the filtering conditions.

  • This method is useful for subsetting collections based on properties like date, metadata, or image content.

  • Applying a filter with criteria that no images satisfy will return an empty collection.

Apply a filter to this collection.

Returns the filtered collection.

UsageReturns
ImageCollection.filter(filter)Collection
ArgumentTypeDetails
this: collectionCollectionThe Collection instance.
filterFilterA filter to apply to this collection.

Examples

Code Editor (JavaScript)

// The GOES Mesoscale images come in two domains.
// Separate the two groups using ee.Filter.eq.
var goes17_mcmipm = ee.ImageCollection('NOAA/GOES/17/MCMIPM');
var goes17_mcmipm_day =
    goes17_mcmipm.filterDate('2020-09-26', '2020-09-27');

var d1 = goes17_mcmipm_day.filter('domain == 1');
var d2 = goes17_mcmipm_day.filter('domain == 2');
// domain 3 does not exist.
var d3 = goes17_mcmipm_day.filter('domain == 3');

print(goes17_mcmipm_day.size());
print(d1.size());
print(d2.size());
print(d3.size());

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

# The GOES Mesoscale images come in two domains.
# Separate the two groups using ee.Filter.eq.
goes17_mcmipm = ee.ImageCollection('NOAA/GOES/17/MCMIPM')
goes17_mcmipm_day = goes17_mcmipm.filterDate('2020-09-26', '2020-09-27')

d1 = goes17_mcmipm_day.filter('domain == 1')
d2 = goes17_mcmipm_day.filter('domain == 2')
# domain 3 does not exist.
d3 = goes17_mcmipm_day.filter('domain == 3')

print(goes17_mcmipm_day.size().getInfo())
print(d1.size().getInfo())
print(d2.size().getInfo())
print(d3.size().getInfo())