ee.FeatureCollection.aggregate_histogram

  • Computes a histogram for a specified property within a FeatureCollection.

  • Returns a dictionary where keys represent property value ranges and values represent the frequency of features within that range.

  • Useful for understanding the distribution of a specific attribute, such as the capacity of power plants in a region.

 Aggregates over a given property of the objects in a collection, calculating a histogram of the selected property.

UsageReturns
FeatureCollection.aggregate_histogram(property)Dictionary
ArgumentTypeDetails
this: collectionFeatureCollectionThe collection to aggregate over.
propertyStringThe property to use from each element of the collection.

Examples

Code Editor (JavaScript)

// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
             .filter('country_lg == "Belgium"');

print('Histogram of power plant capacities (MW)',
      fc.aggregate_histogram('capacitymw'));  // Dictionary

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)

from pprint import pprint

# FeatureCollection of power plants in Belgium.
fc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(
    'country_lg == "Belgium"')

print('Histogram of power plant capacities (MW):')
pprint(fc.aggregate_histogram('capacitymw').getInfo())  # Dictionary