cliKoppenGrid {macroBiome}

Vegetation Classifier Using the KGC System

Description

Calculates the values of bioclimatic indices used in the Köppen-Geiger classification (KGC) system (Köppen 1936), and designates the KGC type using these values, by using the monthly time series of temperature and precipitation. The classification scheme is based on the procedure described by Köppen (1936) and follows the modifications described by Peel et al. (2007).

Usage

cliKoppenGrid(rs.temp, rs.prec, verbose = FALSE, filename = "", ...)

Arguments

rs.temp

multi-layer Raster*/SpatRaster object with one-year time series of monthly mean air temperature (in °C)

rs.prec

multi-layer Raster*/SpatRaster object with one-year time series of monthly precipitation sum (in mm)

verbose

'logical' scalar that indicates whether or not values of the bioclimatic indices used should be added to the output.

filename

output filename

...

additional arguments passed on to writeRaster

Details

See cliKoppenPoints.

Value

Depending on the setting, a SpatRaster object with one or more layers where the numeric integers encoding the KGC type are stored at the last layer, while the additional layers contain the values of bioclimatic indices used. The meaning of integers is given in the data frame vegClsNumCodes. If verbose = FALSE, the return object is a single-layer SpatRaster object with numeric integers encoding the KGC type.

Note

The objects 'rs.temp' and 'rs.prec' must be 12-layer Raster*/SpatRaster objects. These Raster*/SpatRaster objects must have the same bounding box, projection, and resolution.

References

Köppen W (1936) Das geographische System der Klimate. In: Köppen W, Geiger R (eds) Handbuch der Klimatologie. Verlag von Gebrüder Borntraeger, Berlin, Germany, pp 1–44

Peel MC, Finlayson BL, McMahon TA (2007) Updated world map of the Köppen-Geiger climate classification. Hydrol Earth Syst Sci 11(5):1633–1644. doi:10.5194/hess-11-1633-2007

Examples

# Loading mandatory data for the Example 'Climate Normal Grid'
data(inp_exClnrGrid)

# Designate the KGC types (using the related bioclimatic indices)
# for Csongrad-Csanad County (for the normal period 1981-2010)
with(inp_exClnrGrid, {
rs.KGC <- cliKoppenGrid(temp, prec, verbose = TRUE)
rs.KGC
})