Learn R Programming

raster (version 1.8-3)

aggregate: Aggregate cells

Description

Aggregate a Raster* object to create a new RasterLayer or RasterBrick with a lower resolution (larger cells). Aggregation groups rectangular areas to create larger cells. The value for the resulting cells is computed with a user-specified function (default value = mean).

Usage

aggregate(x, ...)

Arguments

x
A Raster* object
...
Additional arguments. See under Details

Value

  • RasterLayer or RasterBrick

Details

A full call to the aggregate method for a Raster* object is: aggregate(x, fact=2, fun=mean, expand=TRUE, na.rm=TRUE, filename="", ... ) rll{ x a RasterLayer object fact Integer. Aggregation factor expressed as number of cells in each direction (horizontally and vertically). Or two integers (horizontal and vertical aggregation factor). Default is 2. See below fun Function used to aggregate values (default=mean) expand logical. If TRUE the output RasterLayer will be larger then the input RasterLayer if a division of the number of columns or rows with factor is not an integer na.rm logical. If TRUE, NA cells are removed from calculations filename Character. Output filename ... Additional arguments, see below } Additional arguments: rll{ format Character. Output file type. See writeRaster datatype Character. Output data type. See dataType overwrite Logical. If TRUE, the file will be overwritten if it exists progress Character. "text", "window", or "" (the default, no progress bar) } Aggregation will result in a Raster* object with fact*fact fewer cells; if necessary this number is adjusted according to the value of expand. For example, fact=2 will result in a new Raster* object with 2*2=4 times fewer cells. If two numbers are supplied, e.g., fact=c(2,3), the first will be used for aggregating in the horizontal direction, and the second for aggregating in the vertical direction, and the new RasterLayer will have 2*3=6 times fewer cells. Aggregation starts at the upper-left end of a raster. If a division of the number of columns or rows with factor does not return an integer, the extent of the resulting RasterLayer will either be somewhat smaller or somewhat larger then the original RasterLayer. For example, if an input RasterLayer has 100 columns, and fact=12, the output RasterLayer will have either 8 columns (expand=FALSE) (using 8 x 12 = 96 of the original columns) or 9 columns (expand=TRUE). In both cases, the maximum x coordinate of the output RasterLayer would, of course, also be adjusted. The function fun should take multiple numbers, and return a single number. For example mean, modal, min or max. It should also accept a na.rm argument (or ignore it as one of the 'dots' arguments).

See Also

disaggregate, resample

Examples

Run this code
r <- raster()
# a new aggregated raster, no values
ra <- aggregate(r, fact=10)
r <- setValues(r, runif(ncell(r)))
ra <- aggregate(r, fact=10, fun=max)
# a new aggregated raster, max of the values

Run the code above in your browser using DataLab