ui.Chart.image.series

Generates a Chart from an ImageCollection. Plots derived values of each band in a region across images. Usually a time series.

  - X-axis: Image, labeled by xProperty value.

  - Y-axis: Band value.

  - Series: Band names.

Returns a chart.

UsageReturns
ui.Chart.image.series(imageCollection, region, reducer, scale, xProperty)ui.Chart
ArgumentTypeDetails
imageCollectionImageCollectionAn ImageCollection with data to be included in the chart.
regionFeature|FeatureCollection|GeometryThe region to reduce.
reducerReducer, optionalReducer that generates the values for the y-axis. Must return a single value. Defaults to ee.Reducer.mean().
scaleNumber, optionalScale to use with the reducer in meters.
xPropertyString, optionalProperty to be used as the label for each image on the x-axis. Defaults to 'system:time_start'.

Examples

Code Editor (JavaScript)

// Define a region of pixels to reduce and chart a time series for.
var region = ee.Geometry.BBox(-121.916, 37.130, -121.844, 37.076);

// Define an image collection time series to chart, MODIS vegetation indices
// in this case.
var imgCol = ee.ImageCollection('MODIS/006/MOD13A1')
  .filter(ee.Filter.date('2015-01-01', '2020-01-01'))
  .select(['NDVI', 'EVI']);

// Define the chart and print it to the console.
var chart = ui.Chart.image.series({
  imageCollection: imgCol,
  region: region,
  reducer: ee.Reducer.mean(),
  scale: 500,
  xProperty: 'system:time_start'
})
.setSeriesNames(['EVI', 'NDVI'])
.setOptions({
  title: 'Average Vegetation Index Value by Date',
  hAxis: {title: 'Date', titleTextStyle: {italic: false, bold: true}},
  vAxis: {
    title: 'Vegetation index (x1e4)',
    titleTextStyle: {italic: false, bold: true}
  },
  lineWidth: 5,
  colors: ['e37d05', '1d6b99'],
  curveType: 'function'
});
print(chart);