From 3355ef326253f07d900ba53d83407697e95ec8b4 Mon Sep 17 00:00:00 2001 From: Hernando Cortina Date: Thu, 11 Aug 2022 11:33:23 -0400 Subject: [PATCH] Update additional .Rd files --- docs/news/index.html | 2 +- docs/pkgdown.yml | 2 +- docs/search.json | 2 +- man/get_carbon.Rd | 98 ++++++++++++++++---------------- man/get_sealevel.Rd | 112 ++++++++++++++++++------------------- man/hockeystick-package.Rd | 52 ++++++++--------- 6 files changed, 134 insertions(+), 134 deletions(-) diff --git a/docs/news/index.html b/docs/news/index.html index 06b282f..0f3237a 100644 --- a/docs/news/index.html +++ b/docs/news/index.html @@ -90,7 +90,7 @@

hockeystick 0

hockeystick 0.6.2

-
  • Update documentation to confirm with R version 4.2
    • +
    • Update documentation to conform with R version 4.2
diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml index 84bb9de..0c46fd2 100644 --- a/docs/pkgdown.yml +++ b/docs/pkgdown.yml @@ -2,5 +2,5 @@ pandoc: '2.18' pkgdown: 2.0.6 pkgdown_sha: ~ articles: {} -last_built: 2022-08-11T14:28Z +last_built: 2022-08-11T15:29Z diff --git a/docs/search.json b/docs/search.json index ed6b2a6..781cc2f 100644 --- a/docs/search.json +++ b/docs/search.json @@ -1 +1 @@ -[{"path":"/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2020 Hernando Cortina Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":"/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Hernando Cortina. Author, maintainer.","code":""},{"path":"/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Hernando Cortina. hockeystick: Download Visualize Essential Climate Change Data (2020)","code":"@Manual{, title = {hockeystick: Download and Visualize Essential Climate Change Data}, author = {Hernando Cortina}, year = {2020}, url = {https://cortinah.github.io/hockeystick/}, }"},{"path":"/index.html","id":"hockeystick-","dir":"","previous_headings":"","what":"Download and Visualize Essential Climate Change Data","title":"Download and Visualize Essential Climate Change Data","text":"goal hockeystick make essential Climate Change datasets easily available non-climate experts. hockeystick users can download latest raw data authoritative sources well view via pre-defined ggplot2 charts. Datasets include atmospheric CO2, instrumental, reconstructed, paleo ice-core temperature records, sea levels, Arctic/Antarctic sea-ice. choice data originally based Professor Stefan Rahmstorf’s presentation 5 Important Data Sets Climate Science. came across post Open Mind blog. wrote post obtaining visualizing data (now date), basis package. Additional datasets visualizations added name package stems well known hockeystick temperature chart. hockeystick highlighted RStudio RViews blog Joseph Rickert one “Top 40” new packages CRAN February 2021. NEW version 0.5.0: North Atlantic hurricane data NOAA. NEW version 0.6.0: Global CO2 emissions region country GCP (see ).","code":""},{"path":"/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Download and Visualize Essential Climate Change Data","text":"install latest hockeystick release CRAN type: may alternatively install development version https://github.com/cortinah/hockeystick :","code":"install.packages(\"hockeystick\") remotes::install_github(\"cortinah/hockeystick\")"},{"path":"/index.html","id":"downloading-and-viewing-climate-change-data","dir":"","previous_headings":"","what":"Downloading and viewing climate change data","title":"Download and Visualize Essential Climate Change Data","text":"Retrieve NOAA/ESRL Mauna Loa CO2 Observatory concentration data plot: Retrieve GCP global CO2 emissions plot: Retrieve NASA/GISS global surface temperature anomaly data plot: Visualize warming using Ed Hawkins styled “warming stripes”: Retrieve tide gauge satellite sea level data plot: Retrieve July annual Arctic Sea Ice Index plot: get_seaice() arguments can modified download Antarctic sea ice, allow month. can also visualize sea ice month year: Retrieve Common Era temperature reconstruction plot instrumental record: Retrieve NOAA HURDAT2 hurricane data plot: Retrieve Vostok paleo ice core data plot:","code":"library(hockeystick) ml_co2 <- get_carbon() plot_carbon(ml_co2) emissions <- get_emissions() plot_emissions(emissions) anomaly <- get_temp() plot_temp(anomaly) warming_stripes() warming_stripes(stripe_only = TRUE, col_strip = viridisLite::viridis(11)) gmsl <- get_sealevel() plot_sealevel(gmsl) seaice <- get_seaice() plot_seaice(seaice) arcticice <- get_icecurves() plot_icecurves(arcticice) anomaly2k <- get_temp2k() plot_temp2k(anomaly2k) hurricanes <- get_hurricanes() plot_hurricanes(hurricanes) plot_hurricane_nrg(hurricanes) vostok <- get_paleo() plot_paleo(vostok)"},{"path":"/index.html","id":"managing-the-cache","dir":"","previous_headings":"Downloading and viewing climate change data","what":"Managing the cache","title":"Download and Visualize Essential Climate Change Data","text":"default, climate data cached, data downloaded every time get_ functions called. cache data future use, use write_cache = TRUE option, available get_ functions. download cache data use hockeystick_update_all(). view files, date, size cached data use hockeystick_cache_details(). re-download data source use use_cache = FALSE argument get_ functions, example: get_carbon(use_cache = FALSE, write_cache = TRUE). delete cached data use hockeystick_cache_delete_all(). Users may also cache data default adding options(hs_write_cache = TRUE)script .Rprofile file.","code":""},{"path":"/index.html","id":"all-together-now-climate-data-grid","dir":"","previous_headings":"Downloading and viewing climate change data","what":"All together now: climate data grid","title":"Download and Visualize Essential Climate Change Data","text":"","code":"climate_grid()"},{"path":"/index.html","id":"acknowledgments","dir":"","previous_headings":"","what":"Acknowledgments","title":"Download and Visualize Essential Climate Change Data","text":"Carbon Dioxide concentrations: Dr. Pieter Tans, NOAA/GML (https://gml.noaa.gov/ccgg/trends/) Dr. Ralph Keeling, Scripps Institution Oceanography. Global temperature anomaly: GISS Surface Temperature Analysis (GISTEMP), version 4. GISTEMP Team, 2020: NASA Goddard Institute Space Studies. https://data.giss.nasa.gov/gistemp/ Warming Stripes design Ed Hawkins’ Climate Lab. https://www.climate-lab-book.ac.uk/2018/warming-stripes/. addition grateful Dr. Dominic Royé posting approach plotting using ggplot2, warming_stripes() based . https://dominicroye.github.io/en/2018/--create-warming-stripes--r/ Sea level data: NOAA Laboratory Satellite Altimetry (sat) Commonwealth Scientific Industrial Research Organisation (tide gauges) Sea Ice Index: National Snow & Ice Data Center. Data Archive: https://nsidc.org/data/seaice_index/archives Vostok carbon dioxide temperature data: https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html Common Era reconstructed temperature data: PAGES2k Consortium NOAA. Hurricanes: National Oceanic Atmospheric Administration HURDAT Atlantic Hurricane Database Re-analysis Project, particularly Dr. Chris Landsea. Carbon Dioxide emissions: Global Carbon Project World Data","code":""},{"path":"/index.html","id":"notes-and-resources","dir":"","previous_headings":"","what":"Notes and resources","title":"Download and Visualize Essential Climate Change Data","text":"data compiled best ability reliable peer-reviewed sources. Please open issue aware enhanced additional data may added package. Building hockeystick driven interest tracking climate data making easily available community. online resources found helpful learn climate science: MIT edX Global Warming Science. https://www.edx.org/course/global-warming-science SDG Academy: Climate Change: Science Global Impact. https://sdgacademy.org/course/climate-change--science--global-impact/","code":""},{"path":"/reference/climate_grid.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — climate_grid","title":"Download and plot essential climate data — climate_grid","text":"Plots 2x2 grid carbon, temperature, sea ice, sea level charts.","code":""},{"path":"/reference/climate_grid.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — climate_grid","text":"","code":"climate_grid(print = TRUE)"},{"path":"/reference/climate_grid.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — climate_grid","text":"print (boolean) Display climate grid ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/climate_grid.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — climate_grid","text":"Invisibly returns ggplot2 object climate grid","code":""},{"path":"/reference/climate_grid.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — climate_grid","text":"warming_stripes invisibly returns ggplot2 object 2x2 grid carbon, temperature, sea ice, sea level charts get_carbon, get_temp, get_seaice, get_sealevel. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/climate_grid.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — climate_grid","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/climate_grid.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — climate_grid","text":"","code":"# \\donttest{ # Draw grid grid <- climate_grid() # }"},{"path":"/reference/file_info_.html","id":null,"dir":"Reference","previous_headings":"","what":"Display cached file info — file_info_","title":"Display cached file info — file_info_","text":"Internal function","code":""},{"path":"/reference/file_info_.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display cached file info — file_info_","text":"","code":"file_info_(x)"},{"path":"/reference/file_info_.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display cached file info — file_info_","text":"x filenames","code":""},{"path":"/reference/get_carbon.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_carbon","title":"Download and plot essential climate data — get_carbon","text":"Retrieves atmospheric carbon dioxide measurements National Oceanic Atmospheric Administration Earth System Research Laboratories monitoring laboratory Mauna Loa, Hawaii. https://gml.noaa.gov/ccgg/trends/data.html","code":""},{"path":"/reference/get_carbon.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_carbon","text":"","code":"get_carbon(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_carbon.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_carbon","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_carbon.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_carbon","text":"Invisibly returns tibble monthly carbon dioxide series","code":""},{"path":"/reference/get_carbon.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — get_carbon","text":"get_carbon invisibly returns tibble NOAA's monthly average carbon dioxide measurement. returned object includes date, year, month, average, trend, std dev, uncertainty columns. Trend NOAA's published trend. Please refer website details.","code":""},{"path":"/reference/get_carbon.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_carbon","text":"Dr. Pieter Tans, NOAA/GML https://gml.noaa.gov/ccgg/trends/ Dr. Ralph Keeling, Scripps Institution Oceanography https://scrippsco2.ucsd.edu/. C.D. Keeling, R.B. Bacastow, .E. Bainbridge, C.. Ekdahl, P.R. Guenther, L.S. Waterman, (1976), Atmospheric carbon dioxide variations Mauna Loa Observatory, Hawaii, Tellus, vol. 28, 538-551","code":""},{"path":"/reference/get_carbon.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_carbon","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_carbon.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_carbon","text":"","code":"# \\donttest{ # Fetch from cache if available, otherwise download: maunaloa <- get_carbon() # # Force fetch from source: maunaloa <- get_carbon(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_carbon(maunaloa) # }"},{"path":"/reference/get_emissions.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_emissions","title":"Download and plot essential climate data — get_emissions","text":"Retrieves Global Carbon Project (GCP) annual global carbon dioxide emissions since 1750 World Data repository https://github.com/owid/co2-data","code":""},{"path":"/reference/get_emissions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_emissions","text":"","code":"get_emissions(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_emissions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_emissions","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_emissions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_emissions","text":"Invisibly returns tibble annual carbon dioxide emissions","code":""},{"path":"/reference/get_emissions.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — get_emissions","text":"get_emissions invisibly returns tibble GCP's annual carbon dioxide emissions aggregate every nation. returned object includes ISO code, country, year, co2 emissions, growth rates, per capita, decompositions industry gas type. Please refer website details.","code":""},{"path":"/reference/get_emissions.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_emissions","text":"https://www.globalcarbonproject.org/carbonbudget/20/data.htm Friedlingstein, P. et al (2020), Global Carbon Budget 2020, Earth System Science Data, vol. 12, 3269-3340 doi:10.5194/essd-12-3269-2020","code":""},{"path":"/reference/get_emissions.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_emissions","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_emissions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_emissions","text":"","code":"# \\donttest{ # Fetch from cache if available: emissions <- get_emissions() # # Force cache refresh: emissions <- get_emissions(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_emissions(emissions) # }"},{"path":"/reference/get_hurricanes.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_hurricanes","title":"Download and plot essential climate data — get_hurricanes","text":"Retrieves Atlantic basin hurricane data since 1851 National Oceanic Atmospheric Administration HURDAT Atlantic Hurricane Database Re-analysis Project. https://www.aoml.noaa.gov/hrd/hurdat/Data_Storm.html","code":""},{"path":"/reference/get_hurricanes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_hurricanes","text":"","code":"get_hurricanes(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_hurricanes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_hurricanes","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_hurricanes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_hurricanes","text":"Invisibly returns tibble annual HURDAT hurricane data since 1851","code":""},{"path":"/reference/get_hurricanes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — get_hurricanes","text":"get_hurricanes invisibly returns tibble NOAA's annual North Atlantic revised HURDAT hurricane data since 1851. returned object includes Year, number named storms, hurricanes, major hurricanes (S-S scale 3-5), Accumulated Cyclone Energy (ACE), U.S. hurricane strikes. ACE index combines number systems, long existed intense became. calculated squaring maximum sustained surface wind system every six hours cyclone Named Storm summing season. Please refer website details.","code":""},{"path":"/reference/get_hurricanes.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_hurricanes","text":"HURDAT North Atlantic Hurricane Database Re-analysis Project, Hurricane Research Division, NOAA https://www.aoml.noaa.gov/hrd/hurdat/Data_Storm.html. Data : https://www.aoml.noaa.gov/hrd/hurdat/comparison_table.html https://en.wikipedia.org/wiki/Accumulated_cyclone_energy","code":""},{"path":"/reference/get_hurricanes.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_hurricanes","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_hurricanes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_hurricanes","text":"","code":"# \\donttest{ # Fetch from cache if available: hurricanes <- get_hurricanes() # # Force cache refresh: hurricanes <- get_hurricanes(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_hurricanes(hurricanes) # }"},{"path":"/reference/get_icecurves.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_icecurves","title":"Download and plot essential climate data — get_icecurves","text":"Retrieves Arctic Antarctic monthly Sea Ice Index time series (million square km). Source National Snow Ice Data Center, defaults Arctic (Northern Hemisphere) monthly sea ice extent since 1979. https://nsidc.org/data/seaice_index/archives","code":""},{"path":"/reference/get_icecurves.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_icecurves","text":"","code":"get_icecurves( pole = \"N\", measure = \"extent\", use_cache = TRUE, write_cache = getOption(\"hs_write_cache\") )"},{"path":"/reference/get_icecurves.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_icecurves","text":"pole 'N' Arctic 'S' Antarctic measure Must 'extent' 'area', defaults 'extent'. Please see terminology link references details. use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data, change pole month cache. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_icecurves.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_icecurves","text":"Invisibly returns tibble series monthly Sea Ice Index since 1979 (million square km). get_icecurves invisibly returns tibble time series monthly Sea Ice Index since 1979 (million square km). User may select monthly Arctic Antarctic sea ice extent area (millions square kilometers). Defaults Arctic sea ice extent. https://nsidc.org/arcticseaicenews/faq/#area_extent","code":""},{"path":"/reference/get_icecurves.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_icecurves","text":"NSIDC Data Archive: https://nsidc.org/data/seaice_index/archives Sea Ice: https://nsidc.org/cryosphere/seaice/index.html Sea Ice terminology: https://nsidc.org/cryosphere/seaice/data/terminology.html","code":""},{"path":"/reference/get_icecurves.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_icecurves","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_icecurves.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_icecurves","text":"","code":"# \\donttest{ # Fetch monthly sea ice history from cache if available: icecurves <- get_icecurves() #> Please set use_cache=FALSE if you are changing pole or measure from last cached data. # # Force cache refresh: icecurves <- get_icecurves(use_cache = FALSE) # change region south_icecurves <- get_icecurves(pole='S', use_cache = FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_icecurves(icecurves) # }"},{"path":"/reference/get_paleo.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_paleo","title":"Download and plot essential climate data — get_paleo","text":"Retrieves historical carbon dioxide temperature records Vostok ice core past 420,000 years. Source data U.S. Department Energy’s (DOE) Environmental System Science Data Infrastructure Virtual Ecosystem (ESS-DIVE). https://ess-dive.lbl.gov/ https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html","code":""},{"path":"/reference/get_paleo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_paleo","text":"","code":"get_paleo(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_paleo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_paleo","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_paleo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_paleo","text":"Invisibly returns tibble age ice (years C.E.), carbon dioxide (ppm) temperature (degrees C). get_paleo invisibly returns tibble Vostok ice core data: age ice (years C.E.), carbon dioxide (ppm) temperature (degrees C). Data : Barnola J; Raynaud D; Lorius C; Barkov N (2003): Historical Carbon Dioxide Record Vostok Ice Core (417,160 - 2,342 years BP) Petit J R ; Raynaud D ; Lorius C ; Delaygue G ; Jouzel J ; Barkov N ; Kotlyakov V M (2000): Historical Isotopic Temperature Record Vostok Ice Core. CDIAC.","code":""},{"path":"/reference/get_paleo.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_paleo","text":"Historical Carbon Dioxide Record Vostok Ice Core (US Dept Energy): https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html Petit J R ; Raynaud D ; Lorius C ; Delaygue G ; Jouzel J ; Barkov N ; Kotlyakov V M (2000): Historical Isotopic Temperature Record Vostok Ice Core. CDIAC. doi:10.3334/CDIAC/CLI.006. https://data.ess-dive.lbl.gov/view/doi:10.3334/CDIAC/CLI.006 Barnola J ; Raynaud D ; Lorius C ; Barkov N (2003): Historical Carbon Dioxide Record Vostok Ice Core (417,160 - 2,342 years BP). None. doi:10.3334/CDIAC/ATG.009 https://data.ess-dive.lbl.gov/view/doi:10.3334/CDIAC/ATG.009","code":""},{"path":"/reference/get_paleo.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_paleo","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_paleo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_paleo","text":"","code":"# \\donttest{ # Fetch Vostok paleo carbon and temperature data from cache if available: vostok <- get_paleo() #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) # # Force cache refresh: vostok <- get_paleo(use_cache=FALSE) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_paleo(vostok) # }"},{"path":"/reference/get_seaice.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_seaice","title":"Download and plot essential climate data — get_seaice","text":"Retrieves Arctic Antarctic annual Sea Ice Index (million square km). Source National Snow Ice Data Center, defaults Arctic (Northern Hemisphere) July sea ice extent. https://nsidc.org/data/seaice_index/archives","code":""},{"path":"/reference/get_seaice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_seaice","text":"","code":"get_seaice( pole = \"N\", month = \"07\", measure = \"extent\", use_cache = TRUE, write_cache = getOption(\"hs_write_cache\") )"},{"path":"/reference/get_seaice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_seaice","text":"pole 'N' Arctic 'S' Antarctic month 2-digit month retrieve sea ice , defaults '07' (July) measure Must 'extent' 'area', defaults 'extent'. Please see terminology link references details. use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data, change pole month cache. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_seaice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_seaice","text":"Invisibly returns tibble annual series monthly Sea Ice Index since 1979 (million square km). get_seaice invisibly returns tibble annual series monthly Sea Ice Index since 1979 (million square km). User may select Arctic Antarctic sea ice extent area (millions square kilometers) year given month, specified argument month. Defaults Arctic July sea ice extent. https://nsidc.org/arcticseaicenews/faq/#area_extent","code":""},{"path":"/reference/get_seaice.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_seaice","text":"NSIDC Data Archive: https://nsidc.org/data/seaice_index/archives Sea Ice: https://nsidc.org/cryosphere/seaice/index.html Sea Ice terminology: https://nsidc.org/cryosphere/seaice/data/terminology.html","code":""},{"path":"/reference/get_seaice.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_seaice","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_seaice.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_seaice","text":"","code":"# \\donttest{ # Fetch sea ice from cache if available: seaice <- get_seaice() #> Please set use_cache=FALSE if you are changing pole, month, or measure from last cached data. # # Force cache refresh: seaice <- get_seaice(use_cache = FALSE) # change region and month seaice <- get_seaice(pole='S', month='09', use_cache = FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_seaice(seaice) # }"},{"path":"/reference/get_sealevel.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_sealevel","title":"Download and plot essential climate data — get_sealevel","text":"Retrieves global mean sea level (GMSL) data historic tide gauge recent satellite altimeter observations (mm). Source tide gauge data Commonwealth Scientific Industrial Research Organisation (CSIRO) described Church White (2011). https://research.csiro.au/slrwavescoast/sea-level/measurements--data/sea-level-data/ Source satellite data NOAA Laboratory Satellite Altimetry: https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/","code":""},{"path":"/reference/get_sealevel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_sealevel","text":"","code":"get_sealevel(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_sealevel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_sealevel","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_sealevel.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_sealevel","text":"Invisibly returns tibble global mean sea level time series (mm) 1880-2013 using tide gauges since 1993 satellite measurements. get_sealevel invisibly returns tibble mean sea level mm time series tide gauges satellite observations. satellite observations releveled mean level 1993 matches tide gauges. tide gauge data longer updated cover period 1880 2013, per Church, J. . N.J. White (2011) https://research.csiro.au/slrwavescoast/sea-level/measurements--data/sea-level-data/ Satellite data updated monthly frequently NOAA Laboratory Satellite Altimetry. TOPEX Jason-1,-2,-3 satellites dataset, seasonal signals removed. https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/","code":""},{"path":"/reference/get_sealevel.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_sealevel","text":"CSIRO reconstructed tide gauge GMSL 1880 2009: https://research.csiro.au/slrwavescoast/sea-level/measurements--data/sea-level-data/ Church, J. . N.J. White (2011), Sea-level rise late 19th early 21st Century. Surveys Geophysics, doi:10.1007/s10712-011-9119-1. https://link.springer.com/article/10.1007/s10712-011-9119-1 NOAA Laboratory Satellite Altimetry https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/","code":""},{"path":"/reference/get_sealevel.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_sealevel","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_sealevel.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_sealevel","text":"","code":"# \\donttest{ # Fetch sea level from cache if available: gmsl <- get_sealevel() # # Force cache refresh: gmsl <- get_sealevel(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_sealevel(gmsl) # }"},{"path":"/reference/get_temp.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_temp","title":"Download and plot essential climate data — get_temp","text":"Retrieves combined global land- sea-surface temperature anomaly (Land-Ocean Temperature Index, LOTI). Source NASA/GISS Surface Temperature Analysis (GISTEMP v4), estimate global surface temperature change. https://data.giss.nasa.gov/gistemp/","code":""},{"path":"/reference/get_temp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_temp","text":"","code":"get_temp(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_temp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_temp","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_temp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_temp","text":"Invisibly returns tibble annual mean monthly Combined Land-Surface Air Sea-Surface Water Temperature Anomalies. get_temp invisibly returns tibble NASA/GISS annual mean monthly global temperature anomaly. Data global 1880 present, represent deviations 1951-1980 mean. returned object includes monthly annual average anomalies, well seasonal anomalies. GISS Surface Temperature Analysis (GISTEMP v4) estimate global surface temperature change. Data updated around middle every month using current data files NOAA GHCN v4 (meteorological stations) ERSST v5 (ocean areas). Station data combined described Hansen et al. (2010) https://data.giss.nasa.gov/gistemp/references.html Lenssen et al. (2019) https://pubs.giss.nasa.gov/abs/le05800h.html","code":""},{"path":"/reference/get_temp.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_temp","text":"GISS Surface Temperature Analysis (GISTEMP v4): https://data.giss.nasa.gov/gistemp/ GISTEMP Team, 2020: GISS Surface Temperature Analysis (GISTEMP), version 4. NASA Goddard Institute Space Studies. Lenssen, N., G. Schmidt, J. Hansen, M. Menne, . Persin, R. Ruedy, D. Zyss, 2019: Improvements GISTEMP uncertainty model. J. Geophys. Res. Atmos., 124, . 12, 6307-6326, doi:10.1029/2018JD029522. https://pubs.giss.nasa.gov/abs/le05800h.html","code":""},{"path":"/reference/get_temp.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_temp","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_temp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_temp","text":"","code":"# \\donttest{ # Fetch temp anomaly from cache if available: anomaly <- get_temp() # # Force cache refresh: anomaly <- get_temp(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_temp(anomaly) # }"},{"path":"/reference/get_temp2k.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_temp2k","title":"Download and plot essential climate data — get_temp2k","text":"Retrieves Common Era Global Surface Temperature Reconstructions. Source PAGES2k Consortium NOAA National Centers Environmental Information. https://www.ncdc.noaa.gov/paleo-search/study/26872","code":""},{"path":"/reference/get_temp2k.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_temp2k","text":"","code":"get_temp2k(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_temp2k.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_temp2k","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_temp2k.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_temp2k","text":"Invisibly returns tibble filtered unfiltered temperature reconstructions Cowtan & Way instrumental temperatures. get_temp2k invisibly returns tibble PAGES2k Consortium temperature reconstruction (years 1-2000 CE) instrumental record (years 1850-2017 CE). Temperatures represent deviations 1961-1990 mean. returned object includes annual average temperature anomalies well filtered anomalies using 31-year Butterworth filter. Reconstructions use seven different statistical methods draw global collection temperature-sensitive palaeoclimate records. Methodology described PAGES2k (2019) https://www.nature.com/articles/s41561-019-0400-0","code":""},{"path":"/reference/get_temp2k.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_temp2k","text":"PAGES2k Common Era Surface Temperature Reconstructions. https://www.ncdc.noaa.gov/paleo-search/study/26872 PAGES 2k Consortium., Neukom, R., Barboza, L.. et al. Consistent multidecadal variability global temperature reconstructions simulations Common Era. Nat. Geosci. 12, 643–649 (2019). doi:10.1038/s41561-019-0400-0","code":""},{"path":"/reference/get_temp2k.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_temp2k","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_temp2k.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_temp2k","text":"","code":"# \\donttest{ # Fetch temp anomaly from cache if available: anomaly <- get_temp2k() # # Force cache refresh: anomaly <- get_temp2k(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_temp2k(anomaly) # }"},{"path":"/reference/getsize.html","id":null,"dir":"Reference","previous_headings":"","what":"Get rounded size of file in kB — getsize","title":"Get rounded size of file in kB — getsize","text":"Internal function","code":""},{"path":"/reference/getsize.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get rounded size of file in kB — getsize","text":"","code":"getsize(x)"},{"path":"/reference/getsize.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get rounded size of file in kB — getsize","text":"x filenames","code":""},{"path":"/reference/hockeystick-package.html","id":null,"dir":"Reference","previous_headings":"","what":"hockeystick: Download and Visualize Essential Climate Change Data — hockeystick-package","title":"hockeystick: Download and Visualize Essential Climate Change Data — hockeystick-package","text":"Provides easy access essential climate change datasets non-climate experts. Users can download latest raw data authoritative sources view via pre-defined 'ggplot2' charts. Datasets include atmospheric CO2, emissions, instrumental proxy temperature records, sea levels, Arctic/Antarctic sea-ice, Hurricanes, Paleoclimate data. Sources include: NOAA Mauna Loa Laboratory https://gml.noaa.gov/ccgg/trends/data.html, Global Carbon Project https://www.globalcarbonproject.org/carbonbudget/20/data.htm, NASA GISTEMP https://data.giss.nasa.gov/gistemp/, National Snow Sea Ice Data Center https://nsidc.org/data/seaice_index/archives, CSIRO https://research.csiro.au/slrwavescoast/sea-level/measurements--data/sea-level-data/, NOAA Laboratory Satellite Altimetry https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/ HURDAT Atlantic Hurricane Database https://www.aoml.noaa.gov/hrd/hurdat/Data_Storm.html, Vostok Paleo carbon dioxide temperature data: https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html.","code":""},{"path":[]},{"path":"/reference/hockeystick-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"hockeystick: Download and Visualize Essential Climate Change Data — hockeystick-package","text":"Maintainer: Hernando Cortina hch@alum.mit.edu (ORCID)","code":""},{"path":"/reference/hockeystick_cache.html","id":null,"dir":"Reference","previous_headings":"","what":"Manage cached datasets — hockeystick_cache","title":"Manage cached datasets — hockeystick_cache","text":"Manage cached datasets","code":""},{"path":"/reference/hockeystick_cache.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Manage cached datasets — hockeystick_cache","text":"","code":"hockeystick_cache_list() hockeystick_cache_delete(files, force = TRUE) hockeystick_cache_delete_all(force = TRUE) hockeystick_cache_details(files = NULL) hockeystick_update_all()"},{"path":"/reference/hockeystick_cache.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Manage cached datasets — hockeystick_cache","text":"files (character) one complete file names force (logical) files force deleted? Default: TRUE","code":""},{"path":"/reference/hockeystick_cache.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Manage cached datasets — hockeystick_cache","text":"hockeystick_cache_list() returns character vector full path filenames cache. hockeystick_cache_delete() return value, called side effect. hockeystick_cache_delete_all() return value, called side effect. hockeystick_cache_details() returns list filenames sizes cached files. hockeystick_update_all() updates datasets caches . return value, called side effect.","code":""},{"path":"/reference/hockeystick_cache.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Manage cached datasets — hockeystick_cache","text":"cache_delete accepts 1 file name, cache_delete_all accept names, deletes files. deleting many specific files, use cache_delete lapply() type call cache using tools::R_user_dir(), find cache folder executing tools::R_user_dir(\"hockeystick\",\"cache\")","code":""},{"path":"/reference/hockeystick_cache.html","id":"functions","dir":"Reference","previous_headings":"","what":"Functions","title":"Manage cached datasets — hockeystick_cache","text":"hockeystick_cache_list() returns character vector full path file names cache hockeystick_cache_delete() deletes one files, returns nothing hockeystick_cache_delete_all() delete files, returns nothing hockeystick_cache_details() prints file name file size file, supply one files, files (get details available) hockeystick_update_all() updates cache latest co2, temperature, sea level, sea ice data.","code":""},{"path":"/reference/hockeystick_cache.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Manage cached datasets — hockeystick_cache","text":"Caching data sets: ROpenSci guide persistent config data R packages: https://blog.r-hub.io/2020/03/12/user-preferences/","code":""},{"path":"/reference/hockeystick_cache.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Manage cached datasets — hockeystick_cache","text":"","code":"# \\donttest{ # list files in cache hockeystick_cache_list() #> character(0) # List info for single files hockeystick_cache_details(files = hockeystick_cache_list()[1]) #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> #> file: NA #> size: NA kB #> date: NA #> hockeystick_cache_details(files = hockeystick_cache_list()[2]) #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> #> file: NA #> size: NA kB #> date: NA #> # List info for all files hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # Delete cached files by name hockeystick_cache_delete(files = hockeystick_cache_list()[1]) #> These files don't exist or can't be found: #> NAFALSE # Update all hockeystick data and place in cache hockeystick_update_all() # Delete all cached data hockeystick_cache_delete_all() # }"},{"path":"/reference/hscache_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Return path of data cache directory — hscache_path","title":"Return path of data cache directory — hscache_path","text":"Internal Function","code":""},{"path":"/reference/hscache_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return path of data cache directory — hscache_path","text":"","code":"hscache_path()"},{"path":"/reference/hscache_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Return path of data cache directory — hscache_path","text":"Return path data cache directory","code":""},{"path":"/reference/plot_carbon.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_carbon","title":"Download and plot essential climate data — plot_carbon","text":"Plots carbon dioxide data retrieved using get_carbon() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_carbon.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_carbon","text":"","code":"plot_carbon(dataset = get_carbon(), print = TRUE, annot = TRUE)"},{"path":"/reference/plot_carbon.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_carbon","text":"dataset Name tibble generated get_carbon print (boolean) Display carbon dioxide ggplot2 chart, defaults TRUE. Use FALSE display chart. annot (boolean) Include chart annotation latest date value, defaults TRUE.","code":""},{"path":"/reference/plot_carbon.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_carbon","text":"Invisibly returns ggplot2 object carbon dioxide chart","code":""},{"path":"/reference/plot_carbon.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_carbon","text":"plot_carbon invisibly returns ggplot2 object pre-defined carbon dioxide chart using data get_carbon. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_carbon.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_carbon","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_carbon.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_carbon","text":"","code":"# \\donttest{ # Fetch carbon dioxide data: maunaloa <- get_carbon() # # Plot output using package's built-in ggplot2 defaults plot_carbon(maunaloa) # Or just call plot_carbon(), which defaults to get_carbon() dataset plot_carbon() p <- plot_carbon(maunaloa, print = FALSE) p + ggplot2::labs(title='The Keeling Curve') # }"},{"path":"/reference/plot_emissions.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_emissions","title":"Download and plot essential climate data — plot_emissions","text":"Plots carbon dioxide emissions retrieved using get_emissions() ggplot2. output ggplot2 object may modified. Alternative columns dataset may also plotted.","code":""},{"path":"/reference/plot_emissions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_emissions","text":"","code":"plot_emissions( dataset = get_emissions(), start_year = 1900, region = \"OWID_WRL\", field = \"co2\", print = TRUE, annot = TRUE, title_expression = expression(\"Atmospheric \" * CO[2] * \" Emissions\"), yaxis_expression = expression(\"Gt \" * CO[2] * \" per year\") )"},{"path":"/reference/plot_emissions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_emissions","text":"dataset Name tibble generated get_emissions start_year Year start plot . Defaults 1900. Data available since 1750. region ISO code region plot. Defaults 'OWID_WRL' signifies entire world. field Field GCP dataset plotted, defaults 'co2' print (boolean) Display carbon dioxide emissions ggplot2 chart, defaults TRUE. Use FALSE display chart. annot (boolean) Include chart annotation latest date value, defaults TRUE. title_expression Chart title, defaults CO2 emissions yaxis_expression y-axis label, defaults Gt CO2 emissions","code":""},{"path":"/reference/plot_emissions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_emissions","text":"Invisibly returns ggplot2 object carbon dioxide emissions chart","code":""},{"path":"/reference/plot_emissions.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_emissions","text":"plot_emissions invisibly returns ggplot2 object pre-defined carbon dioxide emissions chart using data get_emissions. Use field parameter select alternative columns data set co2_per_capita. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_emissions.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_emissions","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_emissions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_emissions","text":"","code":"# \\donttest{ # Fetch carbon dioxide emissions: emissions <- get_emissions() # Plot output using package's built-in ggplot2 defaults plot_emissions(emissions) # Or just call plot_emissions(), which defaults to get_emissions() dataset plot_emissions() # You can also select a region by ISO code and start year plot_emissions(region='USA', start_year=1950) p <- plot_emissions(emissions, print = FALSE) p + ggplot2::labs(title='Anthropogenic Carbon Emissions') # Plot a different field from GCP dataset plot_emissions(field='co2_per_capita', yaxis_expression=expression(CO[2]*' per capita' ))# }"},{"path":"/reference/plot_hurricane_nrg.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_hurricane_nrg","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"Plots hurricane energy data (ACE) retrieved using get_hurricanes() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"","code":"plot_hurricane_nrg(dataset = get_hurricanes(), print = TRUE)"},{"path":"/reference/plot_hurricane_nrg.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"dataset Name tibble generated get_hurricanes print (boolean) Display hurricane ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"Invisibly returns ggplot2 object hurricane energy chart","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"plot_hurricane_nrg invisibly returns ggplot2 object pre-defined hurricane energy data chart using data get_hurricanes. default chart also displayed. Smooths using ggplot2's built-loess smoother. Users may modify output ggplot2 chart. ACE index combines number systems, long existed intense became. calculated squaring maximum sustained surface wind system every six hours cyclone Named Storm summing season. Please refer website details.","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"","code":"# \\donttest{ # Fetch hurricane data: hurricanes <- get_hurricanes() # # Plot output using package's built-in ggplot2 defaults plot_hurricane_nrg(hurricanes) # Or just call plot_hurricane_nrg(), which defaults to get_hurricanes() dataset plot_hurricane_nrg() p <- plot_hurricane_nrg(hurricanes, print = FALSE) p + ggplot2::labs(title='Accumulated Cyclone Energy') # } #> `geom_smooth()` using method = 'loess' and formula 'y ~ x'"},{"path":"/reference/plot_hurricanes.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_hurricanes","title":"Download and plot essential climate data — plot_hurricanes","text":"Plots hurricane data retrieved using get_hurricanes() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_hurricanes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_hurricanes","text":"","code":"plot_hurricanes(dataset = get_hurricanes(), print = TRUE)"},{"path":"/reference/plot_hurricanes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_hurricanes","text":"dataset Name tibble generated get_hurricanes print (boolean) Display hurricane ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_hurricanes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_hurricanes","text":"Invisibly returns ggplot2 object hurricanes chart","code":""},{"path":"/reference/plot_hurricanes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_hurricanes","text":"plot_hurricanes invisibly returns ggplot2 object pre-defined hurricane data chart using data get_hurricanes. default chart also displayed. Smooths using ggplot2's built-loess smoother. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_hurricanes.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_hurricanes","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_hurricanes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_hurricanes","text":"","code":"# \\donttest{ # Fetch hurricane data: hurricanes <- get_hurricanes() # # Plot output using package's built-in ggplot2 defaults plot_hurricanes(hurricanes) # Or just call plot_hurricanes(), which defaults to get_hurricanes() dataset plot_hurricanes() p <- plot_hurricanes(hurricanes, print = FALSE) p + ggplot2::labs(title='Growing number of North Atlantic named storms') # } #> `geom_smooth()` using method = 'loess' and formula 'y ~ x'"},{"path":"/reference/plot_icecurves.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_icecurves","title":"Download and plot essential climate data — plot_icecurves","text":"Plots monthly Sea Ice Index data retrieved using get_icecurves() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_icecurves.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_icecurves","text":"","code":"plot_icecurves(dataset = get_icecurves(), region = \"Arctic\", print = TRUE)"},{"path":"/reference/plot_icecurves.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_icecurves","text":"dataset Name tibble generated get_icecurves, defaults calling get_icecurves region Used chart title, defaults \"Arctic\" print (boolean) Display sea ice ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_icecurves.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_icecurves","text":"Invisibly returns ggplot2 object Sea Ice Index chart","code":""},{"path":"/reference/plot_icecurves.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_icecurves","text":"plot_icecurves invisibly returns ggplot2 object pre-defined Sea Ice Index chart using data get_icecurves. default chart also displayed. Users may modify output ggplot2 chart. Chart consists one line per year showing monthly sea ice January December. Current year highlighted.","code":""},{"path":"/reference/plot_icecurves.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_icecurves","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_icecurves.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_icecurves","text":"","code":"# \\donttest{ # Fetch historic monthly sea ice data since 1979: icecurves <- get_icecurves() #> Please set use_cache=FALSE if you are changing pole or measure from last cached data. # # Plot output using package's built-in ggplot2 defaults plot_icecurves(icecurves) # Or just call plot_icecurves(), which defaults to get_icecurves() dataset plot_icecurves() #> Please set use_cache=FALSE if you are changing pole or measure from last cached data. p <- plot_icecurves(icecurves, print = FALSE) p + ggplot2::labs(title='Shrinking Arctic Sea Ice') # }"},{"path":"/reference/plot_paleo.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_paleo","title":"Download and plot essential climate data — plot_paleo","text":"Plots Vostok ice core data retrieved using get_paleo() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_paleo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_paleo","text":"","code":"plot_paleo(dataset = get_paleo(), print = TRUE)"},{"path":"/reference/plot_paleo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_paleo","text":"dataset Name tibble generated get_paleo, defaults calling get_paleo print (boolean) Display Vostok ice core ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_paleo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_paleo","text":"Invisibly returns ggplot2 object Vostok chart","code":""},{"path":"/reference/plot_paleo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_paleo","text":"plot_paleo invisibly returns ggplot2 object pre-defined Vostok ice core chart using data get_paleo. returned chart stacks carbon dioxide concentration temperature 420,000 years. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_paleo.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — plot_paleo","text":"Barnola, J.-M., D. Raynaud, C. Lorius, N.. Barkov. 2003. Historical CO2 record Vostok ice core. Trends: Compendium Data Global Change. Carbon Dioxide Information Analysis Center, Oak Ridge National Laboratory, U.S. Department Energy, Oak Ridge, Tenn., U.S.","code":""},{"path":"/reference/plot_paleo.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_paleo","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_paleo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_paleo","text":"","code":"# \\donttest{ # Fetch Vostok data: vostok <- get_paleo() #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) # # Plot output using package's built-in ggplot2 defaults plot_paleo(vostok) # Or just call plot_paleo(), which defaults to get_paleo() dataset plot_paleo() #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) p <- plot_paleo(vostok, print = FALSE) p + patchwork::plot_annotation(title='A Long History of Carbon') # }"},{"path":"/reference/plot_seaice.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_seaice","title":"Download and plot essential climate data — plot_seaice","text":"Plots Sea Ice Index data retrieved using get_seaice() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_seaice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_seaice","text":"","code":"plot_seaice(dataset = get_seaice(), title = \"Arctic Sea Ice\", print = TRUE)"},{"path":"/reference/plot_seaice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_seaice","text":"dataset Name tibble generated get_seaice, defaults calling get_seaice title chart title, defaults Arctic Sea Ice print (boolean) Display sea ice ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_seaice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_seaice","text":"Invisibly returns ggplot2 object Sea Ice Index chart","code":""},{"path":"/reference/plot_seaice.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_seaice","text":"plot_seaice invisibly returns ggplot2 object pre-defined Sea Ice Index chart using data get_seaice. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_seaice.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_seaice","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_seaice.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_seaice","text":"","code":"# \\donttest{ # Fetch sea ice data: seaice <- get_seaice() #> Please set use_cache=FALSE if you are changing pole, month, or measure from last cached data. # # Plot output using package's built-in ggplot2 defaults plot_seaice(seaice) # Or just call plot_seaice(), which defaults to get_seaice() dataset plot_seaice() #> Please set use_cache=FALSE if you are changing pole, month, or measure from last cached data. p <- plot_seaice(seaice, print = FALSE) p + ggplot2::labs(title='Shrinking Arctic Sea Ice') # } #> `geom_smooth()` using formula 'y ~ x'"},{"path":"/reference/plot_sealevel.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_sealevel","title":"Download and plot essential climate data — plot_sealevel","text":"Plots global mean sea level data retrieved using get_sealevel() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_sealevel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_sealevel","text":"","code":"plot_sealevel(dataset = get_sealevel(), print = TRUE)"},{"path":"/reference/plot_sealevel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_sealevel","text":"dataset Name tibble generated get_sealevel, defaults calling get_sealevel print (boolean) Display sealevel ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_sealevel.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_sealevel","text":"Invisibly returns ggplot2 object sealevel chart","code":""},{"path":"/reference/plot_sealevel.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_sealevel","text":"plot_sealevel invisibly returns ggplot2 object pre-defined sealevel change chart using data get_sealevel. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_sealevel.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_sealevel","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_sealevel.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_sealevel","text":"","code":"# \\donttest{ # Fetch sealevel data: gmsl <- get_sealevel() # # Plot output using package's built-in ggplot2 defaults plot_sealevel(gmsl) # Or just call plot_sealevel(), which defaults to get_sealevel() dataset plot_sealevel() p <- plot_sealevel(gmsl, print = FALSE) p + ggplot2::labs(title='Rising Waters') # }"},{"path":"/reference/plot_temp.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_temp","title":"Download and plot essential climate data — plot_temp","text":"Plots global temperature anomaly retrieved using get_temp() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_temp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_temp","text":"","code":"plot_temp(dataset = get_temp(), print = TRUE)"},{"path":"/reference/plot_temp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_temp","text":"dataset Name tibble generated get_temp print (boolean) Display temperature anomaly ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_temp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_temp","text":"Invisibly returns ggplot2 object temperature anomaly chart","code":""},{"path":"/reference/plot_temp.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_temp","text":"plot_temp invisibly returns ggplot2 object pre-defined temperature anomaly chart using data get_temp. default chart also displayed. Smooths using ggplot2's built-loess smoother. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_temp.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_temp","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_temp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_temp","text":"","code":"# \\donttest{ # Fetch temperature anomaly: anomaly <- get_temp() # # Plot output using package's built-in ggplot2 defaults plot_temp(anomaly) # Or just call plot_temp(), which defaults to get_temp() dataset plot_temp() p <- plot_temp(anomaly, print = FALSE) p + ggplot2::labs(title='The Signature of Climate Change') # } #> `geom_smooth()` using method = 'loess' and formula 'y ~ x'"},{"path":"/reference/plot_temp2k.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_temp2k","title":"Download and plot essential climate data — plot_temp2k","text":"Plots Common Era 2000-year global temperature anomaly retrieved using get_temp2k() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_temp2k.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_temp2k","text":"","code":"plot_temp2k( dataset = get_temp2k(), instrumental = TRUE, filtered = TRUE, print = TRUE )"},{"path":"/reference/plot_temp2k.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_temp2k","text":"dataset Name tibble generated get_temp2k instrumental (boolean) Include Cowtan & Way instrumental temperatures 2017. Defaults TRUE. filtered (boolean) Use filtered temperatures provided PAGES2k Consortium. Temperatures filtered using 31-year Butterworth filter. Defaults TRUE. print (boolean) Display temperature anomaly ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_temp2k.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_temp2k","text":"Invisibly returns ggplot2 object temperature anomaly chart","code":""},{"path":"/reference/plot_temp2k.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_temp2k","text":"plot_temp2k invisibly returns ggplot2 object pre-defined temperature anomaly chart using data get_temp2k. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_temp2k.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_temp2k","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_temp2k.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_temp2k","text":"","code":"# \\donttest{ # Fetch temperature anomaly: anomaly <- get_temp2k() # # Plot output using package's built-in ggplot2 defaults plot_temp2k(anomaly) # Or just call plot_temp2k(), which defaults to get_temp2k() dataset plot_temp2k() p <- plot_temp2k(anomaly, print = FALSE) p + ggplot2::labs(title='Temperature Increase in the Common Era') # } #> Warning: Removed 1926 row(s) containing missing values (geom_path)."},{"path":"/reference/print.hockeystick_cache_info.html","id":null,"dir":"Reference","previous_headings":"","what":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","title":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","text":"Display data cache info Shows filenames cache file sizes","code":""},{"path":"/reference/print.hockeystick_cache_info.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","text":"","code":"# S3 method for hockeystick_cache_info print(x, ...)"},{"path":"/reference/print.hockeystick_cache_info.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","text":"x filenames ... Additional parameters","code":""},{"path":"/reference/print.hockeystick_cache_info.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","text":"Display data cache info. return value, called side effect.","code":""},{"path":"/reference/warming_stripes.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — warming_stripes","title":"Download and plot essential climate data — warming_stripes","text":"Plots global \"warming stripes\" graph style popularized Ed Hawkins, based temperature anomaly retrieved using get_temp(). Function can output stripes chart legend minimal chart. output ggplot2 object may modified.","code":""},{"path":"/reference/warming_stripes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — warming_stripes","text":"","code":"warming_stripes( dataset = get_temp(), stripe_only = FALSE, col_strip = RColorBrewer::brewer.pal(11, \"RdBu\"), print = TRUE )"},{"path":"/reference/warming_stripes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — warming_stripes","text":"dataset Name tibble generated get_temp stripe_only Display legend axes, defaults TRUE col_strip Color palette use. Defaults Red-Blue RColorBrewer palette. print (boolean) Display warming stripe ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/warming_stripes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — warming_stripes","text":"Invisibly returns ggplot2 object warming stripes","code":""},{"path":"/reference/warming_stripes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — warming_stripes","text":"warming_stripes invisibly returns ggplot2 object warming stripes chart using data get_temp. default chart also displayed. User may modify color palette remove axes legend. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/warming_stripes.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — warming_stripes","text":"Climate Lab. 2018. https://www.climate-lab-book.ac.uk/2018/warming-stripes/ GISS Surface Temperature Analysis (GISTEMP v4): https://data.giss.nasa.gov/gistemp/ GISTEMP Team, 2020: GISS Surface Temperature Analysis (GISTEMP), version 4. NASA Goddard Institute Space Studies. Dr. Dominic Roye blog post \"Create Warming Stripes R\": https://dominicroye.github.io/en/2018/--create-warming-stripes--r/","code":""},{"path":"/reference/warming_stripes.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — warming_stripes","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/warming_stripes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — warming_stripes","text":"","code":"# \\donttest{ # Draw with axes and legend stripes <- warming_stripes() # Draw stripes only stripes <- warming_stripes(stripe_only = TRUE) # Don't display, store for further modifications stripes <- warming_stripes(print = FALSE) # Change color palette stripes <- warming_stripes(stripe_only = TRUE, col_strip = viridisLite::viridis(11)) # }"},{"path":"/news/index.html","id":"hockeystick-0009000","dir":"Changelog","previous_headings":"","what":"hockeystick 0.0.0.9000","title":"hockeystick 0.0.0.9000","text":"Added NEWS.md file track changes package.","code":""},{"path":"/news/index.html","id":"hockeystick-010","dir":"Changelog","previous_headings":"","what":"hockeystick 0.1.0","title":"hockeystick 0.1.0","text":"Five datasets warming stripes included package","code":""},{"path":"/news/index.html","id":"hockeystick-020","dir":"Changelog","previous_headings":"","what":"hockeystick 0.2.0","title":"hockeystick 0.2.0","text":"Add climate_grid() hockeystick_update_all()","code":""},{"path":"/news/index.html","id":"hockeystick-030","dir":"Changelog","previous_headings":"","what":"hockeystick 0.3.0","title":"hockeystick 0.3.0","text":"Add get_icecurves() plot_icecurves() visualize current historic sea ice","code":""},{"path":"/news/index.html","id":"hockeystick-034","dir":"Changelog","previous_headings":"","what":"hockeystick 0.3.4","title":"hockeystick 0.3.4","text":"Don’t cache data default, added write_cache options","code":""},{"path":"/news/index.html","id":"hockeystick-040","dir":"Changelog","previous_headings":"","what":"hockeystick 0.4.0","title":"hockeystick 0.4.0","text":"CRAN release: 2021-02-05 Add get_temp2k() plot_temp2k() visualize global Common Era reconstructed temp","code":""},{"path":"/news/index.html","id":"hockeystick-050","dir":"Changelog","previous_headings":"","what":"hockeystick 0.5.0","title":"hockeystick 0.5.0","text":"CRAN release: 2021-04-14 Add Atlantic hurricane data, get_hurricanes(), plot_hurricanes(), plot_hurricane_nrg()","code":""},{"path":"/news/index.html","id":"hockeystick-051","dir":"Changelog","previous_headings":"","what":"hockeystick 0.5.1","title":"hockeystick 0.5.1","text":"CRAN release: 2021-05-18 Update caching approach comply CRAN policies","code":""},{"path":"/news/index.html","id":"hockeystick-052","dir":"Changelog","previous_headings":"","what":"hockeystick 0.5.2","title":"hockeystick 0.5.2","text":"Add date/value annotations charts","code":""},{"path":"/news/index.html","id":"hockeystick-060","dir":"Changelog","previous_headings":"","what":"hockeystick 0.6.0","title":"hockeystick 0.6.0","text":"Add global emissions GCP: get_emissions(), plot_emissions()","code":""},{"path":"/news/index.html","id":"hockeystick-061","dir":"Changelog","previous_headings":"","what":"hockeystick 0.6.1","title":"hockeystick 0.6.1","text":"CRAN release: 2021-09-20 Fix leaving example data cache","code":""},{"path":"/news/index.html","id":"hockeystick-062","dir":"Changelog","previous_headings":"","what":"hockeystick 0.6.2","title":"hockeystick 0.6.2","text":"Update documentation confirm R version 4.2","code":""}] +[{"path":"/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2020 Hernando Cortina Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":"/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Hernando Cortina. Author, maintainer.","code":""},{"path":"/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Hernando Cortina. hockeystick: Download Visualize Essential Climate Change Data (2020)","code":"@Manual{, title = {hockeystick: Download and Visualize Essential Climate Change Data}, author = {Hernando Cortina}, year = {2020}, url = {https://cortinah.github.io/hockeystick/}, }"},{"path":"/index.html","id":"hockeystick-","dir":"","previous_headings":"","what":"Download and Visualize Essential Climate Change Data","title":"Download and Visualize Essential Climate Change Data","text":"goal hockeystick make essential Climate Change datasets easily available non-climate experts. hockeystick users can download latest raw data authoritative sources well view via pre-defined ggplot2 charts. Datasets include atmospheric CO2, instrumental, reconstructed, paleo ice-core temperature records, sea levels, Arctic/Antarctic sea-ice. choice data originally based Professor Stefan Rahmstorf’s presentation 5 Important Data Sets Climate Science. came across post Open Mind blog. wrote post obtaining visualizing data (now date), basis package. Additional datasets visualizations added name package stems well known hockeystick temperature chart. hockeystick highlighted RStudio RViews blog Joseph Rickert one “Top 40” new packages CRAN February 2021. NEW version 0.5.0: North Atlantic hurricane data NOAA. NEW version 0.6.0: Global CO2 emissions region country GCP (see ).","code":""},{"path":"/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Download and Visualize Essential Climate Change Data","text":"install latest hockeystick release CRAN type: may alternatively install development version https://github.com/cortinah/hockeystick :","code":"install.packages(\"hockeystick\") remotes::install_github(\"cortinah/hockeystick\")"},{"path":"/index.html","id":"downloading-and-viewing-climate-change-data","dir":"","previous_headings":"","what":"Downloading and viewing climate change data","title":"Download and Visualize Essential Climate Change Data","text":"Retrieve NOAA/ESRL Mauna Loa CO2 Observatory concentration data plot: Retrieve GCP global CO2 emissions plot: Retrieve NASA/GISS global surface temperature anomaly data plot: Visualize warming using Ed Hawkins styled “warming stripes”: Retrieve tide gauge satellite sea level data plot: Retrieve July annual Arctic Sea Ice Index plot: get_seaice() arguments can modified download Antarctic sea ice, allow month. can also visualize sea ice month year: Retrieve Common Era temperature reconstruction plot instrumental record: Retrieve NOAA HURDAT2 hurricane data plot: Retrieve Vostok paleo ice core data plot:","code":"library(hockeystick) ml_co2 <- get_carbon() plot_carbon(ml_co2) emissions <- get_emissions() plot_emissions(emissions) anomaly <- get_temp() plot_temp(anomaly) warming_stripes() warming_stripes(stripe_only = TRUE, col_strip = viridisLite::viridis(11)) gmsl <- get_sealevel() plot_sealevel(gmsl) seaice <- get_seaice() plot_seaice(seaice) arcticice <- get_icecurves() plot_icecurves(arcticice) anomaly2k <- get_temp2k() plot_temp2k(anomaly2k) hurricanes <- get_hurricanes() plot_hurricanes(hurricanes) plot_hurricane_nrg(hurricanes) vostok <- get_paleo() plot_paleo(vostok)"},{"path":"/index.html","id":"managing-the-cache","dir":"","previous_headings":"Downloading and viewing climate change data","what":"Managing the cache","title":"Download and Visualize Essential Climate Change Data","text":"default, climate data cached, data downloaded every time get_ functions called. cache data future use, use write_cache = TRUE option, available get_ functions. download cache data use hockeystick_update_all(). view files, date, size cached data use hockeystick_cache_details(). re-download data source use use_cache = FALSE argument get_ functions, example: get_carbon(use_cache = FALSE, write_cache = TRUE). delete cached data use hockeystick_cache_delete_all(). Users may also cache data default adding options(hs_write_cache = TRUE)script .Rprofile file.","code":""},{"path":"/index.html","id":"all-together-now-climate-data-grid","dir":"","previous_headings":"Downloading and viewing climate change data","what":"All together now: climate data grid","title":"Download and Visualize Essential Climate Change Data","text":"","code":"climate_grid()"},{"path":"/index.html","id":"acknowledgments","dir":"","previous_headings":"","what":"Acknowledgments","title":"Download and Visualize Essential Climate Change Data","text":"Carbon Dioxide concentrations: Dr. Pieter Tans, NOAA/GML (https://gml.noaa.gov/ccgg/trends/) Dr. Ralph Keeling, Scripps Institution Oceanography. Global temperature anomaly: GISS Surface Temperature Analysis (GISTEMP), version 4. GISTEMP Team, 2020: NASA Goddard Institute Space Studies. https://data.giss.nasa.gov/gistemp/ Warming Stripes design Ed Hawkins’ Climate Lab. https://www.climate-lab-book.ac.uk/2018/warming-stripes/. addition grateful Dr. Dominic Royé posting approach plotting using ggplot2, warming_stripes() based . https://dominicroye.github.io/en/2018/--create-warming-stripes--r/ Sea level data: NOAA Laboratory Satellite Altimetry (sat) Commonwealth Scientific Industrial Research Organisation (tide gauges) Sea Ice Index: National Snow & Ice Data Center. Data Archive: https://nsidc.org/data/seaice_index/archives Vostok carbon dioxide temperature data: https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html Common Era reconstructed temperature data: PAGES2k Consortium NOAA. Hurricanes: National Oceanic Atmospheric Administration HURDAT Atlantic Hurricane Database Re-analysis Project, particularly Dr. Chris Landsea. Carbon Dioxide emissions: Global Carbon Project World Data","code":""},{"path":"/index.html","id":"notes-and-resources","dir":"","previous_headings":"","what":"Notes and resources","title":"Download and Visualize Essential Climate Change Data","text":"data compiled best ability reliable peer-reviewed sources. Please open issue aware enhanced additional data may added package. Building hockeystick driven interest tracking climate data making easily available community. online resources found helpful learn climate science: MIT edX Global Warming Science. https://www.edx.org/course/global-warming-science SDG Academy: Climate Change: Science Global Impact. https://sdgacademy.org/course/climate-change--science--global-impact/","code":""},{"path":"/reference/climate_grid.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — climate_grid","title":"Download and plot essential climate data — climate_grid","text":"Plots 2x2 grid carbon, temperature, sea ice, sea level charts.","code":""},{"path":"/reference/climate_grid.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — climate_grid","text":"","code":"climate_grid(print = TRUE)"},{"path":"/reference/climate_grid.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — climate_grid","text":"print (boolean) Display climate grid ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/climate_grid.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — climate_grid","text":"Invisibly returns ggplot2 object climate grid","code":""},{"path":"/reference/climate_grid.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — climate_grid","text":"warming_stripes invisibly returns ggplot2 object 2x2 grid carbon, temperature, sea ice, sea level charts get_carbon, get_temp, get_seaice, get_sealevel. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/climate_grid.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — climate_grid","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/climate_grid.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — climate_grid","text":"","code":"# \\donttest{ # Draw grid grid <- climate_grid() # }"},{"path":"/reference/file_info_.html","id":null,"dir":"Reference","previous_headings":"","what":"Display cached file info — file_info_","title":"Display cached file info — file_info_","text":"Internal function","code":""},{"path":"/reference/file_info_.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display cached file info — file_info_","text":"","code":"file_info_(x)"},{"path":"/reference/file_info_.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display cached file info — file_info_","text":"x filenames","code":""},{"path":"/reference/get_carbon.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_carbon","title":"Download and plot essential climate data — get_carbon","text":"Retrieves atmospheric carbon dioxide measurements National Oceanic Atmospheric Administration Earth System Research Laboratories monitoring laboratory Mauna Loa, Hawaii. https://gml.noaa.gov/ccgg/trends/data.html","code":""},{"path":"/reference/get_carbon.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_carbon","text":"","code":"get_carbon(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_carbon.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_carbon","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_carbon.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_carbon","text":"Invisibly returns tibble monthly carbon dioxide series","code":""},{"path":"/reference/get_carbon.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — get_carbon","text":"get_carbon invisibly returns tibble NOAA's monthly average carbon dioxide measurement. returned object includes date, year, month, average, trend, std dev, uncertainty columns. Trend NOAA's published trend. Please refer website details.","code":""},{"path":"/reference/get_carbon.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_carbon","text":"Dr. Pieter Tans, NOAA/GML https://gml.noaa.gov/ccgg/trends/ Dr. Ralph Keeling, Scripps Institution Oceanography https://scrippsco2.ucsd.edu/. C.D. Keeling, R.B. Bacastow, .E. Bainbridge, C.. Ekdahl, P.R. Guenther, L.S. Waterman, (1976), Atmospheric carbon dioxide variations Mauna Loa Observatory, Hawaii, Tellus, vol. 28, 538-551","code":""},{"path":"/reference/get_carbon.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_carbon","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_carbon.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_carbon","text":"","code":"# \\donttest{ # Fetch from cache if available, otherwise download: maunaloa <- get_carbon() # # Force fetch from source: maunaloa <- get_carbon(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_carbon(maunaloa) # }"},{"path":"/reference/get_emissions.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_emissions","title":"Download and plot essential climate data — get_emissions","text":"Retrieves Global Carbon Project (GCP) annual global carbon dioxide emissions since 1750 World Data repository https://github.com/owid/co2-data","code":""},{"path":"/reference/get_emissions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_emissions","text":"","code":"get_emissions(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_emissions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_emissions","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_emissions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_emissions","text":"Invisibly returns tibble annual carbon dioxide emissions","code":""},{"path":"/reference/get_emissions.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — get_emissions","text":"get_emissions invisibly returns tibble GCP's annual carbon dioxide emissions aggregate every nation. returned object includes ISO code, country, year, co2 emissions, growth rates, per capita, decompositions industry gas type. Please refer website details.","code":""},{"path":"/reference/get_emissions.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_emissions","text":"https://www.globalcarbonproject.org/carbonbudget/20/data.htm Friedlingstein, P. et al (2020), Global Carbon Budget 2020, Earth System Science Data, vol. 12, 3269-3340 doi:10.5194/essd-12-3269-2020","code":""},{"path":"/reference/get_emissions.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_emissions","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_emissions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_emissions","text":"","code":"# \\donttest{ # Fetch from cache if available: emissions <- get_emissions() # # Force cache refresh: emissions <- get_emissions(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_emissions(emissions) # }"},{"path":"/reference/get_hurricanes.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_hurricanes","title":"Download and plot essential climate data — get_hurricanes","text":"Retrieves Atlantic basin hurricane data since 1851 National Oceanic Atmospheric Administration HURDAT Atlantic Hurricane Database Re-analysis Project. https://www.aoml.noaa.gov/hrd/hurdat/Data_Storm.html","code":""},{"path":"/reference/get_hurricanes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_hurricanes","text":"","code":"get_hurricanes(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_hurricanes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_hurricanes","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_hurricanes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_hurricanes","text":"Invisibly returns tibble annual HURDAT hurricane data since 1851","code":""},{"path":"/reference/get_hurricanes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — get_hurricanes","text":"get_hurricanes invisibly returns tibble NOAA's annual North Atlantic revised HURDAT hurricane data since 1851. returned object includes Year, number named storms, hurricanes, major hurricanes (S-S scale 3-5), Accumulated Cyclone Energy (ACE), U.S. hurricane strikes. ACE index combines number systems, long existed intense became. calculated squaring maximum sustained surface wind system every six hours cyclone Named Storm summing season. Please refer website details.","code":""},{"path":"/reference/get_hurricanes.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_hurricanes","text":"HURDAT North Atlantic Hurricane Database Re-analysis Project, Hurricane Research Division, NOAA https://www.aoml.noaa.gov/hrd/hurdat/Data_Storm.html. Data : https://www.aoml.noaa.gov/hrd/hurdat/comparison_table.html https://en.wikipedia.org/wiki/Accumulated_cyclone_energy","code":""},{"path":"/reference/get_hurricanes.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_hurricanes","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_hurricanes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_hurricanes","text":"","code":"# \\donttest{ # Fetch from cache if available: hurricanes <- get_hurricanes() # # Force cache refresh: hurricanes <- get_hurricanes(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_hurricanes(hurricanes) # }"},{"path":"/reference/get_icecurves.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_icecurves","title":"Download and plot essential climate data — get_icecurves","text":"Retrieves Arctic Antarctic monthly Sea Ice Index time series (million square km). Source National Snow Ice Data Center, defaults Arctic (Northern Hemisphere) monthly sea ice extent since 1979. https://nsidc.org/data/seaice_index/archives","code":""},{"path":"/reference/get_icecurves.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_icecurves","text":"","code":"get_icecurves( pole = \"N\", measure = \"extent\", use_cache = TRUE, write_cache = getOption(\"hs_write_cache\") )"},{"path":"/reference/get_icecurves.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_icecurves","text":"pole 'N' Arctic 'S' Antarctic measure Must 'extent' 'area', defaults 'extent'. Please see terminology link references details. use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data, change pole month cache. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_icecurves.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_icecurves","text":"Invisibly returns tibble series monthly Sea Ice Index since 1979 (million square km). get_icecurves invisibly returns tibble time series monthly Sea Ice Index since 1979 (million square km). User may select monthly Arctic Antarctic sea ice extent area (millions square kilometers). Defaults Arctic sea ice extent. https://nsidc.org/arcticseaicenews/faq/#area_extent","code":""},{"path":"/reference/get_icecurves.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_icecurves","text":"NSIDC Data Archive: https://nsidc.org/data/seaice_index/archives Sea Ice: https://nsidc.org/cryosphere/seaice/index.html Sea Ice terminology: https://nsidc.org/cryosphere/seaice/data/terminology.html","code":""},{"path":"/reference/get_icecurves.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_icecurves","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_icecurves.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_icecurves","text":"","code":"# \\donttest{ # Fetch monthly sea ice history from cache if available: icecurves <- get_icecurves() #> Please set use_cache=FALSE if you are changing pole or measure from last cached data. # # Force cache refresh: icecurves <- get_icecurves(use_cache = FALSE) # change region south_icecurves <- get_icecurves(pole='S', use_cache = FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_icecurves(icecurves) # }"},{"path":"/reference/get_paleo.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_paleo","title":"Download and plot essential climate data — get_paleo","text":"Retrieves historical carbon dioxide temperature records Vostok ice core past 420,000 years. Source data U.S. Department Energy’s (DOE) Environmental System Science Data Infrastructure Virtual Ecosystem (ESS-DIVE). https://ess-dive.lbl.gov/ https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html","code":""},{"path":"/reference/get_paleo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_paleo","text":"","code":"get_paleo(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_paleo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_paleo","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_paleo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_paleo","text":"Invisibly returns tibble age ice (years C.E.), carbon dioxide (ppm) temperature (degrees C). get_paleo invisibly returns tibble Vostok ice core data: age ice (years C.E.), carbon dioxide (ppm) temperature (degrees C). Data : Barnola J; Raynaud D; Lorius C; Barkov N (2003): Historical Carbon Dioxide Record Vostok Ice Core (417,160 - 2,342 years BP) Petit J R ; Raynaud D ; Lorius C ; Delaygue G ; Jouzel J ; Barkov N ; Kotlyakov V M (2000): Historical Isotopic Temperature Record Vostok Ice Core. CDIAC.","code":""},{"path":"/reference/get_paleo.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_paleo","text":"Historical Carbon Dioxide Record Vostok Ice Core (US Dept Energy): https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html Petit J R ; Raynaud D ; Lorius C ; Delaygue G ; Jouzel J ; Barkov N ; Kotlyakov V M (2000): Historical Isotopic Temperature Record Vostok Ice Core. CDIAC. doi:10.3334/CDIAC/CLI.006. https://data.ess-dive.lbl.gov/view/doi:10.3334/CDIAC/CLI.006 Barnola J ; Raynaud D ; Lorius C ; Barkov N (2003): Historical Carbon Dioxide Record Vostok Ice Core (417,160 - 2,342 years BP). None. doi:10.3334/CDIAC/ATG.009 https://data.ess-dive.lbl.gov/view/doi:10.3334/CDIAC/ATG.009","code":""},{"path":"/reference/get_paleo.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_paleo","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_paleo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_paleo","text":"","code":"# \\donttest{ # Fetch Vostok paleo carbon and temperature data from cache if available: vostok <- get_paleo() #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) # # Force cache refresh: vostok <- get_paleo(use_cache=FALSE) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_paleo(vostok) # }"},{"path":"/reference/get_seaice.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_seaice","title":"Download and plot essential climate data — get_seaice","text":"Retrieves Arctic Antarctic annual Sea Ice Index (million square km). Source National Snow Ice Data Center, defaults Arctic (Northern Hemisphere) July sea ice extent. https://nsidc.org/data/seaice_index/archives","code":""},{"path":"/reference/get_seaice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_seaice","text":"","code":"get_seaice( pole = \"N\", month = \"07\", measure = \"extent\", use_cache = TRUE, write_cache = getOption(\"hs_write_cache\") )"},{"path":"/reference/get_seaice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_seaice","text":"pole 'N' Arctic 'S' Antarctic month 2-digit month retrieve sea ice , defaults '07' (July) measure Must 'extent' 'area', defaults 'extent'. Please see terminology link references details. use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data, change pole month cache. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_seaice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_seaice","text":"Invisibly returns tibble annual series monthly Sea Ice Index since 1979 (million square km). get_seaice invisibly returns tibble annual series monthly Sea Ice Index since 1979 (million square km). User may select Arctic Antarctic sea ice extent area (millions square kilometers) year given month, specified argument month. Defaults Arctic July sea ice extent. https://nsidc.org/arcticseaicenews/faq/#area_extent","code":""},{"path":"/reference/get_seaice.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_seaice","text":"NSIDC Data Archive: https://nsidc.org/data/seaice_index/archives Sea Ice: https://nsidc.org/cryosphere/seaice/index.html Sea Ice terminology: https://nsidc.org/cryosphere/seaice/data/terminology.html","code":""},{"path":"/reference/get_seaice.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_seaice","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_seaice.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_seaice","text":"","code":"# \\donttest{ # Fetch sea ice from cache if available: seaice <- get_seaice() #> Please set use_cache=FALSE if you are changing pole, month, or measure from last cached data. # # Force cache refresh: seaice <- get_seaice(use_cache = FALSE) # change region and month seaice <- get_seaice(pole='S', month='09', use_cache = FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_seaice(seaice) # }"},{"path":"/reference/get_sealevel.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_sealevel","title":"Download and plot essential climate data — get_sealevel","text":"Retrieves global mean sea level (GMSL) data historic tide gauge recent satellite altimeter observations (mm). Source tide gauge data Commonwealth Scientific Industrial Research Organisation (CSIRO) described Church White (2011). https://research.csiro.au/slrwavescoast/sea-level/measurements--data/sea-level-data/ Source satellite data NOAA Laboratory Satellite Altimetry: https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/","code":""},{"path":"/reference/get_sealevel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_sealevel","text":"","code":"get_sealevel(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_sealevel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_sealevel","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_sealevel.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_sealevel","text":"Invisibly returns tibble global mean sea level time series (mm) 1880-2013 using tide gauges since 1993 satellite measurements. get_sealevel invisibly returns tibble mean sea level mm time series tide gauges satellite observations. satellite observations releveled mean level 1993 matches tide gauges. tide gauge data longer updated cover period 1880 2013, per Church, J. . N.J. White (2011) https://research.csiro.au/slrwavescoast/sea-level/measurements--data/sea-level-data/ Satellite data updated monthly frequently NOAA Laboratory Satellite Altimetry. TOPEX Jason-1,-2,-3 satellites dataset, seasonal signals removed. https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/","code":""},{"path":"/reference/get_sealevel.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_sealevel","text":"CSIRO reconstructed tide gauge GMSL 1880 2009: https://research.csiro.au/slrwavescoast/sea-level/measurements--data/sea-level-data/ Church, J. . N.J. White (2011), Sea-level rise late 19th early 21st Century. Surveys Geophysics, doi:10.1007/s10712-011-9119-1. https://link.springer.com/article/10.1007/s10712-011-9119-1 NOAA Laboratory Satellite Altimetry https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/","code":""},{"path":"/reference/get_sealevel.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_sealevel","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_sealevel.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_sealevel","text":"","code":"# \\donttest{ # Fetch sea level from cache if available: gmsl <- get_sealevel() # # Force cache refresh: gmsl <- get_sealevel(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_sealevel(gmsl) # }"},{"path":"/reference/get_temp.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_temp","title":"Download and plot essential climate data — get_temp","text":"Retrieves combined global land- sea-surface temperature anomaly (Land-Ocean Temperature Index, LOTI). Source NASA/GISS Surface Temperature Analysis (GISTEMP v4), estimate global surface temperature change. https://data.giss.nasa.gov/gistemp/","code":""},{"path":"/reference/get_temp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_temp","text":"","code":"get_temp(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_temp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_temp","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_temp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_temp","text":"Invisibly returns tibble annual mean monthly Combined Land-Surface Air Sea-Surface Water Temperature Anomalies. get_temp invisibly returns tibble NASA/GISS annual mean monthly global temperature anomaly. Data global 1880 present, represent deviations 1951-1980 mean. returned object includes monthly annual average anomalies, well seasonal anomalies. GISS Surface Temperature Analysis (GISTEMP v4) estimate global surface temperature change. Data updated around middle every month using current data files NOAA GHCN v4 (meteorological stations) ERSST v5 (ocean areas). Station data combined described Hansen et al. (2010) https://data.giss.nasa.gov/gistemp/references.html Lenssen et al. (2019) https://pubs.giss.nasa.gov/abs/le05800h.html","code":""},{"path":"/reference/get_temp.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_temp","text":"GISS Surface Temperature Analysis (GISTEMP v4): https://data.giss.nasa.gov/gistemp/ GISTEMP Team, 2020: GISS Surface Temperature Analysis (GISTEMP), version 4. NASA Goddard Institute Space Studies. Lenssen, N., G. Schmidt, J. Hansen, M. Menne, . Persin, R. Ruedy, D. Zyss, 2019: Improvements GISTEMP uncertainty model. J. Geophys. Res. Atmos., 124, . 12, 6307-6326, doi:10.1029/2018JD029522. https://pubs.giss.nasa.gov/abs/le05800h.html","code":""},{"path":"/reference/get_temp.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_temp","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_temp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_temp","text":"","code":"# \\donttest{ # Fetch temp anomaly from cache if available: anomaly <- get_temp() # # Force cache refresh: anomaly <- get_temp(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_temp(anomaly) # }"},{"path":"/reference/get_temp2k.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — get_temp2k","title":"Download and plot essential climate data — get_temp2k","text":"Retrieves Common Era Global Surface Temperature Reconstructions. Source PAGES2k Consortium NOAA National Centers Environmental Information. https://www.ncdc.noaa.gov/paleo-search/study/26872","code":""},{"path":"/reference/get_temp2k.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — get_temp2k","text":"","code":"get_temp2k(use_cache = TRUE, write_cache = getOption(\"hs_write_cache\"))"},{"path":"/reference/get_temp2k.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — get_temp2k","text":"use_cache (boolean) Return cached data available, defaults TRUE. Use FALSE fetch updated data. write_cache (boolean) Write data cache, defaults FALSE. Use TRUE write data cache later use. Can also set using options(hs_write_cache=TRUE)","code":""},{"path":"/reference/get_temp2k.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — get_temp2k","text":"Invisibly returns tibble filtered unfiltered temperature reconstructions Cowtan & Way instrumental temperatures. get_temp2k invisibly returns tibble PAGES2k Consortium temperature reconstruction (years 1-2000 CE) instrumental record (years 1850-2017 CE). Temperatures represent deviations 1961-1990 mean. returned object includes annual average temperature anomalies well filtered anomalies using 31-year Butterworth filter. Reconstructions use seven different statistical methods draw global collection temperature-sensitive palaeoclimate records. Methodology described PAGES2k (2019) https://www.nature.com/articles/s41561-019-0400-0","code":""},{"path":"/reference/get_temp2k.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — get_temp2k","text":"PAGES2k Common Era Surface Temperature Reconstructions. https://www.ncdc.noaa.gov/paleo-search/study/26872 PAGES 2k Consortium., Neukom, R., Barboza, L.. et al. Consistent multidecadal variability global temperature reconstructions simulations Common Era. Nat. Geosci. 12, 643–649 (2019). doi:10.1038/s41561-019-0400-0","code":""},{"path":"/reference/get_temp2k.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — get_temp2k","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/get_temp2k.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — get_temp2k","text":"","code":"# \\donttest{ # Fetch temp anomaly from cache if available: anomaly <- get_temp2k() # # Force cache refresh: anomaly <- get_temp2k(use_cache=FALSE) # # Review cache contents and last update dates: hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # # Plot output using package's built-in ggplot2 settings plot_temp2k(anomaly) # }"},{"path":"/reference/getsize.html","id":null,"dir":"Reference","previous_headings":"","what":"Get rounded size of file in kB — getsize","title":"Get rounded size of file in kB — getsize","text":"Internal function","code":""},{"path":"/reference/getsize.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get rounded size of file in kB — getsize","text":"","code":"getsize(x)"},{"path":"/reference/getsize.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get rounded size of file in kB — getsize","text":"x filenames","code":""},{"path":"/reference/hockeystick-package.html","id":null,"dir":"Reference","previous_headings":"","what":"hockeystick: Download and Visualize Essential Climate Change Data — hockeystick-package","title":"hockeystick: Download and Visualize Essential Climate Change Data — hockeystick-package","text":"Provides easy access essential climate change datasets non-climate experts. Users can download latest raw data authoritative sources view via pre-defined 'ggplot2' charts. Datasets include atmospheric CO2, emissions, instrumental proxy temperature records, sea levels, Arctic/Antarctic sea-ice, Hurricanes, Paleoclimate data. Sources include: NOAA Mauna Loa Laboratory https://gml.noaa.gov/ccgg/trends/data.html, Global Carbon Project https://www.globalcarbonproject.org/carbonbudget/20/data.htm, NASA GISTEMP https://data.giss.nasa.gov/gistemp/, National Snow Sea Ice Data Center https://nsidc.org/data/seaice_index/archives, CSIRO https://research.csiro.au/slrwavescoast/sea-level/measurements--data/sea-level-data/, NOAA Laboratory Satellite Altimetry https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/ HURDAT Atlantic Hurricane Database https://www.aoml.noaa.gov/hrd/hurdat/Data_Storm.html, Vostok Paleo carbon dioxide temperature data: https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html.","code":""},{"path":[]},{"path":"/reference/hockeystick-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"hockeystick: Download and Visualize Essential Climate Change Data — hockeystick-package","text":"Maintainer: Hernando Cortina hch@alum.mit.edu (ORCID)","code":""},{"path":"/reference/hockeystick_cache.html","id":null,"dir":"Reference","previous_headings":"","what":"Manage cached datasets — hockeystick_cache","title":"Manage cached datasets — hockeystick_cache","text":"Manage cached datasets","code":""},{"path":"/reference/hockeystick_cache.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Manage cached datasets — hockeystick_cache","text":"","code":"hockeystick_cache_list() hockeystick_cache_delete(files, force = TRUE) hockeystick_cache_delete_all(force = TRUE) hockeystick_cache_details(files = NULL) hockeystick_update_all()"},{"path":"/reference/hockeystick_cache.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Manage cached datasets — hockeystick_cache","text":"files (character) one complete file names force (logical) files force deleted? Default: TRUE","code":""},{"path":"/reference/hockeystick_cache.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Manage cached datasets — hockeystick_cache","text":"hockeystick_cache_list() returns character vector full path filenames cache. hockeystick_cache_delete() return value, called side effect. hockeystick_cache_delete_all() return value, called side effect. hockeystick_cache_details() returns list filenames sizes cached files. hockeystick_update_all() updates datasets caches . return value, called side effect.","code":""},{"path":"/reference/hockeystick_cache.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Manage cached datasets — hockeystick_cache","text":"cache_delete accepts 1 file name, cache_delete_all accept names, deletes files. deleting many specific files, use cache_delete lapply() type call cache using tools::R_user_dir(), find cache folder executing tools::R_user_dir(\"hockeystick\",\"cache\")","code":""},{"path":"/reference/hockeystick_cache.html","id":"functions","dir":"Reference","previous_headings":"","what":"Functions","title":"Manage cached datasets — hockeystick_cache","text":"hockeystick_cache_list() returns character vector full path file names cache hockeystick_cache_delete() deletes one files, returns nothing hockeystick_cache_delete_all() delete files, returns nothing hockeystick_cache_details() prints file name file size file, supply one files, files (get details available) hockeystick_update_all() updates cache latest co2, temperature, sea level, sea ice data.","code":""},{"path":"/reference/hockeystick_cache.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Manage cached datasets — hockeystick_cache","text":"Caching data sets: ROpenSci guide persistent config data R packages: https://blog.r-hub.io/2020/03/12/user-preferences/","code":""},{"path":"/reference/hockeystick_cache.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Manage cached datasets — hockeystick_cache","text":"","code":"# \\donttest{ # list files in cache hockeystick_cache_list() #> character(0) # List info for single files hockeystick_cache_details(files = hockeystick_cache_list()[1]) #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> #> file: NA #> size: NA kB #> date: NA #> hockeystick_cache_details(files = hockeystick_cache_list()[2]) #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> #> file: NA #> size: NA kB #> date: NA #> # List info for all files hockeystick_cache_details() #> #> directory: /Users/hernandocortina/Library/Caches/org.R-project.R/R/hockeystick #> # Delete cached files by name hockeystick_cache_delete(files = hockeystick_cache_list()[1]) #> These files don't exist or can't be found: #> NAFALSE # Update all hockeystick data and place in cache hockeystick_update_all() # Delete all cached data hockeystick_cache_delete_all() # }"},{"path":"/reference/hscache_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Return path of data cache directory — hscache_path","title":"Return path of data cache directory — hscache_path","text":"Internal Function","code":""},{"path":"/reference/hscache_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Return path of data cache directory — hscache_path","text":"","code":"hscache_path()"},{"path":"/reference/hscache_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Return path of data cache directory — hscache_path","text":"Return path data cache directory","code":""},{"path":"/reference/plot_carbon.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_carbon","title":"Download and plot essential climate data — plot_carbon","text":"Plots carbon dioxide data retrieved using get_carbon() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_carbon.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_carbon","text":"","code":"plot_carbon(dataset = get_carbon(), print = TRUE, annot = TRUE)"},{"path":"/reference/plot_carbon.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_carbon","text":"dataset Name tibble generated get_carbon print (boolean) Display carbon dioxide ggplot2 chart, defaults TRUE. Use FALSE display chart. annot (boolean) Include chart annotation latest date value, defaults TRUE.","code":""},{"path":"/reference/plot_carbon.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_carbon","text":"Invisibly returns ggplot2 object carbon dioxide chart","code":""},{"path":"/reference/plot_carbon.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_carbon","text":"plot_carbon invisibly returns ggplot2 object pre-defined carbon dioxide chart using data get_carbon. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_carbon.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_carbon","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_carbon.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_carbon","text":"","code":"# \\donttest{ # Fetch carbon dioxide data: maunaloa <- get_carbon() # # Plot output using package's built-in ggplot2 defaults plot_carbon(maunaloa) # Or just call plot_carbon(), which defaults to get_carbon() dataset plot_carbon() p <- plot_carbon(maunaloa, print = FALSE) p + ggplot2::labs(title='The Keeling Curve') # }"},{"path":"/reference/plot_emissions.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_emissions","title":"Download and plot essential climate data — plot_emissions","text":"Plots carbon dioxide emissions retrieved using get_emissions() ggplot2. output ggplot2 object may modified. Alternative columns dataset may also plotted.","code":""},{"path":"/reference/plot_emissions.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_emissions","text":"","code":"plot_emissions( dataset = get_emissions(), start_year = 1900, region = \"OWID_WRL\", field = \"co2\", print = TRUE, annot = TRUE, title_expression = expression(\"Atmospheric \" * CO[2] * \" Emissions\"), yaxis_expression = expression(\"Gt \" * CO[2] * \" per year\") )"},{"path":"/reference/plot_emissions.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_emissions","text":"dataset Name tibble generated get_emissions start_year Year start plot . Defaults 1900. Data available since 1750. region ISO code region plot. Defaults 'OWID_WRL' signifies entire world. field Field GCP dataset plotted, defaults 'co2' print (boolean) Display carbon dioxide emissions ggplot2 chart, defaults TRUE. Use FALSE display chart. annot (boolean) Include chart annotation latest date value, defaults TRUE. title_expression Chart title, defaults CO2 emissions yaxis_expression y-axis label, defaults Gt CO2 emissions","code":""},{"path":"/reference/plot_emissions.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_emissions","text":"Invisibly returns ggplot2 object carbon dioxide emissions chart","code":""},{"path":"/reference/plot_emissions.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_emissions","text":"plot_emissions invisibly returns ggplot2 object pre-defined carbon dioxide emissions chart using data get_emissions. Use field parameter select alternative columns data set co2_per_capita. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_emissions.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_emissions","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_emissions.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_emissions","text":"","code":"# \\donttest{ # Fetch carbon dioxide emissions: emissions <- get_emissions() # Plot output using package's built-in ggplot2 defaults plot_emissions(emissions) # Or just call plot_emissions(), which defaults to get_emissions() dataset plot_emissions() # You can also select a region by ISO code and start year plot_emissions(region='USA', start_year=1950) p <- plot_emissions(emissions, print = FALSE) p + ggplot2::labs(title='Anthropogenic Carbon Emissions') # Plot a different field from GCP dataset plot_emissions(field='co2_per_capita', yaxis_expression=expression(CO[2]*' per capita' ))# }"},{"path":"/reference/plot_hurricane_nrg.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_hurricane_nrg","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"Plots hurricane energy data (ACE) retrieved using get_hurricanes() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"","code":"plot_hurricane_nrg(dataset = get_hurricanes(), print = TRUE)"},{"path":"/reference/plot_hurricane_nrg.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"dataset Name tibble generated get_hurricanes print (boolean) Display hurricane ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"Invisibly returns ggplot2 object hurricane energy chart","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"plot_hurricane_nrg invisibly returns ggplot2 object pre-defined hurricane energy data chart using data get_hurricanes. default chart also displayed. Smooths using ggplot2's built-loess smoother. Users may modify output ggplot2 chart. ACE index combines number systems, long existed intense became. calculated squaring maximum sustained surface wind system every six hours cyclone Named Storm summing season. Please refer website details.","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_hurricane_nrg.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_hurricane_nrg","text":"","code":"# \\donttest{ # Fetch hurricane data: hurricanes <- get_hurricanes() # # Plot output using package's built-in ggplot2 defaults plot_hurricane_nrg(hurricanes) # Or just call plot_hurricane_nrg(), which defaults to get_hurricanes() dataset plot_hurricane_nrg() p <- plot_hurricane_nrg(hurricanes, print = FALSE) p + ggplot2::labs(title='Accumulated Cyclone Energy') # } #> `geom_smooth()` using method = 'loess' and formula 'y ~ x'"},{"path":"/reference/plot_hurricanes.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_hurricanes","title":"Download and plot essential climate data — plot_hurricanes","text":"Plots hurricane data retrieved using get_hurricanes() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_hurricanes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_hurricanes","text":"","code":"plot_hurricanes(dataset = get_hurricanes(), print = TRUE)"},{"path":"/reference/plot_hurricanes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_hurricanes","text":"dataset Name tibble generated get_hurricanes print (boolean) Display hurricane ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_hurricanes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_hurricanes","text":"Invisibly returns ggplot2 object hurricanes chart","code":""},{"path":"/reference/plot_hurricanes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_hurricanes","text":"plot_hurricanes invisibly returns ggplot2 object pre-defined hurricane data chart using data get_hurricanes. default chart also displayed. Smooths using ggplot2's built-loess smoother. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_hurricanes.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_hurricanes","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_hurricanes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_hurricanes","text":"","code":"# \\donttest{ # Fetch hurricane data: hurricanes <- get_hurricanes() # # Plot output using package's built-in ggplot2 defaults plot_hurricanes(hurricanes) # Or just call plot_hurricanes(), which defaults to get_hurricanes() dataset plot_hurricanes() p <- plot_hurricanes(hurricanes, print = FALSE) p + ggplot2::labs(title='Growing number of North Atlantic named storms') # } #> `geom_smooth()` using method = 'loess' and formula 'y ~ x'"},{"path":"/reference/plot_icecurves.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_icecurves","title":"Download and plot essential climate data — plot_icecurves","text":"Plots monthly Sea Ice Index data retrieved using get_icecurves() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_icecurves.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_icecurves","text":"","code":"plot_icecurves(dataset = get_icecurves(), region = \"Arctic\", print = TRUE)"},{"path":"/reference/plot_icecurves.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_icecurves","text":"dataset Name tibble generated get_icecurves, defaults calling get_icecurves region Used chart title, defaults \"Arctic\" print (boolean) Display sea ice ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_icecurves.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_icecurves","text":"Invisibly returns ggplot2 object Sea Ice Index chart","code":""},{"path":"/reference/plot_icecurves.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_icecurves","text":"plot_icecurves invisibly returns ggplot2 object pre-defined Sea Ice Index chart using data get_icecurves. default chart also displayed. Users may modify output ggplot2 chart. Chart consists one line per year showing monthly sea ice January December. Current year highlighted.","code":""},{"path":"/reference/plot_icecurves.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_icecurves","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_icecurves.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_icecurves","text":"","code":"# \\donttest{ # Fetch historic monthly sea ice data since 1979: icecurves <- get_icecurves() #> Please set use_cache=FALSE if you are changing pole or measure from last cached data. # # Plot output using package's built-in ggplot2 defaults plot_icecurves(icecurves) # Or just call plot_icecurves(), which defaults to get_icecurves() dataset plot_icecurves() #> Please set use_cache=FALSE if you are changing pole or measure from last cached data. p <- plot_icecurves(icecurves, print = FALSE) p + ggplot2::labs(title='Shrinking Arctic Sea Ice') # }"},{"path":"/reference/plot_paleo.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_paleo","title":"Download and plot essential climate data — plot_paleo","text":"Plots Vostok ice core data retrieved using get_paleo() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_paleo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_paleo","text":"","code":"plot_paleo(dataset = get_paleo(), print = TRUE)"},{"path":"/reference/plot_paleo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_paleo","text":"dataset Name tibble generated get_paleo, defaults calling get_paleo print (boolean) Display Vostok ice core ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_paleo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_paleo","text":"Invisibly returns ggplot2 object Vostok chart","code":""},{"path":"/reference/plot_paleo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_paleo","text":"plot_paleo invisibly returns ggplot2 object pre-defined Vostok ice core chart using data get_paleo. returned chart stacks carbon dioxide concentration temperature 420,000 years. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_paleo.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — plot_paleo","text":"Barnola, J.-M., D. Raynaud, C. Lorius, N.. Barkov. 2003. Historical CO2 record Vostok ice core. Trends: Compendium Data Global Change. Carbon Dioxide Information Analysis Center, Oak Ridge National Laboratory, U.S. Department Energy, Oak Ridge, Tenn., U.S.","code":""},{"path":"/reference/plot_paleo.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_paleo","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_paleo.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_paleo","text":"","code":"# \\donttest{ # Fetch Vostok data: vostok <- get_paleo() #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) # # Plot output using package's built-in ggplot2 defaults plot_paleo(vostok) # Or just call plot_paleo(), which defaults to get_paleo() dataset plot_paleo() #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) #> #> ── Column specification ──────────────────────────────────────────────────────── #> cols( #> X1 = col_double(), #> X2 = col_double(), #> X3 = col_double(), #> X4 = col_double() #> ) p <- plot_paleo(vostok, print = FALSE) p + patchwork::plot_annotation(title='A Long History of Carbon') # }"},{"path":"/reference/plot_seaice.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_seaice","title":"Download and plot essential climate data — plot_seaice","text":"Plots Sea Ice Index data retrieved using get_seaice() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_seaice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_seaice","text":"","code":"plot_seaice(dataset = get_seaice(), title = \"Arctic Sea Ice\", print = TRUE)"},{"path":"/reference/plot_seaice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_seaice","text":"dataset Name tibble generated get_seaice, defaults calling get_seaice title chart title, defaults Arctic Sea Ice print (boolean) Display sea ice ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_seaice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_seaice","text":"Invisibly returns ggplot2 object Sea Ice Index chart","code":""},{"path":"/reference/plot_seaice.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_seaice","text":"plot_seaice invisibly returns ggplot2 object pre-defined Sea Ice Index chart using data get_seaice. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_seaice.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_seaice","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_seaice.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_seaice","text":"","code":"# \\donttest{ # Fetch sea ice data: seaice <- get_seaice() #> Please set use_cache=FALSE if you are changing pole, month, or measure from last cached data. # # Plot output using package's built-in ggplot2 defaults plot_seaice(seaice) # Or just call plot_seaice(), which defaults to get_seaice() dataset plot_seaice() #> Please set use_cache=FALSE if you are changing pole, month, or measure from last cached data. p <- plot_seaice(seaice, print = FALSE) p + ggplot2::labs(title='Shrinking Arctic Sea Ice') # } #> `geom_smooth()` using formula 'y ~ x'"},{"path":"/reference/plot_sealevel.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_sealevel","title":"Download and plot essential climate data — plot_sealevel","text":"Plots global mean sea level data retrieved using get_sealevel() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_sealevel.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_sealevel","text":"","code":"plot_sealevel(dataset = get_sealevel(), print = TRUE)"},{"path":"/reference/plot_sealevel.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_sealevel","text":"dataset Name tibble generated get_sealevel, defaults calling get_sealevel print (boolean) Display sealevel ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_sealevel.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_sealevel","text":"Invisibly returns ggplot2 object sealevel chart","code":""},{"path":"/reference/plot_sealevel.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_sealevel","text":"plot_sealevel invisibly returns ggplot2 object pre-defined sealevel change chart using data get_sealevel. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_sealevel.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_sealevel","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_sealevel.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_sealevel","text":"","code":"# \\donttest{ # Fetch sealevel data: gmsl <- get_sealevel() # # Plot output using package's built-in ggplot2 defaults plot_sealevel(gmsl) # Or just call plot_sealevel(), which defaults to get_sealevel() dataset plot_sealevel() p <- plot_sealevel(gmsl, print = FALSE) p + ggplot2::labs(title='Rising Waters') # }"},{"path":"/reference/plot_temp.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_temp","title":"Download and plot essential climate data — plot_temp","text":"Plots global temperature anomaly retrieved using get_temp() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_temp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_temp","text":"","code":"plot_temp(dataset = get_temp(), print = TRUE)"},{"path":"/reference/plot_temp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_temp","text":"dataset Name tibble generated get_temp print (boolean) Display temperature anomaly ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_temp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_temp","text":"Invisibly returns ggplot2 object temperature anomaly chart","code":""},{"path":"/reference/plot_temp.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_temp","text":"plot_temp invisibly returns ggplot2 object pre-defined temperature anomaly chart using data get_temp. default chart also displayed. Smooths using ggplot2's built-loess smoother. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_temp.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_temp","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_temp.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_temp","text":"","code":"# \\donttest{ # Fetch temperature anomaly: anomaly <- get_temp() # # Plot output using package's built-in ggplot2 defaults plot_temp(anomaly) # Or just call plot_temp(), which defaults to get_temp() dataset plot_temp() p <- plot_temp(anomaly, print = FALSE) p + ggplot2::labs(title='The Signature of Climate Change') # } #> `geom_smooth()` using method = 'loess' and formula 'y ~ x'"},{"path":"/reference/plot_temp2k.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — plot_temp2k","title":"Download and plot essential climate data — plot_temp2k","text":"Plots Common Era 2000-year global temperature anomaly retrieved using get_temp2k() ggplot2. output ggplot2 object may modified.","code":""},{"path":"/reference/plot_temp2k.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — plot_temp2k","text":"","code":"plot_temp2k( dataset = get_temp2k(), instrumental = TRUE, filtered = TRUE, print = TRUE )"},{"path":"/reference/plot_temp2k.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — plot_temp2k","text":"dataset Name tibble generated get_temp2k instrumental (boolean) Include Cowtan & Way instrumental temperatures 2017. Defaults TRUE. filtered (boolean) Use filtered temperatures provided PAGES2k Consortium. Temperatures filtered using 31-year Butterworth filter. Defaults TRUE. print (boolean) Display temperature anomaly ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/plot_temp2k.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — plot_temp2k","text":"Invisibly returns ggplot2 object temperature anomaly chart","code":""},{"path":"/reference/plot_temp2k.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — plot_temp2k","text":"plot_temp2k invisibly returns ggplot2 object pre-defined temperature anomaly chart using data get_temp2k. default chart also displayed. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/plot_temp2k.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — plot_temp2k","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/plot_temp2k.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — plot_temp2k","text":"","code":"# \\donttest{ # Fetch temperature anomaly: anomaly <- get_temp2k() # # Plot output using package's built-in ggplot2 defaults plot_temp2k(anomaly) # Or just call plot_temp2k(), which defaults to get_temp2k() dataset plot_temp2k() p <- plot_temp2k(anomaly, print = FALSE) p + ggplot2::labs(title='Temperature Increase in the Common Era') # } #> Warning: Removed 1926 row(s) containing missing values (geom_path)."},{"path":"/reference/print.hockeystick_cache_info.html","id":null,"dir":"Reference","previous_headings":"","what":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","title":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","text":"Display data cache info Shows filenames cache file sizes","code":""},{"path":"/reference/print.hockeystick_cache_info.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","text":"","code":"# S3 method for hockeystick_cache_info print(x, ...)"},{"path":"/reference/print.hockeystick_cache_info.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","text":"x filenames ... Additional parameters","code":""},{"path":"/reference/print.hockeystick_cache_info.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Display data cache info\nShows filenames and cache file sizes — print.hockeystick_cache_info","text":"Display data cache info. return value, called side effect.","code":""},{"path":"/reference/warming_stripes.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and plot essential climate data — warming_stripes","title":"Download and plot essential climate data — warming_stripes","text":"Plots global \"warming stripes\" graph style popularized Ed Hawkins, based temperature anomaly retrieved using get_temp(). Function can output stripes chart legend minimal chart. output ggplot2 object may modified.","code":""},{"path":"/reference/warming_stripes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and plot essential climate data — warming_stripes","text":"","code":"warming_stripes( dataset = get_temp(), stripe_only = FALSE, col_strip = RColorBrewer::brewer.pal(11, \"RdBu\"), print = TRUE )"},{"path":"/reference/warming_stripes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and plot essential climate data — warming_stripes","text":"dataset Name tibble generated get_temp stripe_only Display legend axes, defaults TRUE col_strip Color palette use. Defaults Red-Blue RColorBrewer palette. print (boolean) Display warming stripe ggplot2 chart, defaults TRUE. Use FALSE display chart.","code":""},{"path":"/reference/warming_stripes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and plot essential climate data — warming_stripes","text":"Invisibly returns ggplot2 object warming stripes","code":""},{"path":"/reference/warming_stripes.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and plot essential climate data — warming_stripes","text":"warming_stripes invisibly returns ggplot2 object warming stripes chart using data get_temp. default chart also displayed. User may modify color palette remove axes legend. Users may modify output ggplot2 chart.","code":""},{"path":"/reference/warming_stripes.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Download and plot essential climate data — warming_stripes","text":"Climate Lab. 2018. https://www.climate-lab-book.ac.uk/2018/warming-stripes/ GISS Surface Temperature Analysis (GISTEMP v4): https://data.giss.nasa.gov/gistemp/ GISTEMP Team, 2020: GISS Surface Temperature Analysis (GISTEMP), version 4. NASA Goddard Institute Space Studies. Dr. Dominic Roye blog post \"Create Warming Stripes R\": https://dominicroye.github.io/en/2018/--create-warming-stripes--r/","code":""},{"path":"/reference/warming_stripes.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"Download and plot essential climate data — warming_stripes","text":"Hernando Cortina, hch@alum.mit.edu","code":""},{"path":"/reference/warming_stripes.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and plot essential climate data — warming_stripes","text":"","code":"# \\donttest{ # Draw with axes and legend stripes <- warming_stripes() # Draw stripes only stripes <- warming_stripes(stripe_only = TRUE) # Don't display, store for further modifications stripes <- warming_stripes(print = FALSE) # Change color palette stripes <- warming_stripes(stripe_only = TRUE, col_strip = viridisLite::viridis(11)) # }"},{"path":"/news/index.html","id":"hockeystick-0009000","dir":"Changelog","previous_headings":"","what":"hockeystick 0.0.0.9000","title":"hockeystick 0.0.0.9000","text":"Added NEWS.md file track changes package.","code":""},{"path":"/news/index.html","id":"hockeystick-010","dir":"Changelog","previous_headings":"","what":"hockeystick 0.1.0","title":"hockeystick 0.1.0","text":"Five datasets warming stripes included package","code":""},{"path":"/news/index.html","id":"hockeystick-020","dir":"Changelog","previous_headings":"","what":"hockeystick 0.2.0","title":"hockeystick 0.2.0","text":"Add climate_grid() hockeystick_update_all()","code":""},{"path":"/news/index.html","id":"hockeystick-030","dir":"Changelog","previous_headings":"","what":"hockeystick 0.3.0","title":"hockeystick 0.3.0","text":"Add get_icecurves() plot_icecurves() visualize current historic sea ice","code":""},{"path":"/news/index.html","id":"hockeystick-034","dir":"Changelog","previous_headings":"","what":"hockeystick 0.3.4","title":"hockeystick 0.3.4","text":"Don’t cache data default, added write_cache options","code":""},{"path":"/news/index.html","id":"hockeystick-040","dir":"Changelog","previous_headings":"","what":"hockeystick 0.4.0","title":"hockeystick 0.4.0","text":"CRAN release: 2021-02-05 Add get_temp2k() plot_temp2k() visualize global Common Era reconstructed temp","code":""},{"path":"/news/index.html","id":"hockeystick-050","dir":"Changelog","previous_headings":"","what":"hockeystick 0.5.0","title":"hockeystick 0.5.0","text":"CRAN release: 2021-04-14 Add Atlantic hurricane data, get_hurricanes(), plot_hurricanes(), plot_hurricane_nrg()","code":""},{"path":"/news/index.html","id":"hockeystick-051","dir":"Changelog","previous_headings":"","what":"hockeystick 0.5.1","title":"hockeystick 0.5.1","text":"CRAN release: 2021-05-18 Update caching approach comply CRAN policies","code":""},{"path":"/news/index.html","id":"hockeystick-052","dir":"Changelog","previous_headings":"","what":"hockeystick 0.5.2","title":"hockeystick 0.5.2","text":"Add date/value annotations charts","code":""},{"path":"/news/index.html","id":"hockeystick-060","dir":"Changelog","previous_headings":"","what":"hockeystick 0.6.0","title":"hockeystick 0.6.0","text":"Add global emissions GCP: get_emissions(), plot_emissions()","code":""},{"path":"/news/index.html","id":"hockeystick-061","dir":"Changelog","previous_headings":"","what":"hockeystick 0.6.1","title":"hockeystick 0.6.1","text":"CRAN release: 2021-09-20 Fix leaving example data cache","code":""},{"path":"/news/index.html","id":"hockeystick-062","dir":"Changelog","previous_headings":"","what":"hockeystick 0.6.2","title":"hockeystick 0.6.2","text":"Update documentation conform R version 4.2","code":""}] diff --git a/man/get_carbon.Rd b/man/get_carbon.Rd index d582bd6..beb7cf9 100644 --- a/man/get_carbon.Rd +++ b/man/get_carbon.Rd @@ -1,49 +1,49 @@ -% Generated by roxygen2: do not edit by hand -% Please edit documentation in R/carbon.R -\name{get_carbon} -\alias{get_carbon} -\title{Download and plot essential climate data} -\usage{ -get_carbon(use_cache = TRUE, write_cache = getOption("hs_write_cache")) -} -\arguments{ -\item{use_cache}{(boolean) Return cached data if available, defaults to TRUE. Use FALSE to fetch updated data.} - -\item{write_cache}{(boolean) Write data to cache, defaults to FALSE. Use TRUE to write data to cache for later use. Can also be set using options(hs_write_cache=TRUE)} -} -\value{ -Invisibly returns a tibble with the monthly carbon dioxide series -} -\description{ -Retrieves atmospheric carbon dioxide measurements from National Oceanic and Atmospheric Administration -Earth System Research Laboratories monitoring laboratory in Mauna Loa, Hawaii. -\url{https://gml.noaa.gov/ccgg/trends/data.html} -} -\details{ -\code{get_carbon} invisibly returns a tibble with NOAA's monthly average carbon dioxide measurement. -The returned object includes date, year, month, average, trend, std dev, and uncertainty columns. -Trend is NOAA's published trend. Please refer to above website for details. -} -\examples{ -\donttest{ -# Fetch from cache if available, otherwise download: -maunaloa <- get_carbon() -# -# Force fetch from source: -maunaloa <- get_carbon(use_cache=FALSE) -# -# Review cache contents and last update dates: -hockeystick_cache_details() -# -# Plot output using package's built-in ggplot2 settings -plot_carbon(maunaloa) } - -} -\references{ -Dr. Pieter Tans, NOAA/GML \url{https://gml.noaa.gov/ccgg/trends/} and Dr. Ralph Keeling, Scripps Institution of Oceanography \url{https://scrippsco2.ucsd.edu/}. - -C.D. Keeling, R.B. Bacastow, A.E. Bainbridge, C.A. Ekdahl, P.R. Guenther, and L.S. Waterman, (1976), Atmospheric carbon dioxide variations at Mauna Loa Observatory, Hawaii, \emph{Tellus}, vol. 28, 538-551 -} -\author{ -Hernando Cortina, \email{hch@alum.mit.edu} -} +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/carbon.R +\name{get_carbon} +\alias{get_carbon} +\title{Download and plot essential climate data} +\usage{ +get_carbon(use_cache = TRUE, write_cache = getOption("hs_write_cache")) +} +\arguments{ +\item{use_cache}{(boolean) Return cached data if available, defaults to TRUE. Use FALSE to fetch updated data.} + +\item{write_cache}{(boolean) Write data to cache, defaults to FALSE. Use TRUE to write data to cache for later use. Can also be set using options(hs_write_cache=TRUE)} +} +\value{ +Invisibly returns a tibble with the monthly carbon dioxide series +} +\description{ +Retrieves atmospheric carbon dioxide measurements from National Oceanic and Atmospheric Administration +Earth System Research Laboratories monitoring laboratory in Mauna Loa, Hawaii. +\url{https://gml.noaa.gov/ccgg/trends/data.html} +} +\details{ +\code{get_carbon} invisibly returns a tibble with NOAA's monthly average carbon dioxide measurement. +The returned object includes date, year, month, average, trend, std dev, and uncertainty columns. +Trend is NOAA's published trend. Please refer to above website for details. +} +\examples{ +\donttest{ +# Fetch from cache if available, otherwise download: +maunaloa <- get_carbon() +# +# Force fetch from source: +maunaloa <- get_carbon(use_cache=FALSE) +# +# Review cache contents and last update dates: +hockeystick_cache_details() +# +# Plot output using package's built-in ggplot2 settings +plot_carbon(maunaloa) } + +} +\references{ +Dr. Pieter Tans, NOAA/GML \url{https://gml.noaa.gov/ccgg/trends/} and Dr. Ralph Keeling, Scripps Institution of Oceanography \url{https://scrippsco2.ucsd.edu/}. + +C.D. Keeling, R.B. Bacastow, A.E. Bainbridge, C.A. Ekdahl, P.R. Guenther, and L.S. Waterman, (1976), Atmospheric carbon dioxide variations at Mauna Loa Observatory, Hawaii, \emph{Tellus}, vol. 28, 538-551 +} +\author{ +Hernando Cortina, \email{hch@alum.mit.edu} +} diff --git a/man/get_sealevel.Rd b/man/get_sealevel.Rd index 0da562c..4dc144f 100644 --- a/man/get_sealevel.Rd +++ b/man/get_sealevel.Rd @@ -1,56 +1,56 @@ -% Generated by roxygen2: do not edit by hand -% Please edit documentation in R/sealevel.R -\name{get_sealevel} -\alias{get_sealevel} -\title{Download and plot essential climate data} -\usage{ -get_sealevel(use_cache = TRUE, write_cache = getOption("hs_write_cache")) -} -\arguments{ -\item{use_cache}{(boolean) Return cached data if available, defaults to TRUE. Use FALSE to fetch updated data.} - -\item{write_cache}{(boolean) Write data to cache, defaults to FALSE. Use TRUE to write data to cache for later use. Can also be set using options(hs_write_cache=TRUE)} -} -\value{ -Invisibly returns a tibble with the global mean sea level time series (in mm) over 1880-2013 using tide gauges and since 1993 for satellite measurements. - -\code{get_sealevel} invisibly returns a tibble with mean sea level in mm time series from tide gauges and satellite observations. - -The satellite observations have been releveled so that their mean level in 1993 matches that of the tide gauges. - -The tide gauge data are no longer updated and cover the period from 1880 to 2013, per Church, J. A. and N.J. White (2011) \url{https://research.csiro.au/slrwavescoast/sea-level/measurements-and-data/sea-level-data/} - -Satellite data are updated monthly or more frequently from the NOAA Laboratory for Satellite Altimetry. TOPEX and Jason-1,-2,-3 satellites dataset, with seasonal signals removed. \url{https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/} -} -\description{ -Retrieves global mean sea level (GMSL) data from historic tide gauge and recent satellite altimeter observations (in mm). -Source for tide gauge data is Commonwealth Scientific and Industrial Research Organisation (CSIRO) as described in Church and White (2011). -\url{https://research.csiro.au/slrwavescoast/sea-level/measurements-and-data/sea-level-data/} \cr \cr -Source for satellite data is NOAA Laboratory for Satellite Altimetry: -\url{https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/} -} -\examples{ -\donttest{ -# Fetch sea level from cache if available: -gmsl <- get_sealevel() -# -# Force cache refresh: -gmsl <- get_sealevel(use_cache=FALSE) -# -# Review cache contents and last update dates: -hockeystick_cache_details() -# -# Plot output using package's built-in ggplot2 settings -plot_sealevel(gmsl) } - -} -\references{ -\itemize{ -\item CSIRO reconstructed tide gauge GMSL for 1880 to 2009: \url{https://research.csiro.au/slrwavescoast/sea-level/measurements-and-data/sea-level-data/} -\item Church, J. A. and N.J. White (2011), Sea-level rise from the late 19th to the early 21st Century. \emph{Surveys in Geophysics}, doi:10.1007/s10712-011-9119-1. \url{https://link.springer.com/article/10.1007/s10712-011-9119-1} -\item NOAA Laboratory for Satellite Altimetry \url{https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/} -} -} -\author{ -Hernando Cortina, \email{hch@alum.mit.edu} -} +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/sealevel.R +\name{get_sealevel} +\alias{get_sealevel} +\title{Download and plot essential climate data} +\usage{ +get_sealevel(use_cache = TRUE, write_cache = getOption("hs_write_cache")) +} +\arguments{ +\item{use_cache}{(boolean) Return cached data if available, defaults to TRUE. Use FALSE to fetch updated data.} + +\item{write_cache}{(boolean) Write data to cache, defaults to FALSE. Use TRUE to write data to cache for later use. Can also be set using options(hs_write_cache=TRUE)} +} +\value{ +Invisibly returns a tibble with the global mean sea level time series (in mm) over 1880-2013 using tide gauges and since 1993 for satellite measurements. + +\code{get_sealevel} invisibly returns a tibble with mean sea level in mm time series from tide gauges and satellite observations. + +The satellite observations have been releveled so that their mean level in 1993 matches that of the tide gauges. + +The tide gauge data are no longer updated and cover the period from 1880 to 2013, per Church, J. A. and N.J. White (2011) \url{https://research.csiro.au/slrwavescoast/sea-level/measurements-and-data/sea-level-data/} + +Satellite data are updated monthly or more frequently from the NOAA Laboratory for Satellite Altimetry. TOPEX and Jason-1,-2,-3 satellites dataset, with seasonal signals removed. \url{https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/} +} +\description{ +Retrieves global mean sea level (GMSL) data from historic tide gauge and recent satellite altimeter observations (in mm). +Source for tide gauge data is Commonwealth Scientific and Industrial Research Organisation (CSIRO) as described in Church and White (2011). +\url{https://research.csiro.au/slrwavescoast/sea-level/measurements-and-data/sea-level-data/} \cr \cr +Source for satellite data is NOAA Laboratory for Satellite Altimetry: +\url{https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/} +} +\examples{ +\donttest{ +# Fetch sea level from cache if available: +gmsl <- get_sealevel() +# +# Force cache refresh: +gmsl <- get_sealevel(use_cache=FALSE) +# +# Review cache contents and last update dates: +hockeystick_cache_details() +# +# Plot output using package's built-in ggplot2 settings +plot_sealevel(gmsl) } + +} +\references{ +\itemize{ +\item CSIRO reconstructed tide gauge GMSL for 1880 to 2009: \url{https://research.csiro.au/slrwavescoast/sea-level/measurements-and-data/sea-level-data/} +\item Church, J. A. and N.J. White (2011), Sea-level rise from the late 19th to the early 21st Century. \emph{Surveys in Geophysics}, doi:10.1007/s10712-011-9119-1. \url{https://link.springer.com/article/10.1007/s10712-011-9119-1} +\item NOAA Laboratory for Satellite Altimetry \url{https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/} +} +} +\author{ +Hernando Cortina, \email{hch@alum.mit.edu} +} diff --git a/man/hockeystick-package.Rd b/man/hockeystick-package.Rd index 19519b7..f044181 100644 --- a/man/hockeystick-package.Rd +++ b/man/hockeystick-package.Rd @@ -1,26 +1,26 @@ -% Generated by roxygen2: do not edit by hand -% Please edit documentation in R/hockeystick-package.R -\docType{package} -\name{hockeystick-package} -\alias{hockeystick} -\alias{hockeystick-package} -\title{hockeystick: Download and Visualize Essential Climate Change Data} -\description{ -\if{html}{\figure{logo.png}{options: style='float: right' alt='logo' width='120'}} - -Provides easy access to essential climate change datasets to non-climate experts. Users can download the latest raw data from authoritative sources and view it via pre-defined 'ggplot2' charts. Datasets include atmospheric CO2, emissions, instrumental and proxy temperature records, sea levels, Arctic/Antarctic sea-ice, Hurricanes, and Paleoclimate data. Sources include: NOAA Mauna Loa Laboratory \url{https://gml.noaa.gov/ccgg/trends/data.html}, Global Carbon Project \url{https://www.globalcarbonproject.org/carbonbudget/20/data.htm}, NASA GISTEMP \url{https://data.giss.nasa.gov/gistemp/}, National Snow and Sea Ice Data Center \url{https://nsidc.org/data/seaice_index/archives}, CSIRO \url{https://research.csiro.au/slrwavescoast/sea-level/measurements-and-data/sea-level-data/}, NOAA Laboratory for Satellite Altimetry \url{https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/} and HURDAT Atlantic Hurricane Database \url{https://www.aoml.noaa.gov/hrd/hurdat/Data_Storm.html}, Vostok Paleo carbon dioxide and temperature data: \url{https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html}. -} -\seealso{ -Useful links: -\itemize{ - \item \url{https://cortinah.github.io/hockeystick/} - \item \url{https://github.com/cortinah/hockeystick} - \item Report bugs at \url{https://github.com/cortinah/hockeystick/issues} -} - -} -\author{ -\strong{Maintainer}: Hernando Cortina \email{hch@alum.mit.edu} (\href{https://orcid.org/0000-0001-6790-4870}{ORCID}) - -} -\keyword{internal} +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/hockeystick-package.R +\docType{package} +\name{hockeystick-package} +\alias{hockeystick} +\alias{hockeystick-package} +\title{hockeystick: Download and Visualize Essential Climate Change Data} +\description{ +\if{html}{\figure{logo.png}{options: style='float: right' alt='logo' width='120'}} + +Provides easy access to essential climate change datasets to non-climate experts. Users can download the latest raw data from authoritative sources and view it via pre-defined 'ggplot2' charts. Datasets include atmospheric CO2, emissions, instrumental and proxy temperature records, sea levels, Arctic/Antarctic sea-ice, Hurricanes, and Paleoclimate data. Sources include: NOAA Mauna Loa Laboratory \url{https://gml.noaa.gov/ccgg/trends/data.html}, Global Carbon Project \url{https://www.globalcarbonproject.org/carbonbudget/20/data.htm}, NASA GISTEMP \url{https://data.giss.nasa.gov/gistemp/}, National Snow and Sea Ice Data Center \url{https://nsidc.org/data/seaice_index/archives}, CSIRO \url{https://research.csiro.au/slrwavescoast/sea-level/measurements-and-data/sea-level-data/}, NOAA Laboratory for Satellite Altimetry \url{https://www.star.nesdis.noaa.gov/socd/lsa/SeaLevelRise/} and HURDAT Atlantic Hurricane Database \url{https://www.aoml.noaa.gov/hrd/hurdat/Data_Storm.html}, Vostok Paleo carbon dioxide and temperature data: \url{https://cdiac.ess-dive.lbl.gov/trends/co2/vostok.html}. +} +\seealso{ +Useful links: +\itemize{ + \item \url{https://cortinah.github.io/hockeystick/} + \item \url{https://github.com/cortinah/hockeystick} + \item Report bugs at \url{https://github.com/cortinah/hockeystick/issues} +} + +} +\author{ +\strong{Maintainer}: Hernando Cortina \email{hch@alum.mit.edu} (\href{https://orcid.org/0000-0001-6790-4870}{ORCID}) + +} +\keyword{internal}