chirps

A quasi-global high-resolution rainfall data set, which incorporates satellite imagery and in-situ station data to create gridded rainfall time series for trend analysis and seasonal drought monitoring.
https://github.com/ropensci/chirps

Category: Climate Change
Sub Category: Climate Data Access and Visualization

Keywords

chirps climatology precipitation-data rstats

Keywords from Contributors

climate hydrology routes

Last synced: about 9 hours ago
JSON representation

Repository metadata

API Client for CHIRPS

README.md

peer-review
status
CRAN status
Project Status
DOI
R-CMD-check
Codecov test coverage

chirps: Access Climate Hazards Center Datasets

Overview

chirps provides access to Climate Hazards Center (CHC) datasets including CHIRPS, CHIRPS v3, CHIRTS-daily, and CHIRTS-ERA5. Data can be retrieved either as extracted values for points and polygons or as native raster products for custom spatial workflows.

Available Datasets

Dataset Variable Resolution Period
CHIRPS v2 Precipitation 0.05° / 0.25° 1981–present
CHIRPS v3 Precipitation 0.05° 1981–present
CHIRTS-daily Tmax, Tmin, RHum, HeatIndex 0.05° 1983–2016
CHIRTS-ERA5 Tmax, Tmin 0.05° 1980–present

Applications

These datasets are commonly used for:

  • Crop modeling
  • Climate risk assessment
  • Agricultural monitoring
  • Seasonal analysis
  • Environmental characterization
  • Ecological and biodiversity studies

Quick start

From CRAN

The stable version is available through CRAN.

install.packages("chirps")

From GitHub

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

library("remotes")

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

Example

Accessing raw raster products

The package can provide direct access to CHC climate datasets as terra::SpatRaster objects. This is useful when working with large spatial datasets or custom extraction workflows.

library("chirps")
library("terra")

dates = c("2017-11-15", "2017-11-20")

# CHIRPS v2 precipitation
chirps_v2 = get_chirps_raw(dates = dates, version = "2.0")

# CHIRPS v3 precipitation
chirps_v3 = get_chirps_raw(dates = dates, version = "3.0", type = "sat")

# CHIRTS-ERA5 minimum temperature
tmin = get_chirts_era5_raw(dates = dates, var = "Tmin")

# CHIRTS-ERA5 maximum temperature
tmax = get_chirts_era5_raw(dates = dates, var = "Tmax")

Raster values can be extracted using functions from the terra package. Fetch CHIRPS data from three points across the Tapajós National Forest (Brazil) in January 2017.

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

pts = vect(lonlat,
           geom = c("lon", "lat"),
           crs = "EPSG:4326")

rain = extract(chirps_v2, pts)

The resulting object contains daily values for each location and can be readily converted to a matrix or data frame for further analysis.

The recommended workflow is to retrieve native raster products using get_chirps_raw(), get_chirts_raw(), and get_chirts_era5_raw(), and then use the terra package for extraction and spatial analysis.

Accessing high-level extraction

get_chirps() default procedure will download the COG files from the CHIRPS server and handle it internally using the package terra. This is more interesting when dealing with hundreds of points and days. Data can be returned as a matrix using the argument as.matrix = TRUE.

library("chirps")

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-01-31")

dat = get_chirps(lonlat, dates, server = "CHC", as.matrix = FALSE)

For a faster download of few datapoints (~ 10 datapoints), the argument server = "ClimateSERV" can be used

library("chirps")

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-01-31")

dat = get_chirps(lonlat, dates, server = "ClimateSERV", as.matrix = FALSE)

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")

Citing Data

While chirps does not redistribute data, users should cite the original data providers when using CHIRPS, CHIRTS, CHIRTS-ERA5, or CHIRPS v3 products.

When using datasets obtained through this package, please cite the original data providers.

CHIRPS v3

Funk, C., Peterson, P., Harrison, L. et al. (2026). The Climate Hazards Center Infrared Precipitation with Stations, Version 3. Scientific Data, 13, 718. https://doi.org/10.1038/s41597-026-07096-4

CHIRTS-ERA5

CHIRTS-ERA5 Data Repository https://doi.org/10.15780/G2F08J (2025). Data was accessed on [DATE].

CHIRPS v2

Funk C., Peterson P., Landsfeld M., … Michaelsen J. (2015). The climate hazards infrared precipitation with stations—a new environmental record for monitoring extremes. Scientific Data, 2, 150066. https://doi.org/10.1038/sdata.2015.66

CHIRTS

Verdin, A., Funk, C., Peterson, P., Landsfeld, M., Tuholske, C., and Grace, K. (2020). Development and validation of the CHIRTS-daily quasi-global high-resolution daily temperature data set. Scientific Data, 7, 303.
https://doi.org/10.1038/s41597-020-00643-7

Meta

  • Please report any issues or bugs.

  • License: MIT.

  • Get citation information for chirps in R by typing citation(package = "chirps").

  • You are welcome to contribute to the chirps project. Please read our contribution guidelines.

  • Please note that the chirps project is released with a a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 3 days ago

Total Commits: 332
Total Committers: 5
Avg Commits per committer: 66.4
Development Distribution Score (DDS): 0.389

Commits in past year: 11
Committers in past year: 2
Avg Commits per committer in past year: 5.5
Development Distribution Score (DDS) in past year: 0.182

Name Email Commits
Adam H. Sparks a****s@g****m 203
kauedesousa k****a@i****o 124
Emanuele Cordano e****o@g****m 3
Patrick Hausmann p****n@c****e 1
Maëlle Salmon m****n@y****e 1

Committer domains:


Issue and Pull Request metadata

Last synced: 5 days ago

Total issues: 50
Total pull requests: 7
Average time to close issues: 4 months
Average time to close pull requests: 7 days
Total issue authors: 21
Total pull request authors: 5
Average comments per issue: 3.56
Average comments per pull request: 0.29
Merged pull request: 7
Bot issues: 0
Bot pull requests: 0

Past year issues: 2
Past year pull requests: 1
Past year average time to close issues: N/A
Past year average time to close pull requests: 29 days
Past year issue authors: 1
Past year pull request authors: 1
Past year average comments per issue: 4.0
Past year average comments per pull request: 0.0
Past year merged pull request: 1
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ropensci/chirps

Top Issue Authors

  • adamhsparks (19)
  • kauedesousa (11)
  • ecor (2)
  • hydroversebr (1)
  • mabesa (1)
  • albirayi (1)
  • Robinlovelace (1)
  • ms1948 (1)
  • xuxoramos (1)
  • MariusHees (1)
  • peetmate (1)
  • ani-ghosh (1)
  • jdnmiguel (1)
  • samyadelara (1)
  • Nblws (1)

Top Pull Request Authors

  • adamhsparks (3)
  • maelle (1)
  • kauedesousa (1)
  • patperu (1)
  • ecor (1)

Top Issue Labels

  • enhancement (11)
  • bug (7)
  • documentation (4)
  • wontfix (1)
  • help wanted (1)

Top Pull Request Labels


Package metadata

proxy.golang.org: github.com/ropensci/chirps

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/ropensci/chirps#section-documentation
  • Licenses: other
  • Latest release: v0.1.4 (published over 4 years ago)
  • Last Synced: 2026-06-26T04:01:00.336Z (3 days ago)
  • Versions: 3
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%

Dependencies

DESCRIPTION cran
  • R >= 3.5.0 depends
  • methods * depends
  • httr * imports
  • jsonlite * imports
  • sf * imports
  • stats * imports
  • terra >= 1.2 imports
  • climatrends * suggests
  • knitr * suggests
  • markdown * suggests
  • rmarkdown * suggests
  • testthat >= 2.1.0 suggests
  • vcr >= 0.5 suggests
.github/workflows/tic.yml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v2 composite
  • pat-s/always-upload-cache v2 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-tinytex v2 composite
.github/workflows/update-tic.yml actions
  • actions/checkout v2 composite
  • peter-evans/create-pull-request v3 composite
  • r-lib/actions/setup-r master composite

Score: -Infinity