Lifecycle: experimental R-CMD-check CRAN status

The goal of hockeystick is to make essential Climate Change datasets easily available to non-climate experts. hockeystick users can download the latest raw data from authoritative sources as well as view it via pre-defined ggplot2 charts. Datasets include atmospheric CO2, instrumental, reconstructed, and paleo ice-core temperature records, sea levels, and Arctic/Antarctic sea-ice.

The choice of data was originally based on Professor Stefan Rahmstorf’s presentation on The 5 Most Important Data Sets of Climate Science. I came across this on a post on the Open Mind blog. I wrote my own post on obtaining and visualizing this data (now out of date), which is the basis for this package. Additional datasets and visualizations have been added over The name of the package stems from the well known hockeystick temperature chart.

NEW in version 0.5.0: North Atlantic hurricane data from NOAA (see below).


To install the latest hockeystick release from CRAN type:


You may alternatively install the development version from with:


Downloading and viewing climate change data

Retrieve NOAA/ESRL Mauna Loa CO2 Observatory concentration data and plot it:

ml_co2 <- get_carbon()

Retrieve NASA/GISS global surface temperature anomaly data and plot it:

anomaly <- get_temp()

Visualize warming using Ed Hawkins styled “warming stripes”:


warming_stripes(stripe_only = TRUE, col_strip = viridisLite::viridis(11))

Retrieve tide gauge and satellite sea level data and plot it:

gmsl <- get_sealevel()

Retrieve July annual Arctic Sea Ice Index and plot it:

seaice <- get_seaice()

get_seaice() arguments can be modified to download Antarctic sea ice, and allow any month.

You can also visualize sea ice by month and year:

arcticice <- get_icecurves()

Retrieve Common Era temperature reconstruction and plot it with instrumental record:

anomaly2k <- get_temp2k()

Retrieve Vostok ice core data and plot it:

vostok <- get_paleo()

Retrieve NOAA HURDAT2 hurricane data and plot it:

hurricanes <- get_hurricanes()


Managing the cache

By default, no climate data is cached, and all data is downloaded every time any of the get_ functions is called. To cache data for future use, use the write_cache = TRUE option, available in all of the get_ functions. To download and cache all data use hockeystick_update_all(). To view the files, date, and size of cached data use hockeystick_cache_details(). To re-download data from the source use the use_cache = FALSE argument in any of the get_ functions, for example: get_carbon(use_cache = FALSE, write_cache = TRUE). To delete all cached data use hockeystick_cache_delete_all().

Users may also cache data by default by adding options(hs_write_cache = TRUE)to their script or .Rprofile file.

All together now: climate data grid



Notes and resources