ui.Chart.image.series

AI-generated Key Takeaways

• The ui.Chart.image.series function generates a chart from an ImageCollection, plotting derived values of each band in a specified region across images.

• This function is typically used to create time series charts where the x-axis represents the image (often labeled by a property like time), the y-axis represents band values, and different series represent different band names.

• The function takes arguments including the imageCollection, region, optional reducer, scale, and xProperty.

• It returns a ui.Chart object which can be printed or further customized.

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.

Usage	Returns
ui.Chart.image.series(imageCollection, region, reducer, scale, xProperty)	ui.Chart

Argument	Type	Details
imageCollection	ImageCollection	An ImageCollection with data to be included in the chart.
region	Feature|FeatureCollection|Geometry	The region to reduce.
reducer	Reducer, optional	Reducer that generates the values for the y-axis. Must return a single value. Defaults to ee.Reducer.mean().
scale	Number, optional	Scale to use with the reducer in meters.
xProperty	String, optional	Property 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);