doyByBands#

geetools.ImageCollectionAccessor.doyByBands(region, spatialReducer='mean', timeReducer='mean', dateProperty='system:time_start', bands=None, labels=None, scale=10000, crs=None, crsTransform=None, bestEffort=False, maxPixels=10**7, tileScale=1)#

Aggregate the images that occurs on the same day and then reduce each band on a single region.

This method is returning a dictionary with all the bands as keys and their reduced value for each day over the specified region as value.

{
    "band1": {"doy1": value1, "doy2": value2, ...},
    "band2": {"doy1": value1, "doy2": value2, ...},
    ...
}
Parameters:

  • region (ee.Geometry) – The region to reduce the data on.

  • spatialReducer (str | ee.Reducer) – The name of the reducer or a reducer object to use for spatial reduction. Default is "mean".

  • timeReducer (str | ee.Reducer) – The name of the reducer or a reducer object to use for time reduction. Default is "mean".

  • dateProperty (str) – The property to use as date for each image. Default is "system:time_start".

  • bands (list[str] | None) – The bands to reduce. If empty, all bands are reduced.

  • labels (list[str] | None) – The labels to use for the bands. If empty, the bands names are used.

  • scale (int) – The scale in meters to use for the reduction. default is 10000m

  • crs (str | None) – The projection to work in. If unspecified, the projection of the image’s first band is used. If specified in addition to scale, rescaled to the specified scale.

  • crsTransform (list | None) – The list of CRS transform values. This is a row-major ordering of the 3x2 transform matrix. This option is mutually exclusive with ‘scale’, and replaces any transform already set on the projection.

  • bestEffort (bool) – If the polygon would contain too many pixels at the given scale, compute and use a larger scale which would allow the operation to succeed.

  • maxPixels (int | None) – The maximum number of pixels to reduce. Defaults to 1e7.

  • tileScale (float) – A scaling factor between 0.1 and 16 used to adjust aggregation tile size; setting a larger tileScale (e.g., 2 or 4) uses smaller tiles and may enable computations that run out of memory with the default.

Returns:

A dictionary with the reduced values for each band and each day.

Return type:

ee.Dictionary

See also

  • doyByRegions: Aggregate the images that occurs on the same day and then reduce a single band on multiple regions.

  • doyBySeasons: Aggregate for each year on a single region a single band.

  • doyByYears: Aggregate for each year on a single region a single band.

  • plot_doy_by_bands: Plot the reduced data for each image in the collection by bands on a specific region.

  • plot_doy_by_regions: Plot the reduced data for each image in the collection by regions for a single band.

  • plot_doy_by_seasons: Plot the reduced data for each image in the collection by years for a single band.

  • plot_doy_by_years: Plot the reduced data for each image in the collection by years for a single band.