peer-review status CRAN status codecov Project Status DOI tic


chirps provides the API Client for Climate Hazards Group InfraRed Precipitation with Station Data (CHIRPS) via ClimateSERV. CHIRPS is a 35+ year quasi-global rainfall data set. Spanning 50°S-50°N (and all longitudes) and ranging from 1981 to near-present (normally with a 45 day lag), CHIRPS incorporates 0.05° resolution satellite imagery, and in-situ station data to create gridded rainfall time series for trend analysis and seasonal drought monitoring.

Quick start


The stable version is available through CRAN.

From GitHub

A development version that may have new features or bug fixes is available through GitHub.


install_github("ropensci/chirps", build_vignettes = TRUE)


Fetch CHIRPS data from three points across the Tapajós National Forest (Brazil) from Jan-2017 to Dec-2017. Then calculate the precipitation indices over the timeseries using intervals of 30 days.


lonlat <- data.frame(lon = c(-55.0281,-54.9857, -55.0714),
                     lat = c(-2.8094, -2.8756, -3.5279))

dates <- c("2017-01-01", "2017-12-31")

dat <- get_chirps(lonlat, dates)

p_ind <- precip_indices(dat, timeseries = TRUE, intervals = 30)

Going further

The full functionality of chirps is illustrated in the package vignette. The vignette can be found on the package website or from within R once the package has been installed, e.g. via:

vignette("Overview", package = "chirps")

Use of CHIRPS data

While chirps does not redistribute the data or provide it in any way, we encourage users to cite Funk et al. (2015) when using CHIRPS.

Funk C., Peterson P., Landsfeld M., Pedreros D., Verdin J., Shukla S., … Michaelsen J. (2015). The climate hazards infrared precipitation with stations—a new environmental record for monitoring extremes. Scientific Data, 2, 150066.