From 814aeac8f5633820c067e2851f9eae8841a99529 Mon Sep 17 00:00:00 2001 From: dramanica Date: Wed, 13 Sep 2023 14:24:05 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20EvolEcol?= =?UTF-8?q?Group/pastclim@1160c0b8c501ca59dfa7d9a9c92f8d8c7b82c4ea=20?= =?UTF-8?q?=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- dev/articles/a0_pastclim_overview.html | 32 +++++++++---------- dev/articles/a1_available_datasets.html | 2 +- dev/articles/a2_custom_datasets.html | 2 +- .../a3_pastclim_present_and_future.html | 2 +- dev/pkgdown.yml | 2 +- dev/search.json | 2 +- 6 files changed, 21 insertions(+), 21 deletions(-) diff --git a/dev/articles/a0_pastclim_overview.html b/dev/articles/a0_pastclim_overview.html index 011a6a08..da42a538 100644 --- a/dev/articles/a0_pastclim_overview.html +++ b/dev/articles/a0_pastclim_overview.html @@ -232,7 +232,7 @@

Download the datalibrary(pastclim) set_data_path() 
#> Loading required package: terra
-#> terra 1.7.47
+#> terra 1.7.48 
#> The data_path will be set to /home/andrea/.local/share/R/pastclim.
 #> A copy of the Example dataset will be copied there.
 #> This path will be saved by pastclim for future use.
@@ -904,13 +904,13 @@ 
Random sampling of background)
 this_sample <- sample_region_slice(climate_20k, size = 100)
 head(this_sample)
-#>    cell     x    y      bio01      bio10
-#> 1 21505  84.5 30.5 -10.043381  0.9198932
-#> 2 19382 121.5 36.5   6.944111 26.2095699
-#> 3  7874 133.5 68.5 -25.195515  7.8242626
-#> 4 21525 104.5 30.5  13.136123 20.9693165
-#> 5 33337  36.5 -2.5  16.658417 17.6095238
-#> 6 25467  86.5 19.5  24.064934 26.5013103
+#> cell x y bio01 bio10 +#> 1 8981 160.5 65.5 -20.492542 2.79441 +#> 2 27552 11.5 13.5 23.633068 28.35611 +#> 3 22230 89.5 28.5 -5.519563 4.36088 +#> 4 11484 143.5 58.5 -12.875105 10.90693 +#> 5 44250 149.5 -32.5 12.043017 19.04924 +#> 6 21109 48.5 31.5 19.990810 29.66088

If we have samples from multiple time steps, we need to sample the background proportionally to the number of points in each time step. So, for example, if we wanted 30 samples from 20k years ago and 50 samples @@ -925,14 +925,14 @@

Random sampling of backgroundsampled_climate <- sample_region_series(climate_ts, size = c(3,5)) sampled_climate #> cell x y bio01 bio10 bio12 time_bp -#> -20000.1 3294 48.5 36.5 3.9929693 14.70691 259.1800 -20000 -#> -20000.2 3343 12.5 35.5 15.9990892 26.56406 192.0470 -20000 -#> -20000.3 1581 35.5 56.5 -7.2382975 10.27890 611.5366 -20000 -#> -10000.1 3119 43.5 38.5 6.6280322 22.53080 340.6419 -10000 -#> -10000.2 377 21.5 70.5 -2.7576876 10.16395 642.6003 -10000 -#> -10000.3 1775 59.5 54.5 -0.4912275 19.61463 424.3754 -10000 -#> -10000.4 1181 60.5 61.5 -3.1943440 15.80031 410.8481 -10000 -#> -10000.5 959 8.5 63.5 3.8759172 11.67554 1077.2959 -10000 +#> -20000.1 1681 50.5 55.5 -6.0324616 13.58117 430.1882 -20000 +#> -20000.2 3256 10.5 36.5 14.0106421 23.11121 453.8929 -20000 +#> -20000.3 1525 64.5 57.5 -8.7510185 12.83404 293.2224 -20000 +#> -10000.1 2814 -6.5 41.5 11.7551479 22.32403 654.6106 -10000 +#> -10000.2 1383 7.5 58.5 3.3640807 11.76538 1432.7773 -10000 +#> -10000.3 1776 60.5 54.5 0.5935395 20.97770 398.5586 -10000 +#> -10000.4 1237 31.5 60.5 1.3792480 10.32065 485.8271 -10000 +#> -10000.5 3374 43.5 35.5 20.2427788 36.12845 262.7458 -10000

We could then use these data to build a PCA.

diff --git a/dev/articles/a1_available_datasets.html b/dev/articles/a1_available_datasets.html index 56e827f4..d8ded91e 100644 --- a/dev/articles/a1_available_datasets.html +++ b/dev/articles/a1_available_datasets.html @@ -104,7 +104,7 @@

Overview of datasets availab 
 library(pastclim)
 #> Loading required package: terra
-#> terra 1.7.47
+#> terra 1.7.48

 get_available_datasets()
 #> [1] "Example"   "Beyer2020" "Krapp2021"
diff --git a/dev/articles/a2_custom_datasets.html b/dev/articles/a2_custom_datasets.html
index 8b9a9413..9aef137f 100644
--- a/dev/articles/a2_custom_datasets.html
+++ b/dev/articles/a2_custom_datasets.html
@@ -147,7 +147,7 @@ 
An example: the Trace21k-CHELSEA
 library(pastclim)
 #> Loading required package: terra
-#> terra 1.7.47
+#> terra 1.7.48
 time_bp(bio01)<-c(0,-100,-200)
 names(bio01)<-paste("bio01",terra::time(bio01),sep="_")

Now we save the data as a nc file (we will use the temporary diff --git a/dev/articles/a3_pastclim_present_and_future.html b/dev/articles/a3_pastclim_present_and_future.html index d4f2d79f..2275c1ea 100644 --- a/dev/articles/a3_pastclim_present_and_future.html +++ b/dev/articles/a3_pastclim_present_and_future.html @@ -117,7 +117,7 @@

Present reconstructions
 library(pastclim)
 #> Loading required package: terra
-#> terra 1.7.47
+#> terra 1.7.48
 get_vars_for_dataset("WorldClim_2.1_10m")
 #>  [1] "bio01"    "bio02"    "bio03"    "bio04"    "bio05"    "bio06"   
 #>  [7] "bio07"    "bio08"    "bio09"    "bio10"    "bio11"    "bio12"   
diff --git a/dev/pkgdown.yml b/dev/pkgdown.yml
index c3c8b715..0a260fe8 100644
--- a/dev/pkgdown.yml
+++ b/dev/pkgdown.yml
@@ -6,7 +6,7 @@ articles:
   a1_available_datasets: a1_available_datasets.html
   a2_custom_datasets: a2_custom_datasets.html
   a3_pastclim_present_and_future: a3_pastclim_present_and_future.html
-last_built: 2023-09-08T15:35Z
+last_built: 2023-09-13T14:22Z
 urls:
   reference: https://evolecolgroup.github.io/pastclim/reference
   article: https://evolecolgroup.github.io/pastclim/articles
diff --git a/dev/search.json b/dev/search.json
index def0e03c..609144c3 100644
--- a/dev/search.json
+++ b/dev/search.json
@@ -1 +1 @@
-[{"path":"https://evolecolgroup.github.io/pastclim/dev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"CC BY 4.0","title":"CC BY 4.0","text":"Attribution 4.0 International ======================================================================= Creative Commons Corporation (“Creative Commons”) law firm provide legal services legal advice. Distribution Creative Commons public licenses create lawyer-client relationship. Creative Commons makes licenses related information available “-” basis. Creative Commons gives warranties regarding licenses, material licensed terms conditions, related information. Creative Commons disclaims liability damages resulting use fullest extent possible. Using Creative Commons Public Licenses Creative Commons public licenses provide standard set terms conditions creators rights holders may use share original works authorship material subject copyright certain rights specified public license . following considerations informational purposes , exhaustive, form part licenses. ======================================================================= Creative Commons Attribution 4.0 International Public License exercising Licensed Rights (defined ), accept agree bound terms conditions Creative Commons Attribution 4.0 International Public License (“Public License”). extent Public License may interpreted contract, granted Licensed Rights consideration acceptance terms conditions, Licensor grants rights consideration benefits Licensor receives making Licensed Material available terms conditions. Section 1 – Definitions. Adapted Material means material subject Copyright Similar Rights derived based upon Licensed Material Licensed Material translated, altered, arranged, transformed, otherwise modified manner requiring permission Copyright Similar Rights held Licensor. purposes Public License, Licensed Material musical work, performance, sound recording, Adapted Material always produced Licensed Material synched timed relation moving image. Adapter’s License means license apply Copyright Similar Rights contributions Adapted Material accordance terms conditions Public License. Copyright Similar Rights means copyright /similar rights closely related copyright including, without limitation, performance, broadcast, sound recording, Sui Generis Database Rights, without regard rights labeled categorized. purposes Public License, rights specified Section 2(b)(1)-(2) Copyright Similar Rights. Effective Technological Measures means measures , absence proper authority, may circumvented laws fulfilling obligations Article 11 WIPO Copyright Treaty adopted December 20, 1996, /similar international agreements. Exceptions Limitations means fair use, fair dealing, /exception limitation Copyright Similar Rights applies use Licensed Material. Licensed Material means artistic literary work, database, material Licensor applied Public License. Licensed Rights means rights granted subject terms conditions Public License, limited Copyright Similar Rights apply use Licensed Material Licensor authority license. Licensor means individual(s) entity(ies) granting rights Public License. Share means provide material public means process requires permission Licensed Rights, reproduction, public display, public performance, distribution, dissemination, communication, importation, make material available public including ways members public may access material place time individually chosen . Sui Generis Database Rights means rights copyright resulting Directive 96/9/EC European Parliament Council 11 March 1996 legal protection databases, amended /succeeded, well essentially equivalent rights anywhere world. means individual entity exercising Licensed Rights Public License. corresponding meaning. Section 2 – Scope. License grant. Subject terms conditions Public License, Licensor hereby grants worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license exercise Licensed Rights Licensed Material : reproduce Share Licensed Material, whole part; produce, reproduce, Share Adapted Material. Exceptions Limitations. avoidance doubt, Exceptions Limitations apply use, Public License apply, need comply terms conditions. Term. term Public License specified Section 6(). Media formats; technical modifications allowed. Licensor authorizes exercise Licensed Rights media formats whether now known hereafter created, make technical modifications necessary . Licensor waives /agrees assert right authority forbid making technical modifications necessary exercise Licensed Rights, including technical modifications necessary circumvent Effective Technological Measures. purposes Public License, simply making modifications authorized Section 2() never produces Adapted Material. Downstream recipients. Offer Licensor – Licensed Material. Every recipient Licensed Material automatically receives offer Licensor exercise Licensed Rights terms conditions Public License. downstream restrictions. may offer impose additional different terms conditions , apply Effective Technological Measures , Licensed Material restricts exercise Licensed Rights recipient Licensed Material. endorsement. Nothing Public License constitutes may construed permission assert imply , use Licensed Material , connected , sponsored, endorsed, granted official status , Licensor others designated receive attribution provided Section 3()(1)()(). rights. Moral rights, right integrity, licensed Public License, publicity, privacy, /similar personality rights; however, extent possible, Licensor waives /agrees assert rights held Licensor limited extent necessary allow exercise Licensed Rights, otherwise. Patent trademark rights licensed Public License. extent possible, Licensor waives right collect royalties exercise Licensed Rights, whether directly collecting society voluntary waivable statutory compulsory licensing scheme. cases Licensor expressly reserves right collect royalties. Section 3 – License Conditions. exercise Licensed Rights expressly made subject following conditions. Attribution. Share Licensed Material (including modified form), must: retain following supplied Licensor Licensed Material: identification creator(s) Licensed Material others designated receive attribution, reasonable manner requested Licensor (including pseudonym designated); copyright notice; notice refers Public License; notice refers disclaimer warranties; URI hyperlink Licensed Material extent reasonably practicable; indicate modified Licensed Material retain indication previous modifications; indicate Licensed Material licensed Public License, include text , URI hyperlink , Public License. may satisfy conditions Section 3()(1) reasonable manner based medium, means, context Share Licensed Material. example, may reasonable satisfy conditions providing URI hyperlink resource includes required information. requested Licensor, must remove information required Section 3()(1)() extent reasonably practicable. Share Adapted Material produce, Adapter’s License apply must prevent recipients Adapted Material complying Public License. Section 4 – Sui Generis Database Rights. Licensed Rights include Sui Generis Database Rights apply use Licensed Material: avoidance doubt, Section 2()(1) grants right extract, reuse, reproduce, Share substantial portion contents database; include substantial portion database contents database Sui Generis Database Rights, database Sui Generis Database Rights (individual contents) Adapted Material; must comply conditions Section 3() Share substantial portion contents database. avoidance doubt, Section 4 supplements replace obligations Public License Licensed Rights include Copyright Similar Rights. Section 5 – Disclaimer Warranties Limitation Liability. UNLESS OTHERWISE SEPARATELY UNDERTAKEN LICENSOR, EXTENT POSSIBLE, LICENSOR OFFERS LICENSED MATERIAL --AVAILABLE, MAKES REPRESENTATIONS WARRANTIES KIND CONCERNING LICENSED MATERIAL, WHETHER EXPRESS, IMPLIED, STATUTORY, . INCLUDES, WITHOUT LIMITATION, WARRANTIES TITLE, MERCHANTABILITY, FITNESS PARTICULAR PURPOSE, NON-INFRINGEMENT, ABSENCE LATENT DEFECTS, ACCURACY, PRESENCE ABSENCE ERRORS, WHETHER KNOWN DISCOVERABLE. DISCLAIMERS WARRANTIES ALLOWED FULL PART, DISCLAIMER MAY APPLY . EXTENT POSSIBLE, EVENT LICENSOR LIABLE LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, NEGLIGENCE) OTHERWISE DIRECT, SPECIAL, INDIRECT, INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, LOSSES, COSTS, EXPENSES, DAMAGES ARISING PUBLIC LICENSE USE LICENSED MATERIAL, EVEN LICENSOR ADVISED POSSIBILITY LOSSES, COSTS, EXPENSES, DAMAGES. LIMITATION LIABILITY ALLOWED FULL PART, LIMITATION MAY APPLY . disclaimer warranties limitation liability provided shall interpreted manner , extent possible, closely approximates absolute disclaimer waiver liability. Section 6 – Term Termination. Public License applies term Copyright Similar Rights licensed . However, fail comply Public License, rights Public License terminate automatically. right use Licensed Material terminated Section 6(), reinstates: automatically date violation cured, provided cured within 30 days discovery violation; upon express reinstatement Licensor. avoidance doubt, Section 6(b) affect right Licensor may seek remedies violations Public License. avoidance doubt, Licensor may also offer Licensed Material separate terms conditions stop distributing Licensed Material time; however, terminate Public License. Sections 1, 5, 6, 7, 8 survive termination Public License. Section 7 – Terms Conditions. Licensor shall bound additional different terms conditions communicated unless expressly agreed. arrangements, understandings, agreements regarding Licensed Material stated herein separate independent terms conditions Public License. Section 8 – Interpretation. avoidance doubt, Public License , shall interpreted , reduce, limit, restrict, impose conditions use Licensed Material lawfully made without permission Public License. extent possible, provision Public License deemed unenforceable, shall automatically reformed minimum extent necessary make enforceable. provision reformed, shall severed Public License without affecting enforceability remaining terms conditions. term condition Public License waived failure comply consented unless expressly agreed Licensor. Nothing Public License constitutes may interpreted limitation upon, waiver , privileges immunities apply Licensor , including legal processes jurisdiction authority. ======================================================================= Creative Commons party public licenses. Notwithstanding, Creative Commons may elect apply one public licenses material publishes instances considered “Licensor.” text Creative Commons public licenses dedicated public domain CC0 Public Domain Dedication. Except limited purpose indicating material shared Creative Commons public license otherwise permitted Creative Commons policies published creativecommons.org/policies, Creative Commons authorize use trademark “Creative Commons” trademark logo Creative Commons without prior written consent including, without limitation, connection unauthorized modifications public licenses arrangements, understandings, agreements concerning use licensed material. avoidance doubt, paragraph form part public licenses. Creative Commons may contacted creativecommons.org.","code":"Considerations for licensors: Our public licenses are  intended for use by those authorized to give the public  permission to use material in ways otherwise restricted by  copyright and certain other rights. Our licenses are  irrevocable. Licensors should read and understand the terms  and conditions of the license they choose before applying it.  Licensors should also secure all rights necessary before  applying our licenses so that the public can reuse the  material as expected. Licensors should clearly mark any  material not subject to the license. This includes other CC-  licensed material, or material used under an exception or  limitation to copyright. More considerations for licensors: wiki.creativecommons.org/Considerations_for_licensors   Considerations for the public: By using one of our public  licenses, a licensor grants the public permission to use the  licensed material under specified terms and conditions. If  the licensor's permission is not necessary for any reason--for  example, because of any applicable exception or limitation to  copyright--then that use is not regulated by the license. Our  licenses grant only permissions under copyright and certain  other rights that a licensor has authority to grant. Use of  the licensed material may still be restricted for other  reasons, including because others have copyright or other  rights in the material. A licensor may make special requests,  such as asking that all changes be marked or described.  Although not required by our licenses, you are encouraged to  respect those requests where reasonable. More considerations  for the public:  wiki.creativecommons.org/Considerations_for_licensees"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"install-the-library","dir":"Articles","previous_headings":"","what":"Install the library","title":"pastclim overview","text":"pastclim CRAN, easiest way install : want latest development version, can get GitHub. install GitHub, need use devtools; haven’t done already, install CRAN install.packages(\"devtools\"). Also, note dev version pastclim tracks changes dev version terra, need upgrade : dedicated website, can find Articles giving step--step overview package, cheatsheet. also version site updated dev version (top left, version number red, format x.x.x.9xxx, indicating development version). want build vignette directly R installing pastclim GitHub, can : read directly R : Depending operating system use, might need additional packages build vignette. NOTE: pastclim relies terra process rasters. known bug terra leads occasional message: reported. error related garbage collection, affect script correctly executed, can ignored. discussion issue can found stackoverflow","code":"install.packages(\"pastclim\") install.packages('terra', repos='https://rspatial.r-universe.dev') devtools::install_github(\"EvolEcolGroup/pastclim\", ref=\"dev\") devtools::install_github(\"EvolEcolGroup/pastclim\", ref=\"dev\", build_vignettes = TRUE) vignette(\"pastclim_overview\", package = \"pastclim\") \"Error in x$.self$finalize() : attempt to apply non-function\""},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"download-the-data","dir":"Articles","previous_headings":"","what":"Download the data","title":"pastclim overview","text":"need download climatic reconstructions able real work pastclim. Currently library contains two datasets: Beyer2020 covers last 120k years; , project go back time, Krapp2021 goes back 800kya. possible add additional, custom datasets, need familiarity handling netcdf files (see vignette ‘custom dataset’). list datasets available can obtained typing Please aware using dataset made available pastclim require cite pastclim well original publication presenting dataset. reference cite pastclim can obtained typing reference associated dataset choice (case “Beyer2020”) displayed together general information dataset command: datasets available pastclim, functions help download data choose variables. start pastclim first time, need set path reconstructions stored using set_data_path. default, package data path used: Press 1 happy offered choices, pastclim remember data path future sessions. Note data path look different example, depends user name operating system. prefer using custom path (e.g. “~/my_reconstructions”), can set : package includes small dataset, Example, use vignette suitable running real analyses; real datasets large (100s Mb Gb), need specify want download (see ). Let us start inspecting Example dataset. can get list variables available dataset : available time steps can obtained : Beyer2020 Krapp2021, can get list available variables dataset : Note , default, annual variables shown. see available monthly variables, simply use: monthly variables, months coded “_xx” end variable names; e.g. “temperature_02” mean monthly temperature February. thorough description variable (including units) can obtained : able get available time steps download dataset. pastclim offers interface download necessary files data path. inspect datasets variables already downloaded data path, can use: Let’s now download bio01 bio05 Beyer2020 dataset (operation might take several minutes, datasets large; R pause download complete): Note multiple variables can packed together single file, get_downloaded_datasets() might list variables ones chose download (depends dataset). upgrading pastclim, new version various datasets might become available. make previously downloaded datasets obsolete, might suddenly told pastclim variables re-downloaded. can lead accumulation old datasets data path. function clean_data_path() can used delete old files longer needed.","code":"vignette(\"custom_datasets\", package = \"pastclim\") vignette(\"available_datasets\", package = \"pastclim\") citation(\"pastclim\") #> To cite pastclim in publications use: #>  #>   Leonardi M, Hallet EY, Beyer R, Krapp M, Manica A (2023). \"pastclim #>   1.2: an R package to easily access and use paleoclimatic #>   reconstructions.\" _Ecography_, *2023*, e06481. doi:10.1111/ecog.06481 #>   . #>  #> A BibTeX entry for LaTeX users is #>  #>   @Article{pastclim-article, #>     title = {pastclim 1.2: an R package to easily access and use paleoclimatic reconstructions}, #>     author = {Michela Leonardi and Emily Y. Hallet and Robert Beyer and Mario Krapp and Andrea Manica}, #>     journal = {Ecography}, #>     year = {2023}, #>     volume = {2023}, #>     pages = {e06481}, #>     publisher = {Wiley}, #>     doi = {10.1111/ecog.06481}, #>   } help(\"Beyer2020\") #> Documentation for the Beyer2020 dataset #>  #> Description: #>  #>      This dataset covers the last 120k years, at intervals of 1/2 k #>      years, and a resolution of 0.5 degrees in latitude and longitude. #>  #> Details: #>  #>      If you use this dataset, make sure to cite the original #>      publication: #>  #>      Beyer, R.M., Krapp, M. & Manica, A. High-resolution terrestrial #>      climate, bioclimate and vegetation for the last 120,000 years. Sci #>      Data 7, 236 (2020). doi:doi.org/10.1038/s41597-020-0552-1 #>       #>  #>      The version included in 'pastclim' has the ice sheets masked, as #>      well as internal seas (Black and Caspian Sea) removed. The latter #>      are based on: #>  #>       #>  #>       #>  #>      As there is no reconstruction of their depth through time, modern #>      outlines were used for all time steps. #>  #>      Also, for bio15, the coefficient of variation was computed after #>      adding one to monthly estimates, and it was multiplied by 100 #>      following  #>  #>      Changelog #>  #>      v1.1.0 Added monthly variables. Files can be downloaded from: #>       #>  #>      v1.0.0 Remove ice sheets and internal seas, and use correct #>      formula for bio15. Files can be downloaded from: #>      doi:doi.org/10.6084/m9.figshare.19723405.v1 #>       library(pastclim) set_data_path() #> Loading required package: terra #> terra 1.7.47 #> The data_path will be set to /home/andrea/.local/share/R/pastclim. #> A copy of the Example dataset will be copied there. #> This path will be saved by pastclim for future use. #> Proceed?  #>  #> 1: Yes #> 2: No set_data_path(path_to_nc = \"~/my_reconstructions\") get_vars_for_dataset(dataset = \"Example\") #> [1] \"bio01\" \"bio10\" \"bio12\" \"biome\" get_time_bp_steps(dataset = \"Example\") #> [1] -20000 -15000 -10000  -5000      0 get_vars_for_dataset(dataset = \"Beyer2020\") #>  [1] \"bio01\"    \"bio04\"    \"bio05\"    \"bio06\"    \"bio07\"    \"bio08\"    #>  [7] \"bio09\"    \"bio10\"    \"bio11\"    \"bio12\"    \"bio13\"    \"bio14\"    #> [13] \"bio15\"    \"bio16\"    \"bio17\"    \"bio18\"    \"bio19\"    \"npp\"      #> [19] \"lai\"      \"biome\"    \"altitude\" \"rugosity\" get_vars_for_dataset(dataset = \"Krapp2021\") #>  [1] \"bio01\"    \"bio04\"    \"bio05\"    \"bio06\"    \"bio07\"    \"bio08\"    #>  [7] \"bio09\"    \"bio10\"    \"bio11\"    \"bio12\"    \"bio13\"    \"bio14\"    #> [13] \"bio15\"    \"bio16\"    \"bio17\"    \"bio18\"    \"bio19\"    \"npp\"      #> [19] \"biome\"    \"lai\"      \"altitude\" \"rugosity\" get_vars_for_dataset(dataset = \"Beyer2020\", annual=FALSE, monthly=TRUE) #>  [1] \"temperature_01\"       \"temperature_02\"       \"temperature_03\"       #>  [4] \"temperature_04\"       \"temperature_05\"       \"temperature_06\"       #>  [7] \"temperature_07\"       \"temperature_08\"       \"temperature_09\"       #> [10] \"temperature_10\"       \"temperature_11\"       \"temperature_12\"       #> [13] \"precipitation_01\"     \"precipitation_02\"     \"precipitation_03\"     #> [16] \"precipitation_04\"     \"precipitation_05\"     \"precipitation_06\"     #> [19] \"precipitation_07\"     \"precipitation_08\"     \"precipitation_09\"     #> [22] \"precipitation_10\"     \"precipitation_11\"     \"precipitation_12\"     #> [25] \"cloudiness_01\"        \"cloudiness_02\"        \"cloudiness_03\"        #> [28] \"cloudiness_04\"        \"cloudiness_05\"        \"cloudiness_06\"        #> [31] \"cloudiness_07\"        \"cloudiness_08\"        \"cloudiness_09\"        #> [34] \"cloudiness_10\"        \"cloudiness_11\"        \"cloudiness_12\"        #> [37] \"relative_humidity_01\" \"relative_humidity_02\" \"relative_humidity_03\" #> [40] \"relative_humidity_04\" \"relative_humidity_05\" \"relative_humidity_06\" #> [43] \"relative_humidity_07\" \"relative_humidity_08\" \"relative_humidity_09\" #> [46] \"relative_humidity_10\" \"relative_humidity_11\" \"relative_humidity_12\" #> [49] \"wind_speed_01\"        \"wind_speed_02\"        \"wind_speed_03\"        #> [52] \"wind_speed_04\"        \"wind_speed_05\"        \"wind_speed_06\"        #> [55] \"wind_speed_07\"        \"wind_speed_08\"        \"wind_speed_09\"        #> [58] \"wind_speed_10\"        \"wind_speed_11\"        \"wind_speed_12\"        #> [61] \"mo_npp_01\"            \"mo_npp_02\"            \"mo_npp_03\"            #> [64] \"mo_npp_04\"            \"mo_npp_05\"            \"mo_npp_06\"            #> [67] \"mo_npp_07\"            \"mo_npp_08\"            \"mo_npp_09\"            #> [70] \"mo_npp_10\"            \"mo_npp_11\"            \"mo_npp_12\" get_vars_for_dataset(dataset=\"Example\", details = TRUE) #>   variable                           long_name           units #> 1    bio01             annual mean temperature degrees Celsius #> 2    bio10 mean temperature of warmest quarter degrees Celsius #> 3    bio12                annual precipitation     mm per year #> 4    biome                 biome (from BIOME4) get_downloaded_datasets() #> $Example #> [1] \"bio01\" \"bio10\" \"bio12\" \"biome\" download_dataset(dataset = \"Beyer2020\", bio_variables = c(\"bio01\", \"bio05\"))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"get-climate-for-locations","dir":"Articles","previous_headings":"","what":"Get climate for locations","title":"pastclim overview","text":"Often want get climate specific locations. can using function location_slice. function, get slices climate times relevant locations interest. Let us consider five possible locations interest: Iho Eleru (Late Stone Age inland site Nigeria), La Riera (Late Palaeolithic coastal site Spain), Chalki (Mesolithic site Greek island), Oronsay (Mesolithic site Scottish Hebrides), Atlantis (fabled submersed city mentioned Plato). site date (realistic, made ) interested associating climatic reconstructions. extract climatic conditions bio01 bio12: pastclim finds closest time step (slice) available given date, outputs slice used column time_bp_slice (Example dataset use vignette temporal resolution 5k years). Note Chalki Atlantis available (get NA) appropriate time steps. occurs location, reconstructions, either water ice, pastclim can return estimate. instances, due discretisation space raster. can interpolate climate among nearest neighbours, thus using climate reconstructions neighbouring pixels location just one land pixels: Chalki, can see problem indeed , since small island, well represented reconstructions (bear mind Example dataset coarse spatial resolution), can reconstruct appropriate climate interpolating. Atlantis, hand, middle ocean, information climate might became submerged (assuming ever existed…). Note nn_interpol = TRUE default function. Sometimes, want get time series climatic reconstructions, thus allowing us see climate changed time: resulting dataframe can subsetted get time series location (small Example dataset contains 5 time slices): Also note locations, climate can available certain time steps, depending sea level ice sheet extent. case Oronsay: can quickly plot bio01 time locations:  expected, don’t data Atlantis (always underwater), also fail retrieve data Chalki. location_series interpolate nearest neighbours default (, differs location_slice behaviour). rationale behaviour interested whether locations might end underwater, want grab climate estimates submerged. However, cases (Chalki) might necessary allow interpolation. Pretty labels environmental variables can generated var_labels:  Note climatic reconstructions extracted Example dataset, coarse, used base real inference environmental conditions. note also higher resolution always better. important consider appropriate spatial scale relevant question hand. Sometimes, might necessary downscale simulations (see section end vignette), cases might want get estimates cover area around specific location (e.g. comparing proxies capture climatology broad area, certain sediment cores capture pollen broader region). location_slice location_series can provide mean estimates areas around location coordinates setting buffer parameter (see help pages functions details).","code":"locations <- data.frame(   name = c(\"Iho Eleru\",\"La Riera\", \"Chalki\", \"Oronsay\",\"Atlantis\"),    longitude = c(5,-4, 27, -6, -24), latitude = c(7, 44, 36, 56, 31),   time_bp = c(-11200, -18738,-10227, -10200, -11600) ) locations #>        name longitude latitude time_bp #> 1 Iho Eleru         5        7  -11200 #> 2  La Riera        -4       44  -18738 #> 3    Chalki        27       36  -10227 #> 4   Oronsay        -6       56  -10200 #> 5  Atlantis       -24       31  -11600 location_slice(   x = locations, bio_variables = c(\"bio01\", \"bio12\"),   dataset = \"Example\", nn_interpol = FALSE ) #>        name longitude latitude time_bp time_bp_slice     bio01    bio12 #> 1 Iho Eleru         5        7  -11200        -10000 25.346703 2204.595 #> 2  La Riera        -4       44  -18738        -20000  5.741851 1149.570 #> 3    Chalki        27       36  -10227        -10000        NA       NA #> 4   Oronsay        -6       56  -10200        -10000  6.937467 1362.824 #> 5  Atlantis       -24       31  -11600        -10000        NA       NA location_slice(   x = locations, bio_variables = c(\"bio01\", \"bio12\"),   dataset = \"Example\", nn_interpol = TRUE) #>        name longitude latitude time_bp time_bp_slice     bio01     bio12 #> 1 Iho Eleru         5        7  -11200        -10000 25.346703 2204.5950 #> 2  La Riera        -4       44  -18738        -20000  5.741851 1149.5703 #> 3    Chalki        27       36  -10227        -10000 17.432425  723.1012 #> 4   Oronsay        -6       56  -10200        -10000  6.937467 1362.8245 #> 5  Atlantis       -24       31  -11600        -10000        NA        NA locations_ts <- location_series(   x = locations,   bio_variables = c(\"bio01\", \"bio12\"),   dataset = \"Example\") subset(locations_ts, name == \"Iho Eleru\") #>          name longitude latitude time_bp    bio01    bio12 #> 1   Iho Eleru         5        7  -20000 22.55133 1577.238 #> 1.1 Iho Eleru         5        7  -15000 23.27008 1850.715 #> 1.2 Iho Eleru         5        7  -10000 25.34670 2204.595 #> 1.3 Iho Eleru         5        7   -5000 25.65009 2109.735 #> 1.4 Iho Eleru         5        7       0 26.77033 1840.845 subset(locations_ts, name == \"Oronsay\") #>        name longitude latitude time_bp    bio01    bio12 #> 4   Oronsay        -6       56  -20000       NA       NA #> 4.1 Oronsay        -6       56  -15000       NA       NA #> 4.2 Oronsay        -6       56  -10000 6.937467 1362.824 #> 4.3 Oronsay        -6       56   -5000 8.167976 1462.253 #> 4.4 Oronsay        -6       56       0 8.185000 1434.490 library(ggplot2) ggplot(data=locations_ts, aes(x=time_bp, y=bio01, group=name)) +   geom_line(aes(col=name))+   geom_point(aes(col=name)) #> Warning: Removed 12 rows containing missing values (`geom_line()`). #> Warning: Removed 12 rows containing missing values (`geom_point()`). library(ggplot2) ggplot(data=locations_ts, aes(x=time_bp, y=bio01, group=name)) +   geom_line(aes(col=name))+   geom_point(aes(col=name))+   labs(y = var_labels(\"bio01\", dataset=\"Example\", abbreviated=TRUE),        x = \"time BP (yr)\") #> Warning: Removed 12 rows containing missing values (`geom_line()`). #> Warning: Removed 12 rows containing missing values (`geom_point()`)."},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"get-climate-for-a-region","dir":"Articles","previous_headings":"","what":"Get climate for a region","title":"pastclim overview","text":"Instead focussing specific locations, might want look whole region. given time step, can extract slice climate returns raster (technically SpatRaster object defined terra library, meaning can perform standard terra raster operations object). interact SpatRaster objects, need library terra loaded (otherwise might get errors correct method found, e.g. plotting). pastclim automatically loads terra, able work terra objects without problem: plot three variables (layers raster):  can add informative labels var_labels:  possible also load time series rasters function region_series. case, function returns SpatRasterDataset, variable sub-dataset: sub-dataset SpatRaster, time steps layers: Note terra stores dates years AD, BP. can inspect times years BP : can plot time series given variable (relabel plots use years bp):  plot climate variables given time step, can slice time series:  Instead giving minimum maximum time step, can also provide specific time steps region_series. Note pastclim function get vector time steps given MIS dataset. example, MIS 1, get: can use:","code":"climate_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\" ) climate_20k #> class       : SpatRaster  #> dimensions  : 150, 360, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -60, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84  #> sources     : example_climate_v1.3.0.nc:BIO1   #>               example_climate_v1.3.0.nc:BIO10   #>               example_climate_v1.3.0.nc:BIO12   #> varnames    : bio01 (annual mean temperature)  #>               bio10 (mean temperature of warmest quarter)  #>               bio12 (annual precipitation)  #> names       :           bio01,           bio10,       bio12  #> unit        : degrees Celsius, degrees Celsius, mm per year  #> time (years): -18050 terra::plot(climate_20k) terra::plot(climate_20k,              main = var_labels(climate_20k, dataset = \"Example\", abbreviated = TRUE)) climate_region <- region_series(   time_bp = list(min = -15000, max = 0),    bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\") climate_region #> class       : SpatRasterDataset  #> subdatasets : 3  #> dimensions  : 150, 360 (nrow, ncol) #> nlyr        : 4, 4, 4  #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -60, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84  #> source(s)   : example_climate_v1.3.0.nc  #> names       : bio01, bio10, bio12 climate_region$bio01 #> class       : SpatRaster  #> dimensions  : 150, 360, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -60, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84  #> source      : example_climate_v1.3.0.nc:BIO1  #> varname     : bio01 (annual mean temperature)  #> names       :    bio01_-15000,    bio01_-10000,     bio01_-5000,         bio01_0  #> unit        : degrees Celsius, degrees Celsius, degrees Celsius, degrees Celsius  #> time (years): -13050 to 1950 time_bp(climate_region) #> [1] -15000 -10000  -5000      0 terra::plot(climate_region$bio01, main=time_bp(climate_region)) slice_10k <- slice_region_series(climate_region, time_bp = -10000) terra::plot(slice_10k) mis1_steps <- get_mis_time_steps(mis = 1, dataset = \"Example\") mis1_steps #> [1] -10000  -5000      0 climate_mis1 <- region_series(   time_bp = mis1_steps,    bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\" ) climate_mis1 #> class       : SpatRasterDataset  #> subdatasets : 3  #> dimensions  : 150, 360 (nrow, ncol) #> nlyr        : 3, 3, 3  #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -60, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84  #> source(s)   : example_climate_v1.3.0.nc  #> names       : bio01, bio10, bio12"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"cropping","dir":"Articles","previous_headings":"","what":"Cropping","title":"pastclim overview","text":"Often want focus given region. number preset rectangular extents pastclim: can get corners European extent: can extract climate Europe setting ext region_slice:  can see plot, cutting Europe using rectangular shape keeps portion Northern Africa map. pastclim includes number pre-generated masks main continental masses, stored dataset region_outline sf::sfc object. can get list : can use function crop within region_slice keep area within desired outline.  can combine multiple regions together. example, can crop Africa Eurasia unioning two individual outlines:  Note outlines cross antimeridian split multiple polygons (can used without projecting rasters). Eurasia, eastern end Siberia left hand side plot. continent_outlines_union provides outlines single polygons (case want use projection). can also use custom outline (.e. polygon, coded terra::vect object) mask limit area covered raster. Note need reuse first vertex last vertex, close polygon:  region_series takes ext crop options region_slice limit extent climatic reconstructions.","code":"names(region_extent) #> [1] \"Africa\"    \"America\"   \"Asia\"      \"Europe\"    \"Eurasia\"   \"N_America\" #> [7] \"Oceania\"   \"S_America\" region_extent$Europe #> [1] -15  70  33  75 europe_climate_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   ext = region_extent$Europe ) terra::plot(europe_climate_20k) names(region_outline) #> [1] \"Africa\"    \"Eurasia\"   \"N_America\" \"Oceania\"   \"S_America\" \"Europe\" europe_climate_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   crop = region_outline$Europe ) terra::plot(europe_climate_20k) library(sf) #> Linking to GEOS 3.10.2, GDAL 3.4.1, PROJ 8.2.1; sf_use_s2() is TRUE afr_eurasia <- sf::st_union(region_outline$Africa, region_outline$Eurasia) climate_20k_afr_eurasia <- region_slice(   time_bp = -20000,   bio_variables  = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   crop = afr_eurasia) terra::plot(climate_20k_afr_eurasia) custom_vec <- terra::vect(\"POLYGON ((0 70, 25 70, 50 80, 170 80, 170 10,                               119 2.4, 119 0.8, 116 -7.6, 114 -12, 100 -40,                               -25 -40, -25 64, 0 70))\") climate_20k_custom <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   crop = custom_vec) terra::plot(climate_20k_custom)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"working-with-biomes-and-ice-sheets","dir":"Articles","previous_headings":"","what":"Working with biomes and ice sheets","title":"pastclim overview","text":"Beyer2020 Krapp2021 datasets include categorical variable detailing extension biomes. need plot extent specific biome, example desert, first extract variable subset just class interested using ID (21, case):  climate reconstructions show areas permanent ice. Ice sheets stored class 28 “biome” variable. can retrieve directly ice land (biome categories) masks :  can also add ice sheets plots climatic variables. First, need turn ice mask polygons: can add polygons layer (.e. variable) climate slice following code (note , add polygons every panel figure, need create function used argument fun within plot):  cases, multiple time points variable want see ice sheets change:  Note add ice sheets instance, build function takes single parameter index image (.e. 1 4 plot ) use subset list ice outlines. Sometimes interesting measure distance coastline (e.g. modelling species rely brackish water, determine distance marine resources archaeology). pastclim, can use use distance_from_sea, accounts sea level change based landmask:","code":"get_biome_classes(\"Example\") #>    id                           category #> 1   0                       Water bodies #> 2   1          Tropical evergreen forest #> 3   2     Tropical semi-deciduous forest #> 4   3 Tropical deciduous forest/woodland #> 5   4         Temperate deciduous forest #> 6   5           Temperate conifer forest #> 7   6                  Warm mixed forest #> 8   7                  Cool mixed forest #> 9   8                Cool conifer forest #> 10  9                  Cold mixed forest #> 11 10      Evegreen taiga/montane forest #> 12 11     Deciduous taiga/montane forest #> 13 12                   Tropical savanna #> 14 13      Tropical xerophytic shrubland #> 15 14     Temperate xerophytic shrubland #> 16 15     Temperate sclerophyll woodland #> 17 16      Temperate broadleaved savanna #> 18 17              Open conifer woodland #> 19 18                    Boreal parkland #> 20 19                 Tropical grassland #> 21 20                Temperate grassland #> 22 21                             Desert #> 23 22                      Steppe tundra #> 24 23                       Shrub tundra #> 25 24                 Dwarf shrub tundra #> 26 25             Prostrate shrub tundra #> 27 26    Cushion forb lichen moss tundra #> 28 27                             Barren #> 29 28                           Land ice biome_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"biome\"),   dataset = \"Example\" ) biome_20k$desert <- biome_20k$biome biome_20k$desert[biome_20k$desert != 21] <- FALSE biome_20k$desert[biome_20k$desert == 21] <- TRUE terra::plot(biome_20k) ice_mask <- get_ice_mask(-20000, dataset = \"Example\") land_mask <- get_land_mask(-20000, dataset = \"Example\") terra::plot(c(ice_mask, land_mask)) ice_mask_vect <- as.polygons(ice_mask) plot(climate_20k,       fun=function() polys(ice_mask_vect, col=\"gray\", lwd=0.5)) europe_climate <- region_series(   time_bp = c(-20000, -15000, -10000, 0),   bio_variables = c(\"bio01\"),   dataset = \"Example\",   ext = region_extent$Europe ) ice_masks <- get_ice_mask(c(-20000, -15000, -10000, 0),                           dataset = \"Example\") ice_poly_list<- lapply(ice_masks, as.polygons) plot(europe_climate$bio01, main=time_bp(europe_climate),      fun=function(i) polys(ice_poly_list[[i]],                             col=\"gray\",                            lwd=0.5)) distances_sea <- distance_from_sea(time_bp = c(-20000,0), dataset=\"Example\") #>  |---------|---------|---------|---------| =========================================                                             |---------|---------|---------|---------| =========================================                                            distances_sea_australia <- crop(distances_sea, terra::ext(100,170,-60,20)) plot(distances_sea_australia, main=time_bp(distances_sea_australia))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"adding-locations-to-region-plots","dir":"Articles","previous_headings":"","what":"Adding locations to region plots","title":"pastclim overview","text":"plot locations region plots, first need create SpatVector object dataframe metadata, specifying names columns x y coordinates: can add climate slice following code (note , add points every panel figure, need create function used argument fun within plot):  points within extent region plotted (, case, European locations). can combine ice sheets locations single plot:","code":"locations_vect <- vect(locations, geom=c(\"longitude\", \"latitude\")) locations_vect #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : -24, 27, 7, 56  (xmin, xmax, ymin, ymax) #>  coord. ref. :   #>  names       :      name    time_bp #>  type        :            #>  values      : Iho Eleru  -1.12e+04 #>                 La Riera -1.874e+04 #>                   Chalki -1.023e+04 plot(europe_climate_20k,       fun=function() points(locations_vect, col=\"red\", cex=2)) plot(europe_climate_20k,       fun=function() {         polys(ice_mask_vect, col=\"gray\", lwd=0.5)         points(locations_vect, col=\"red\", cex=2)      })"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"set-the-samples-within-the-background","dir":"Articles","previous_headings":"","what":"Set the samples within the background","title":"pastclim overview","text":"many studies, want set environmental conditions given set location within background time period. Let us start visualising background time step interest PCA:  can now get climatic conditions locations time step compute PCA scores based axes defined background: now can plot points top background  want pool background multiple time steps, can simple use region_series get series, transform data frame df_from_region_series.","code":"bio_vars <- c(\"bio01\", \"bio10\", \"bio12\") climate_10k <- region_slice(-10000,   bio_variables = bio_vars,   dataset = \"Example\" ) climate_values_10k <- df_from_region_slice(climate_10k) climate_10k_pca <- prcomp(climate_values_10k[, bio_vars],                            scale = TRUE, center = TRUE) plot(climate_10k_pca$x[, 2] ~ climate_10k_pca$x[, 1],   pch = 20, col = \"lightgray\",   xlab = \"PC1\", ylab = \"PC2\" ) locations_10k <- data.frame(   longitude = c(0, 90, 20, 5), latitude = c(20, 45, 50, 47),   time_bp = c(-9932, -9753, -10084, -10249) ) climate_loc_10k <- location_slice(   x = locations_10k[, c(\"longitude\", \"latitude\")],   time_bp = locations_10k$time_bp, bio_variables = bio_vars,   dataset = \"Example\" ) locations_10k_pca_scores <- predict(climate_10k_pca,                                      newdata = climate_loc_10k[, bio_vars]) plot(climate_10k_pca$x[, 2] ~ climate_10k_pca$x[, 1],   pch = 20, col = \"lightgray\",   xlab = \"PC1\", ylab = \"PC2\" ) points(locations_10k_pca_scores, pch = 20, col = \"red\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"random-sampling-of-background","dir":"Articles","previous_headings":"","what":"Random sampling of background","title":"pastclim overview","text":"instances (e.g. underlying raster large handle), might desirable sample background instead using values. interested single time step, can simply generate raster time slice interest, use sample_region_slice: samples multiple time steps, need sample background proportionally number points time step. , example, wanted 30 samples 20k years ago 50 samples 10k years ago: use data build PCA.","code":"climate_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\"),   dataset = \"Example\" ) this_sample <- sample_region_slice(climate_20k, size = 100) head(this_sample) #>    cell     x    y      bio01      bio10 #> 1 21505  84.5 30.5 -10.043381  0.9198932 #> 2 19382 121.5 36.5   6.944111 26.2095699 #> 3  7874 133.5 68.5 -25.195515  7.8242626 #> 4 21525 104.5 30.5  13.136123 20.9693165 #> 5 33337  36.5 -2.5  16.658417 17.6095238 #> 6 25467  86.5 19.5  24.064934 26.5013103 climate_ts <- region_series(   time_bp = c(-20000,-10000),   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   ext = terra::ext(region_extent$Europe) ) sampled_climate <- sample_region_series(climate_ts, size = c(3,5)) sampled_climate #>          cell    x    y      bio01    bio10     bio12 time_bp #> -20000.1 3294 48.5 36.5  3.9929693 14.70691  259.1800  -20000 #> -20000.2 3343 12.5 35.5 15.9990892 26.56406  192.0470  -20000 #> -20000.3 1581 35.5 56.5 -7.2382975 10.27890  611.5366  -20000 #> -10000.1 3119 43.5 38.5  6.6280322 22.53080  340.6419  -10000 #> -10000.2  377 21.5 70.5 -2.7576876 10.16395  642.6003  -10000 #> -10000.3 1775 59.5 54.5 -0.4912275 19.61463  424.3754  -10000 #> -10000.4 1181 60.5 61.5 -3.1943440 15.80031  410.8481  -10000 #> -10000.5  959  8.5 63.5  3.8759172 11.67554 1077.2959  -10000"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"downscaling","dir":"Articles","previous_headings":"","what":"Downscaling","title":"pastclim overview","text":"pastclim contain built-code change spatial resolution climatic reconstructions, possible downscale data using relevant function terra package. first need extract region time choice, case Europe 10,000 years ago  can downscale using disagg() function terra package, requiring aggregation factor expressed number cells direction (horizontally, vertically, , needed, layers). example used 25 horizontally vertically, using bilinear interpolation.  Note , whilst smoothed climate, land mask changed, thus still blocky edges.","code":"europe_10k <- region_slice(dataset=\"Example\",                             bio_variables = c(\"bio01\"),                            time_bp=-10000, ext=region_extent$Europe) terra::plot(europe_10k) europe_ds <- terra::disagg(europe_10k, fact=25, method='bilinear') terra::plot(europe_ds)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a1_available_datasets.html","id":"overview-of-datasets-available-in-pastclim","dir":"Articles","previous_headings":"","what":"Overview of datasets available in pastclim","title":"available datasets","text":"number datasets available pastclim. possible use custom datasets long properly formatted (look article format custom datasets interested). possible get list available datasets : comprehensive list can obtained : dataset, can get detailed information using help function: provide full documentation dataset (sorted alphabetical order):","code":"library(pastclim) #> Loading required package: terra #> terra 1.7.47 get_available_datasets() #> [1] \"Example\"   \"Beyer2020\" \"Krapp2021\" #> for present day reconstructions, use \"WorldClim_2.1_RESm\", where RES is an available resolution. #> for future predictions, use \"WorldClim_2.1_GCM_SSP_RESm\", where GCM is the GCM model, SSP is the Shared Societ-economic Pathways scenario. #> use help(\"WorldClim_2.1\") for a list of available options list_available_datasets() #>   [1] \"Example\"                                  #>   [2] \"Beyer2020\"                                #>   [3] \"Krapp2021\"                                #>   [4] \"WorldClim_2.1_10m\"                        #>   [5] \"WorldClim_2.1_5m\"                         #>   [6] \"WorldClim_2.1_ACCESS-CM2_ssp126_10m\"      #>   [7] \"WorldClim_2.1_ACCESS-CM2_ssp126_5m\"       #>   [8] \"WorldClim_2.1_ACCESS-CM2_ssp245_10m\"      #>   [9] \"WorldClim_2.1_ACCESS-CM2_ssp245_5m\"       #>  [10] \"WorldClim_2.1_ACCESS-CM2_ssp370_10m\"      #>  [11] \"WorldClim_2.1_ACCESS-CM2_ssp370_5m\"       #>  [12] \"WorldClim_2.1_ACCESS-CM2_ssp585_10m\"      #>  [13] \"WorldClim_2.1_ACCESS-CM2_ssp585_5m\"       #>  [14] \"WorldClim_2.1_BCC-CSM2-MR_ssp126_10m\"     #>  [15] \"WorldClim_2.1_BCC-CSM2-MR_ssp126_5m\"      #>  [16] \"WorldClim_2.1_BCC-CSM2-MR_ssp245_10m\"     #>  [17] \"WorldClim_2.1_BCC-CSM2-MR_ssp245_5m\"      #>  [18] \"WorldClim_2.1_BCC-CSM2-MR_ssp370_10m\"     #>  [19] \"WorldClim_2.1_BCC-CSM2-MR_ssp370_5m\"      #>  [20] \"WorldClim_2.1_BCC-CSM2-MR_ssp585_10m\"     #>  [21] \"WorldClim_2.1_BCC-CSM2-MR_ssp585_5m\"      #>  [22] \"WorldClim_2.1_CMCC-ESM2_ssp126_10m\"       #>  [23] \"WorldClim_2.1_CMCC-ESM2_ssp126_5m\"        #>  [24] \"WorldClim_2.1_CMCC-ESM2_ssp245_10m\"       #>  [25] \"WorldClim_2.1_CMCC-ESM2_ssp245_5m\"        #>  [26] \"WorldClim_2.1_CMCC-ESM2_ssp370_10m\"       #>  [27] \"WorldClim_2.1_CMCC-ESM2_ssp370_5m\"        #>  [28] \"WorldClim_2.1_CMCC-ESM2_ssp585_10m\"       #>  [29] \"WorldClim_2.1_CMCC-ESM2_ssp585_5m\"        #>  [30] \"WorldClim_2.1_EC-Earth3-Veg_ssp126_10m\"   #>  [31] \"WorldClim_2.1_EC-Earth3-Veg_ssp126_5m\"    #>  [32] \"WorldClim_2.1_EC-Earth3-Veg_ssp245_10m\"   #>  [33] \"WorldClim_2.1_EC-Earth3-Veg_ssp245_5m\"    #>  [34] \"WorldClim_2.1_EC-Earth3-Veg_ssp370_10m\"   #>  [35] \"WorldClim_2.1_EC-Earth3-Veg_ssp370_5m\"    #>  [36] \"WorldClim_2.1_EC-Earth3-Veg_ssp585_10m\"   #>  [37] \"WorldClim_2.1_EC-Earth3-Veg_ssp585_5m\"    #>  [38] \"WorldClim_2.1_FIO-ESM-2-0_ssp126_10m\"     #>  [39] \"WorldClim_2.1_FIO-ESM-2-0_ssp126_5m\"      #>  [40] \"WorldClim_2.1_FIO-ESM-2-0_ssp245_10m\"     #>  [41] \"WorldClim_2.1_FIO-ESM-2-0_ssp245_5m\"      #>  [42] \"WorldClim_2.1_FIO-ESM-2-0_ssp370_10m\"     #>  [43] \"WorldClim_2.1_FIO-ESM-2-0_ssp370_5m\"      #>  [44] \"WorldClim_2.1_FIO-ESM-2-0_ssp585_10m\"     #>  [45] \"WorldClim_2.1_FIO-ESM-2-0_ssp585_5m\"      #>  [46] \"WorldClim_2.1_GFDL-ESM4_ssp126_10m\"       #>  [47] \"WorldClim_2.1_GFDL-ESM4_ssp126_5m\"        #>  [48] \"WorldClim_2.1_GFDL-ESM4_ssp245_10m\"       #>  [49] \"WorldClim_2.1_GFDL-ESM4_ssp245_5m\"        #>  [50] \"WorldClim_2.1_GFDL-ESM4_ssp370_10m\"       #>  [51] \"WorldClim_2.1_GFDL-ESM4_ssp370_5m\"        #>  [52] \"WorldClim_2.1_GFDL-ESM4_ssp585_10m\"       #>  [53] \"WorldClim_2.1_GFDL-ESM4_ssp585_5m\"        #>  [54] \"WorldClim_2.1_GISS-E2-1-G_ssp126_10m\"     #>  [55] \"WorldClim_2.1_GISS-E2-1-G_ssp126_5m\"      #>  [56] \"WorldClim_2.1_GISS-E2-1-G_ssp245_10m\"     #>  [57] \"WorldClim_2.1_GISS-E2-1-G_ssp245_5m\"      #>  [58] \"WorldClim_2.1_GISS-E2-1-G_ssp370_10m\"     #>  [59] \"WorldClim_2.1_GISS-E2-1-G_ssp370_5m\"      #>  [60] \"WorldClim_2.1_GISS-E2-1-G_ssp585_10m\"     #>  [61] \"WorldClim_2.1_GISS-E2-1-G_ssp585_5m\"      #>  [62] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp126_10m\" #>  [63] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp126_5m\"  #>  [64] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\" #>  [65] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_5m\"  #>  [66] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp370_10m\" #>  [67] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp370_5m\"  #>  [68] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp585_10m\" #>  [69] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp585_5m\"  #>  [70] \"WorldClim_2.1_INM-CM5-0_ssp126_10m\"       #>  [71] \"WorldClim_2.1_INM-CM5-0_ssp126_5m\"        #>  [72] \"WorldClim_2.1_INM-CM5-0_ssp245_10m\"       #>  [73] \"WorldClim_2.1_INM-CM5-0_ssp245_5m\"        #>  [74] \"WorldClim_2.1_INM-CM5-0_ssp370_10m\"       #>  [75] \"WorldClim_2.1_INM-CM5-0_ssp370_5m\"        #>  [76] \"WorldClim_2.1_INM-CM5-0_ssp585_10m\"       #>  [77] \"WorldClim_2.1_INM-CM5-0_ssp585_5m\"        #>  [78] \"WorldClim_2.1_IPSL-CM6A-LR_ssp126_10m\"    #>  [79] \"WorldClim_2.1_IPSL-CM6A-LR_ssp126_5m\"     #>  [80] \"WorldClim_2.1_IPSL-CM6A-LR_ssp245_10m\"    #>  [81] \"WorldClim_2.1_IPSL-CM6A-LR_ssp245_5m\"     #>  [82] \"WorldClim_2.1_IPSL-CM6A-LR_ssp370_10m\"    #>  [83] \"WorldClim_2.1_IPSL-CM6A-LR_ssp370_5m\"     #>  [84] \"WorldClim_2.1_IPSL-CM6A-LR_ssp585_10m\"    #>  [85] \"WorldClim_2.1_IPSL-CM6A-LR_ssp585_5m\"     #>  [86] \"WorldClim_2.1_MIROC6_ssp126_10m\"          #>  [87] \"WorldClim_2.1_MIROC6_ssp126_5m\"           #>  [88] \"WorldClim_2.1_MIROC6_ssp245_10m\"          #>  [89] \"WorldClim_2.1_MIROC6_ssp245_5m\"           #>  [90] \"WorldClim_2.1_MIROC6_ssp370_10m\"          #>  [91] \"WorldClim_2.1_MIROC6_ssp370_5m\"           #>  [92] \"WorldClim_2.1_MIROC6_ssp585_10m\"          #>  [93] \"WorldClim_2.1_MIROC6_ssp585_5m\"           #>  [94] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp126_10m\"   #>  [95] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp126_5m\"    #>  [96] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp245_10m\"   #>  [97] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp245_5m\"    #>  [98] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp370_10m\"   #>  [99] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp370_5m\"    #> [100] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp585_10m\"   #> [101] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp585_5m\"    #> [102] \"WorldClim_2.1_MRI-ESM2-0_ssp126_10m\"      #> [103] \"WorldClim_2.1_MRI-ESM2-0_ssp126_5m\"       #> [104] \"WorldClim_2.1_MRI-ESM2-0_ssp245_10m\"      #> [105] \"WorldClim_2.1_MRI-ESM2-0_ssp245_5m\"       #> [106] \"WorldClim_2.1_MRI-ESM2-0_ssp370_10m\"      #> [107] \"WorldClim_2.1_MRI-ESM2-0_ssp370_5m\"       #> [108] \"WorldClim_2.1_MRI-ESM2-0_ssp585_10m\"      #> [109] \"WorldClim_2.1_MRI-ESM2-0_ssp585_5m\"       #> [110] \"WorldClim_2.1_UKESM1-0-LL_ssp126_10m\"     #> [111] \"WorldClim_2.1_UKESM1-0-LL_ssp126_5m\"      #> [112] \"WorldClim_2.1_UKESM1-0-LL_ssp245_10m\"     #> [113] \"WorldClim_2.1_UKESM1-0-LL_ssp245_5m\"      #> [114] \"WorldClim_2.1_UKESM1-0-LL_ssp370_10m\"     #> [115] \"WorldClim_2.1_UKESM1-0-LL_ssp370_5m\"      #> [116] \"WorldClim_2.1_UKESM1-0-LL_ssp585_10m\"     #> [117] \"WorldClim_2.1_UKESM1-0-LL_ssp585_5m\" help(\"Example\") #> Documentation for the Example dataset #>  #> Description: #>  #>      This dataset is a subset of Beyer2020, used for the vignette of #>      pastclim. Do not use this dataset for any real work, as it might #>      not reflect the most up-to-date version of Beyer2020. #> Documentation for the Beyer2020 dataset #>  #> Description: #>  #>      This dataset covers the last 120k years, at intervals of 1/2 k #>      years, and a resolution of 0.5 degrees in latitude and longitude. #>  #> Details: #>  #>      If you use this dataset, make sure to cite the original #>      publication: #>  #>      Beyer, R.M., Krapp, M. & Manica, A. High-resolution terrestrial #>      climate, bioclimate and vegetation for the last 120,000 years. Sci #>      Data 7, 236 (2020). doi:doi.org/10.1038/s41597-020-0552-1 #>       #>  #>      The version included in 'pastclim' has the ice sheets masked, as #>      well as internal seas (Black and Caspian Sea) removed. The latter #>      are based on: #>  #>       #>  #>       #>  #>      As there is no reconstruction of their depth through time, modern #>      outlines were used for all time steps. #>  #>      Also, for bio15, the coefficient of variation was computed after #>      adding one to monthly estimates, and it was multiplied by 100 #>      following  #>  #>      Changelog #>  #>      v1.1.0 Added monthly variables. Files can be downloaded from: #>       #>  #>      v1.0.0 Remove ice sheets and internal seas, and use correct #>      formula for bio15. Files can be downloaded from: #>      doi:doi.org/10.6084/m9.figshare.19723405.v1 #>       #>  #>  #> ####################################################### #> Documentation for the Example dataset #>  #> Description: #>  #>      This dataset is a subset of Beyer2020, used for the vignette of #>      pastclim. Do not use this dataset for any real work, as it might #>      not reflect the most up-to-date version of Beyer2020. #>  #>  #> ####################################################### #> Documentation for the Krapp2021 dataset #>  #> Description: #>  #>      This dataset covers the last 800k years, at intervals of 1k years, #>      and a resolution of 0.5 degrees in latitude and longitude. #>  #> Details: #>  #>      If you use this dataset, make sure to cite the original #>      publication: #>  #>      Krapp, M., Beyer, R.M., Edmundson, S.L. et al. A statistics-based #>      reconstruction of high-resolution global terrestrial climate for #>      the last 800,000 years. Sci Data 8, 228 (2021). #>      doi:doi.org/10.1038/s41597-021-01009-3 #>       #>  #>      The version included in 'pastclim' has the ice sheets masked. #>  #>      Note that, for bio15, we use the corrected version, which follows #>       #>  #>      Changelog #>  #>      v1.1.0 Added monthly variables. Files can be downloaded from: #>       #>  #>      v1.0.0 Remove ice sheets and use correct formula for bio15. Files #>      can be downloaded from: #>      doi:doi.org/10.6084/m9.figshare.19733680.v1 #>       #>  #>  #> ####################################################### #> Documentation for the WorldClim datasets #>  #> Description: #>  #>      WorldClim version 2.1 is a database of high spatial resolution #>      global weather and climate data, covering both the present and #>      future projections. #>  #> Details: #>  #>      *Present-day reconstructions* are based on the mean for the period #>      1970-2000, and are available at multiple resolutions of 10 #>      arc-minutes, 5 arc-minutes, 2.5 arc-minute and 0.5 arc-minutes. #>      The resolution of interest can be obtained by changing the ending #>      of the dataset name _WorldClim_2.1_RESm_, e.g. _WorldClim_2.1_10m_ #>      or _WorldClim_2.1_5m_ (currently, only 10m and 5m are currently #>      available in 'pastclim'). In 'pastclim', the datasets are given a #>      date of 1985 CE (the mid-point of the period of interest), #>      corresponding to a time_bp of 35. There are 19 <80><9c>bioclimatic<80><9d> #>      variables, as well as monthly estimates for minimum, mean, and #>      maximum temperature, and precipitation. #>  #>      *Future projections* are based on the models in CMIP6, downscaled #>      and de-biased using WorldClim 2.1 for the present as a baseline. #>      Monthly values of minimum temperature, maximum temperature, and #>      precipitation, as well as 19 bioclimatic variables were processed #>      for 23 global climate models (GCMs), and for four Shared #>      Socio-economic Pathways (SSPs): 126, 245, 370 and 585. Model and #>      SSP can be chosen by changing the ending of the dataset name #>      _WorldClim_2.1_GCM_SSP_RESm_. #>  #>      Available values for GCM are: \"ACCESS-CM2\", \"BCC-CSM2-MR\", #>      \"CMCC-ESM2\", \"EC-Earth3-Veg\", \"FIO-ESM-2-0\", \"GFDL-ESM4\", #>      \"GISS-E2-1-G\", \"HadGEM3-GC31-LL\", \"INM-CM5-0\", \"IPSL-CM6A-LR\", #>      \"MIROC6\", \"MPI-ESM1-2-HR\", \"MRI-ESM2-0\", and \"UKESM1-0-LL\". For #>      SSP, use: \"ssp126\", \"ssp245\", \"ssp370\", and \"ssp585\". RES takes #>      the same values as for present reconstructions (i.e. \"10m\", \"5m\", #>      \"2.5m\", and \"0.5m\"). Example dataset names are #>      _WorldClim_2.1_ACCESS-CM2_ssp245_10m_ and #>      _WorldClim_2.1_MRI-ESM2-0_ssp370_5m_ #>  #>      The dataset are averages over 20 year periods (2021-2040, #>      2041-2060, 2061-2080, 2081-2100). In 'pastclim', the midpoints of #>      the periods (2030, 2050, 2070, 2090) are used as the time stamps. #>      All 4 periods are automatically downloaded for each combination of #>      GCM model and SSP, and are selected as usual by defining the time #>      in functions such as 'region_slice()'. #>  #>      If you use this dataset, make sure to cite the original #>      publication: #>  #>      Fick, S.E. and R.J. Hijmans, 2017. WorldClim 2: new 1km spatial #>      resolution climate surfaces for global land areas. International #>      Journal of Climatology 37 (12): 4302-4315. #>      doi:doi.org/10.1002/joc.5086 #>       #>  #>  #> #######################################################"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a2_custom_datasets.html","id":"formatting-a-custom-dataset-for-pastclim","dir":"Articles","previous_headings":"","what":"Formatting a custom dataset for pastclim","title":"custom dataset","text":"guide aimed formatting data way can used pastclim. pastclim designed extract data netcdf files, format commonly used storing climate reconstructions. netcdf files number advantages, can store compressed information, well allowing access data required (e.g. extracting time steps location interest without reading data memory). expected format pastclim requires time steps given variable stored within single netcdf file. variables combined () flexible: can separate file variable, collate everything within single file, create multiple files including number variables. time variable years since 1950 (.e. negative integers indicating past). number command line tools well R libraries (e.g. cdo, gdal, terra) can help creating editing netcdf files.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a2_custom_datasets.html","id":"an-example-the-trace21k-chelsea","dir":"Articles","previous_headings":"","what":"An example: the Trace21k-CHELSEA","title":"custom dataset","text":"provide simple example format dataset R. use version Trace21k dataset, downscaled 30 arcsecs using CHELSEA algorithm(available website). data stored geoTIFF files, one file per time step per variable. First, need collate files given variable (use bio01 example) within single netcdf file. original files large, illustrate time steps aggregated 3x3 degrees keep files sizes small. start translating geoTIFF netcdf file. files prefix CHELSA_TraCE21k_bio01_-xxx_V1.0.small.tif, xxx number time step. use 3 time step illustrative purposes. store files single directory, create spatRaster list files directory: NOTE: terra changed way handles time reading netcdf. dev version terra can easily format netcdf files correctly, vignette presents number workarounds needed version CRAN Now need set time axis raster (case, reconstructions every 100 years), generate user friendly names layers raster: Now save data nc file (use temporary directory) can now read custom netcdf file pastclim. expected, one variable (“bio01”) 3 time steps (nlyr). can get times time steps : can slice series plot given time point:  Note reconstructions include ocean ice sheets, much better remove needed ecological/archaeological studies (allows smaller files).","code":"tiffs_path <- system.file(\"extdata/CHELSA_bio01\",package=\"pastclim\") list_of_tiffs <- file.path(tiffs_path,dir(tiffs_path)) bio01 <- terra::rast(list_of_tiffs) library(pastclim) #> Loading required package: terra #> terra 1.7.47 time_bp(bio01)<-c(0,-100,-200) names(bio01)<-paste(\"bio01\",terra::time(bio01),sep=\"_\") nc_name <- file.path(tempdir(),\"CHELSA_TraCE21k_bio01.nc\") terra::writeCDF(bio01, filename = nc_name, varname = \"bio01\",                 compression = 9, overwrite=TRUE) custom_series <- region_series(bio_variables = \"bio01\",                                 dataset = \"custom\",                                 path_to_nc = nc_name ) custom_series #> class       : SpatRasterDataset  #> subdatasets : 1  #> dimensions  : 174, 360 (nrow, ncol) #> nlyr        : 3  #> resolution  : 1, 1  (x, y) #> extent      : -180.0001, 179.9999, -90.00014, 83.99986  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : CHELSA_TraCE21k_bio01.nc  #> names       : bio01 get_time_bp_steps(dataset=\"custom\", path_to_nc = nc_name) #> [1]    0 -100 -200 climate_100<-slice_region_series(custom_series, time_bp = -100) terra::plot(climate_100)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a2_custom_datasets.html","id":"making-the-data-available-to-others","dir":"Articles","previous_headings":"","what":"Making the data available to others","title":"custom dataset","text":"created suitably formatted netcdf files can used custom datasets pastclim, can add data officially package, thus make available others. necessary steps: Put files freely available repository. Update table used pastclim store information available datasets. table found “./data-raw/data_files/dataset_list_included.csv”. includes following fields: variable: variable name used pastclim ncvar: variable name within nc file (can variable) dataset: name dataset. monthly: boolean whether variable monthly. file_name: name file variable. download_path: URL download file. donwload_function: datasets can easily converted user valid netcdf, possibly leave download_path empty, create internal function downloads converts files. example, see WorldClim datasets. file_name_orig: name original file(s) used create nc dataset. download_path_orig: path original files. version: version dataset created long_name: long name variable abbreviated_name: abbreviated version long_name (used plot labels) time_frame: either year appropriate month units: units variable, displayed plain text table units_exp: units formatted included expression creating plot labels added lines detailing variables dataset, run script “./raw-data/dataset_list_included.R” store information appropriate dataset pastclim. Provide information new dataset file “./R/dataset_docs”, using roxygen2 syntax. Make sure provide appropriate reference original data, important users can refer back original source. Make Pull Request GitHub.","code":"#>   variable ncvar dataset monthly                 file_name download_path #> 1    bio01  BIO1 Example   FALSE example_climate_v1.3.0.nc               #> 2    bio10 BIO10 Example   FALSE example_climate_v1.3.0.nc               #>   download_function file_name_orig download_path_orig version #> 1                                                       1.3.0 #> 2                                                       1.3.0 #>                             long_name      abbreviated_name time_frame #> 1             annual mean temperature           ann. mean T       year #> 2 mean temperature of warmest quarter mean T of warmest qtr       year #>             units  units_exp dataset_list_v #> 1 degrees Celsius *degree*C*          1.3.9 #> 2 degrees Celsius *degree*C*"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a3_pastclim_present_and_future.html","id":"present-reconstructions","dir":"Articles","previous_headings":"","what":"Present reconstructions","title":"present and future","text":"Present-day reconstructions WorldClim v2.1 based mean period 1970-2000, available multiple resolutions 10 arc-minutes, 5 arc-minutes, 2.5 arc-minute 0.5 arc-minutes. resolution interest can obtained changing ending dataset name WorldClim_2.1_RESm, e.g. WorldClim_2.1_10m WorldClim_2.1_5m (currently, 10m 5m currently available pastclim). pastclim, datasets given date 1985 CE (mid-point period interest), corresponding time_bp 35. 19 “bioclimatic” variables, well monthly estimates minimum, mean, maximum temperature, precipitation. , annual variables 10m arc-minutes dataset : monthly variables can manipulate data usual way. start downloading dataset: can use region_slice extract data SpatRaster:","code":"library(pastclim) #> Loading required package: terra #> terra 1.7.47 get_vars_for_dataset(\"WorldClim_2.1_10m\") #>  [1] \"bio01\"    \"bio02\"    \"bio03\"    \"bio04\"    \"bio05\"    \"bio06\"    #>  [7] \"bio07\"    \"bio08\"    \"bio09\"    \"bio10\"    \"bio11\"    \"bio12\"    #> [13] \"bio13\"    \"bio14\"    \"bio15\"    \"bio16\"    \"bio17\"    \"bio18\"    #> [19] \"bio19\"    \"altitude\" get_vars_for_dataset(\"WorldClim_2.1_10m\", monthly =TRUE, annual=FALSE) #>  [1] \"temperature_01\"     \"temperature_02\"     \"temperature_03\"     #>  [4] \"temperature_04\"     \"temperature_05\"     \"temperature_06\"     #>  [7] \"temperature_07\"     \"temperature_08\"     \"temperature_09\"     #> [10] \"temperature_10\"     \"temperature_11\"     \"temperature_12\"     #> [13] \"precipitation_01\"   \"precipitation_02\"   \"precipitation_03\"   #> [16] \"precipitation_04\"   \"precipitation_05\"   \"precipitation_06\"   #> [19] \"precipitation_07\"   \"precipitation_08\"   \"precipitation_09\"   #> [22] \"precipitation_10\"   \"precipitation_11\"   \"precipitation_12\"   #> [25] \"temperature_min_01\" \"temperature_min_02\" \"temperature_min_03\" #> [28] \"temperature_min_04\" \"temperature_min_05\" \"temperature_min_06\" #> [31] \"temperature_min_07\" \"temperature_min_08\" \"temperature_min_09\" #> [34] \"temperature_min_10\" \"temperature_min_11\" \"temperature_min_12\" #> [37] \"temperature_max_01\" \"temperature_max_02\" \"temperature_max_03\" #> [40] \"temperature_max_04\" \"temperature_max_05\" \"temperature_max_06\" #> [43] \"temperature_max_07\" \"temperature_max_08\" \"temperature_max_09\" #> [46] \"temperature_max_10\" \"temperature_max_11\" \"temperature_max_12\" download_dataset(dataset = \"WorldClim_2.1_10m\",                   bio_variables = c(\"bio01\",\"bio02\",\"altitude\")) climate_present <- region_slice(time_ce=1985,                                  bio_variables = c(\"bio01\",\"bio02\",\"altitude\"),                                  dataset=\"WorldClim_2.1_10m\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a3_pastclim_present_and_future.html","id":"future-projections","dir":"Articles","previous_headings":"","what":"Future projections","title":"present and future","text":"Future projections based models CMIP6, downscaled de-biased using WorldClim 2.1 present baseline. Monthly values minimum temperature, maximum temperature, precipitation, well 19 bioclimatic variables processed 23 global climate models (GCMs), four Shared Socio-economic Pathways (SSPs): 126, 245, 370 585. Model SSP can chosen changing ending dataset name WorldClim_2.1_GCM_SSP_RESm. complete list available combinations can obtained : , interested HadGEM3-GC31-LL model, ssp set 245 10 arc-minutes, can get available variables: can now download “bio01” “bio02” dataset : dataset averages 20 year periods (2021-2040, 2041-2060, 2061-2080, 2081-2100). pastclim, midpoints periods (2030, 2050, 2070, 2090) used time stamps. 4 periods automatically downloaded combination GCM model SSP, can selected usual defining time region_slice. Alternatively, possible get full time series 4 slices : possible simply use time_ce(dataset = \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\") get available time points dataset. Help WorldClim datasets (modern future) can accessed help(\"WorldClim_2.1\")","code":"list_available_datasets() #>   [1] \"Example\"                                  #>   [2] \"Beyer2020\"                                #>   [3] \"Krapp2021\"                                #>   [4] \"WorldClim_2.1_10m\"                        #>   [5] \"WorldClim_2.1_5m\"                         #>   [6] \"WorldClim_2.1_ACCESS-CM2_ssp126_10m\"      #>   [7] \"WorldClim_2.1_ACCESS-CM2_ssp126_5m\"       #>   [8] \"WorldClim_2.1_ACCESS-CM2_ssp245_10m\"      #>   [9] \"WorldClim_2.1_ACCESS-CM2_ssp245_5m\"       #>  [10] \"WorldClim_2.1_ACCESS-CM2_ssp370_10m\"      #>  [11] \"WorldClim_2.1_ACCESS-CM2_ssp370_5m\"       #>  [12] \"WorldClim_2.1_ACCESS-CM2_ssp585_10m\"      #>  [13] \"WorldClim_2.1_ACCESS-CM2_ssp585_5m\"       #>  [14] \"WorldClim_2.1_BCC-CSM2-MR_ssp126_10m\"     #>  [15] \"WorldClim_2.1_BCC-CSM2-MR_ssp126_5m\"      #>  [16] \"WorldClim_2.1_BCC-CSM2-MR_ssp245_10m\"     #>  [17] \"WorldClim_2.1_BCC-CSM2-MR_ssp245_5m\"      #>  [18] \"WorldClim_2.1_BCC-CSM2-MR_ssp370_10m\"     #>  [19] \"WorldClim_2.1_BCC-CSM2-MR_ssp370_5m\"      #>  [20] \"WorldClim_2.1_BCC-CSM2-MR_ssp585_10m\"     #>  [21] \"WorldClim_2.1_BCC-CSM2-MR_ssp585_5m\"      #>  [22] \"WorldClim_2.1_CMCC-ESM2_ssp126_10m\"       #>  [23] \"WorldClim_2.1_CMCC-ESM2_ssp126_5m\"        #>  [24] \"WorldClim_2.1_CMCC-ESM2_ssp245_10m\"       #>  [25] \"WorldClim_2.1_CMCC-ESM2_ssp245_5m\"        #>  [26] \"WorldClim_2.1_CMCC-ESM2_ssp370_10m\"       #>  [27] \"WorldClim_2.1_CMCC-ESM2_ssp370_5m\"        #>  [28] \"WorldClim_2.1_CMCC-ESM2_ssp585_10m\"       #>  [29] \"WorldClim_2.1_CMCC-ESM2_ssp585_5m\"        #>  [30] \"WorldClim_2.1_EC-Earth3-Veg_ssp126_10m\"   #>  [31] \"WorldClim_2.1_EC-Earth3-Veg_ssp126_5m\"    #>  [32] \"WorldClim_2.1_EC-Earth3-Veg_ssp245_10m\"   #>  [33] \"WorldClim_2.1_EC-Earth3-Veg_ssp245_5m\"    #>  [34] \"WorldClim_2.1_EC-Earth3-Veg_ssp370_10m\"   #>  [35] \"WorldClim_2.1_EC-Earth3-Veg_ssp370_5m\"    #>  [36] \"WorldClim_2.1_EC-Earth3-Veg_ssp585_10m\"   #>  [37] \"WorldClim_2.1_EC-Earth3-Veg_ssp585_5m\"    #>  [38] \"WorldClim_2.1_FIO-ESM-2-0_ssp126_10m\"     #>  [39] \"WorldClim_2.1_FIO-ESM-2-0_ssp126_5m\"      #>  [40] \"WorldClim_2.1_FIO-ESM-2-0_ssp245_10m\"     #>  [41] \"WorldClim_2.1_FIO-ESM-2-0_ssp245_5m\"      #>  [42] \"WorldClim_2.1_FIO-ESM-2-0_ssp370_10m\"     #>  [43] \"WorldClim_2.1_FIO-ESM-2-0_ssp370_5m\"      #>  [44] \"WorldClim_2.1_FIO-ESM-2-0_ssp585_10m\"     #>  [45] \"WorldClim_2.1_FIO-ESM-2-0_ssp585_5m\"      #>  [46] \"WorldClim_2.1_GFDL-ESM4_ssp126_10m\"       #>  [47] \"WorldClim_2.1_GFDL-ESM4_ssp126_5m\"        #>  [48] \"WorldClim_2.1_GFDL-ESM4_ssp245_10m\"       #>  [49] \"WorldClim_2.1_GFDL-ESM4_ssp245_5m\"        #>  [50] \"WorldClim_2.1_GFDL-ESM4_ssp370_10m\"       #>  [51] \"WorldClim_2.1_GFDL-ESM4_ssp370_5m\"        #>  [52] \"WorldClim_2.1_GFDL-ESM4_ssp585_10m\"       #>  [53] \"WorldClim_2.1_GFDL-ESM4_ssp585_5m\"        #>  [54] \"WorldClim_2.1_GISS-E2-1-G_ssp126_10m\"     #>  [55] \"WorldClim_2.1_GISS-E2-1-G_ssp126_5m\"      #>  [56] \"WorldClim_2.1_GISS-E2-1-G_ssp245_10m\"     #>  [57] \"WorldClim_2.1_GISS-E2-1-G_ssp245_5m\"      #>  [58] \"WorldClim_2.1_GISS-E2-1-G_ssp370_10m\"     #>  [59] \"WorldClim_2.1_GISS-E2-1-G_ssp370_5m\"      #>  [60] \"WorldClim_2.1_GISS-E2-1-G_ssp585_10m\"     #>  [61] \"WorldClim_2.1_GISS-E2-1-G_ssp585_5m\"      #>  [62] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp126_10m\" #>  [63] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp126_5m\"  #>  [64] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\" #>  [65] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_5m\"  #>  [66] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp370_10m\" #>  [67] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp370_5m\"  #>  [68] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp585_10m\" #>  [69] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp585_5m\"  #>  [70] \"WorldClim_2.1_INM-CM5-0_ssp126_10m\"       #>  [71] \"WorldClim_2.1_INM-CM5-0_ssp126_5m\"        #>  [72] \"WorldClim_2.1_INM-CM5-0_ssp245_10m\"       #>  [73] \"WorldClim_2.1_INM-CM5-0_ssp245_5m\"        #>  [74] \"WorldClim_2.1_INM-CM5-0_ssp370_10m\"       #>  [75] \"WorldClim_2.1_INM-CM5-0_ssp370_5m\"        #>  [76] \"WorldClim_2.1_INM-CM5-0_ssp585_10m\"       #>  [77] \"WorldClim_2.1_INM-CM5-0_ssp585_5m\"        #>  [78] \"WorldClim_2.1_IPSL-CM6A-LR_ssp126_10m\"    #>  [79] \"WorldClim_2.1_IPSL-CM6A-LR_ssp126_5m\"     #>  [80] \"WorldClim_2.1_IPSL-CM6A-LR_ssp245_10m\"    #>  [81] \"WorldClim_2.1_IPSL-CM6A-LR_ssp245_5m\"     #>  [82] \"WorldClim_2.1_IPSL-CM6A-LR_ssp370_10m\"    #>  [83] \"WorldClim_2.1_IPSL-CM6A-LR_ssp370_5m\"     #>  [84] \"WorldClim_2.1_IPSL-CM6A-LR_ssp585_10m\"    #>  [85] \"WorldClim_2.1_IPSL-CM6A-LR_ssp585_5m\"     #>  [86] \"WorldClim_2.1_MIROC6_ssp126_10m\"          #>  [87] \"WorldClim_2.1_MIROC6_ssp126_5m\"           #>  [88] \"WorldClim_2.1_MIROC6_ssp245_10m\"          #>  [89] \"WorldClim_2.1_MIROC6_ssp245_5m\"           #>  [90] \"WorldClim_2.1_MIROC6_ssp370_10m\"          #>  [91] \"WorldClim_2.1_MIROC6_ssp370_5m\"           #>  [92] \"WorldClim_2.1_MIROC6_ssp585_10m\"          #>  [93] \"WorldClim_2.1_MIROC6_ssp585_5m\"           #>  [94] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp126_10m\"   #>  [95] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp126_5m\"    #>  [96] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp245_10m\"   #>  [97] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp245_5m\"    #>  [98] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp370_10m\"   #>  [99] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp370_5m\"    #> [100] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp585_10m\"   #> [101] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp585_5m\"    #> [102] \"WorldClim_2.1_MRI-ESM2-0_ssp126_10m\"      #> [103] \"WorldClim_2.1_MRI-ESM2-0_ssp126_5m\"       #> [104] \"WorldClim_2.1_MRI-ESM2-0_ssp245_10m\"      #> [105] \"WorldClim_2.1_MRI-ESM2-0_ssp245_5m\"       #> [106] \"WorldClim_2.1_MRI-ESM2-0_ssp370_10m\"      #> [107] \"WorldClim_2.1_MRI-ESM2-0_ssp370_5m\"       #> [108] \"WorldClim_2.1_MRI-ESM2-0_ssp585_10m\"      #> [109] \"WorldClim_2.1_MRI-ESM2-0_ssp585_5m\"       #> [110] \"WorldClim_2.1_UKESM1-0-LL_ssp126_10m\"     #> [111] \"WorldClim_2.1_UKESM1-0-LL_ssp126_5m\"      #> [112] \"WorldClim_2.1_UKESM1-0-LL_ssp245_10m\"     #> [113] \"WorldClim_2.1_UKESM1-0-LL_ssp245_5m\"      #> [114] \"WorldClim_2.1_UKESM1-0-LL_ssp370_10m\"     #> [115] \"WorldClim_2.1_UKESM1-0-LL_ssp370_5m\"      #> [116] \"WorldClim_2.1_UKESM1-0-LL_ssp585_10m\"     #> [117] \"WorldClim_2.1_UKESM1-0-LL_ssp585_5m\" get_vars_for_dataset(dataset = \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\") #>  [1] \"bio01\" \"bio02\" \"bio03\" \"bio04\" \"bio05\" \"bio06\" \"bio07\" \"bio08\" \"bio09\" #> [10] \"bio10\" \"bio11\" \"bio12\" \"bio13\" \"bio14\" \"bio15\" \"bio16\" \"bio17\" \"bio18\" #> [19] \"bio19\" download_dataset(dataset=\"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\",                  bio_variables = c(\"bio01\",\"bio02\")) future_slice <- region_slice(time_ce = 2030,                               dataset=\"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\",                               bio_variables = c(\"bio01\",\"bio02\")) future_series <- region_series(dataset=\"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\",                               bio_variables = c(\"bio01\",\"bio02\"))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Michela Leonardi. Author. Emily Y. Hallet. Contributor. Robert Beyer. Contributor. Mario Krapp. Contributor. Andrea Manica. Author, maintainer.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Leonardi M, Hallet EY, Beyer R, Krapp M, Manica (2023). “pastclim 1.2: R package easily access use paleoclimatic reconstructions.” Ecography, 2023, e06481. doi:10.1111/ecog.06481.","code":"@Article{pastclim-article,   title = {pastclim 1.2: an R package to easily access and use paleoclimatic reconstructions},   author = {Michela Leonardi and Emily Y. Hallet and Robert Beyer and Mario Krapp and Andrea Manica},   journal = {Ecography},   year = {2023},   volume = {2023},   pages = {e06481},   publisher = {Wiley},   doi = {10.1111/ecog.06481}, }"},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"pastclim-","dir":"","previous_headings":"","what":"Manipulate Time Series of Palaeoclimate Reconstructions ","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"R library designed provide easy way extract manipulate palaeoclimate reconstructions ecological anthropological analyses. functionalities pastclim described Leonardi et al. (2023). Please cite use pastclim research.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"install-the-library","dir":"","previous_headings":"","what":"Install the library","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"pastclim CRAN, easiest way install : version CRAN recommended every day use. New features bug fixes appear first dev branch GitHub, make way CRAN. need early access new features, can install pastclim directly GitHub. install GitHub, need use devtools; haven’t done already, get CRAN install.packages(\"devtools\"). Also, note dev version pastclim tracks changes dev version terra, need upgrade libraries :","code":"install.packages(\"pastclim\") install.packages('terra', repos='https://rspatial.r-universe.dev')  devtools::install_github(\"EvolEcolGroup/pastclim\", ref=\"dev\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"overview-of-functionality","dir":"","previous_headings":"","what":"Overview of functionality","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"dedicated website, can find Articles giving step--step overview package, cheatsheet. also dev version site updated dev branch pastclim (top left dev website, version number red format x.x.x.9xxx, indicating development version). Pastclim currently includes data Beyer et al 2020, reconstruction climate based HadCM3 model last 120k years, Krapp et al 2021, covers last 800k years. reconstructions bias-corrected downscaled 0.5 degree. details datasets can found . also instructions build use custom datasets. can also build vignettes installing pastclim (note need necessary tools build vignettes already installed; requirements depend OS): built vignettes, can read directly R. example, overview can obtained :","code":"devtools::install_github(\"EvolEcolGroup/pastclim\", build_vignette = TRUE) vignette(\"pastclim_overview\", package = \"pastclim\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"current-issues","dir":"","previous_headings":"","what":"Current issues","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"something work, check issues GitHub see whether problem already reported. , feel free create new issue. Please make sure updated latest version pastclim CRAN, well updating packages system, provide reproducible example developers investigate problem.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"error-in-xselffinalize","dir":"","previous_headings":"Current issues","what":"Error in x$.self$finalize()","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"pastclim relies terra process rasters. known bug terra leads occasional message: error related garbage collection, affect script correctly executed, can ignored. discussion issue can found stackoverflow","code":"\"Error in x$.self$finalize() : attempt to apply non-function\""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Beyer2020.html","id":null,"dir":"Reference","previous_headings":"","what":"Documentation for the Beyer2020 dataset — Beyer2020","title":"Documentation for the Beyer2020 dataset — Beyer2020","text":"dataset covers last 120k years, intervals 1/2 k years, resolution 0.5 degrees latitude longitude.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Beyer2020.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Documentation for the Beyer2020 dataset — Beyer2020","text":"use dataset, make sure cite original publication: Beyer, R.M., Krapp, M. & Manica, . High-resolution terrestrial climate, bioclimate vegetation last 120,000 years. Sci Data 7, 236 (2020). doi:doi.org/10.1038/s41597-020-0552-1 version included pastclim ice sheets masked, well internal seas (Black Caspian Sea) removed. latter based : https://www.marineregions.org/gazetteer.php?p=details&id=4278 https://www.marineregions.org/gazetteer.php?p=details&id=4282 reconstruction depth time, modern outlines used time steps. Also, bio15, coefficient variation computed adding one monthly estimates, multiplied 100 following https://pubs.usgs.gov/ds/691/ds691.pdf Changelog v1.1.0 Added monthly variables. Files can downloaded : https://zenodo.org/deposit/7062281 v1.0.0 Remove ice sheets internal seas, use correct formula bio15. Files can downloaded : doi:doi.org/10.6084/m9.figshare.19723405.v1","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Example.html","id":null,"dir":"Reference","previous_headings":"","what":"Documentation for the Example dataset — Example","title":"Documentation for the Example dataset — Example","text":"dataset subset Beyer2020, used vignette pastclim. use dataset real work, might reflect --date version Beyer2020.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Krapp2021.html","id":null,"dir":"Reference","previous_headings":"","what":"Documentation for the Krapp2021 dataset — Krapp2021","title":"Documentation for the Krapp2021 dataset — Krapp2021","text":"dataset covers last 800k years, intervals 1k years, resolution 0.5 degrees latitude longitude.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Krapp2021.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Documentation for the Krapp2021 dataset — Krapp2021","text":"use dataset, make sure cite original publication: Krapp, M., Beyer, R.M., Edmundson, S.L. et al. statistics-based reconstruction high-resolution global terrestrial climate last 800,000 years. Sci Data 8, 228 (2021). doi:doi.org/10.1038/s41597-021-01009-3 version included pastclim ice sheets masked. Note , bio15, use corrected version, follows https://pubs.usgs.gov/ds/691/ds691.pdf Changelog v1.1.0 Added monthly variables. Files can downloaded : https://zenodo.org/record/7065055 v1.0.0 Remove ice sheets use correct formula bio15. Files can downloaded : doi:doi.org/10.6084/m9.figshare.19733680.v1","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/WorldClim_2.1.html","id":null,"dir":"Reference","previous_headings":"","what":"Documentation for the WorldClim datasets — WorldClim_2.1","title":"Documentation for the WorldClim datasets — WorldClim_2.1","text":"WorldClim version 2.1 database high spatial resolution global weather climate data, covering present future projections.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/WorldClim_2.1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Documentation for the WorldClim datasets — WorldClim_2.1","text":"Present-day reconstructions based mean period 1970-2000, available multiple resolutions 10 arc-minutes, 5 arc-minutes, 2.5 arc-minute 0.5 arc-minutes. resolution interest can obtained changing ending dataset name WorldClim_2.1_RESm, e.g. WorldClim_2.1_10m WorldClim_2.1_5m (currently, 10m 5m currently available pastclim). pastclim, datasets given date 1985 CE (mid-point period interest), corresponding time_bp 35. 19 “bioclimatic” variables, well monthly estimates minimum, mean, maximum temperature, precipitation. Future projections based models CMIP6, downscaled de-biased using WorldClim 2.1 present baseline. Monthly values minimum temperature, maximum temperature, precipitation, well 19 bioclimatic variables processed 23 global climate models (GCMs), four Shared Socio-economic Pathways (SSPs): 126, 245, 370 585. Model SSP can chosen changing ending dataset name WorldClim_2.1_GCM_SSP_RESm. Available values GCM : \"ACCESS-CM2\", \"BCC-CSM2-MR\", \"CMCC-ESM2\", \"EC-Earth3-Veg\", \"FIO-ESM-2-0\", \"GFDL-ESM4\", \"GISS-E2-1-G\", \"HadGEM3-GC31-LL\", \"INM-CM5-0\", \"IPSL-CM6A-LR\", \"MIROC6\", \"MPI-ESM1-2-HR\", \"MRI-ESM2-0\", \"UKESM1-0-LL\". SSP, use: \"ssp126\", \"ssp245\",\t\"ssp370\",\t\"ssp585\". RES takes values present reconstructions (.e. \"10m\", \"5m\", \"2.5m\", \"0.5m\"). Example dataset names WorldClim_2.1_ACCESS-CM2_ssp245_10m WorldClim_2.1_MRI-ESM2-0_ssp370_5m dataset averages 20 year periods (2021-2040, 2041-2060, 2061-2080, 2081-2100). pastclim, midpoints periods (2030, 2050, 2070, 2090) used time stamps. 4 periods automatically downloaded combination GCM model SSP, selected usual defining time functions region_slice(). use dataset, make sure cite original publication: Fick, S.E. R.J. Hijmans, 2017. WorldClim 2: new 1km spatial resolution climate surfaces global land areas. International Journal Climatology 37 (12): 4302-4315. doi:doi.org/10.1002/joc.5086","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute the BIOCLIM variables — bioclim_vars","title":"Compute the BIOCLIM variables — bioclim_vars","text":"compute BIOCLIM variables monthly average temperature precipitation data. modern data, variables generally computed using min maximum temperature, many palaeoclimatic reconstructions average temperature available. variables, exception BIO02 BIO03, can rephrased meaningfully terms mean temperature. function modified version predicts::bcvars.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute the BIOCLIM variables — bioclim_vars","text":"","code":"bioclim_vars(prec, tavg, ...)  # S4 method for numeric,numeric bioclim_vars(prec, tavg)  # S4 method for SpatRaster,SpatRaster bioclim_vars(prec, tavg, filename = \"\", ...)  # S4 method for SpatRasterDataset,SpatRasterDataset bioclim_vars(prec, tavg, filename = \"\", ...)  # S4 method for matrix,matrix bioclim_vars(prec, tavg)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute the BIOCLIM variables — bioclim_vars","text":"prec monthly precipitation tavg monthly average temperatures ... additional variables specific methods filename filename raster can stored.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute the BIOCLIM variables — bioclim_vars","text":"bioclim variables","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Compute the BIOCLIM variables — bioclim_vars","text":"variables : BIO01 = Annual Mean Temperature BIO04 = Temperature Seasonality (standard deviation *100) BIO05 = Max Temperature Warmest Month BIO06 = Min Temperature Coldest Month BIO07 = Temperature Annual Range (P5-P6) BIO08 = Mean Temperature Wettest Quarter BIO09 = Mean Temperature Driest Quarter BIO10 = Mean Temperature Warmest Quarter BIO11 = Mean Temperature Coldest Quarter BIO12 = Annual Precipitation BIO13 = Precipitation Wettest Month BIO14 = Precipitation Driest Month BIO15 = Precipitation Seasonality (Coefficient Variation) BIO16 = Precipitation Wettest Quarter BIO17 = Precipitation Driest Quarter BIO18 = Precipitation Warmest Quarter BIO19 = Precipitation Coldest Quarter summary Bioclimatic variables : Nix, 1986. biogeographic analysis Australian elapid snakes. : R. Longmore (ed.). Atlas elapid snakes Australia. Australian Flora Fauna Series 7. Australian Government Publishing Service, Canberra.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if dataset is available. — check_available_dataset","title":"Check if dataset is available. — check_available_dataset","text":"Internal getter function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if dataset is available. — check_available_dataset","text":"","code":"check_available_dataset(dataset, include_custom = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if dataset is available. — check_available_dataset","text":"dataset string defining dataset include_custom boolean whether 'custom' dataset allowed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if dataset is available. — check_available_dataset","text":"TRUE dataset available","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_variable.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if var is available for this dataset. — check_available_variable","title":"Check if var is available for this dataset. — check_available_variable","text":"Internal getter function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_variable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if var is available for this dataset. — check_available_variable","text":"","code":"check_available_variable(variable, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_variable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if var is available for this dataset. — check_available_variable","text":"variable vector names variables interest dataset dataset interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_variable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if var is available for this dataset. — check_available_variable","text":"TRUE var available","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_coords_names.html","id":null,"dir":"Reference","previous_headings":"","what":"Check that we have a valid pair of coordinate names — check_coords_names","title":"Check that we have a valid pair of coordinate names — check_coords_names","text":"internal function checks coords (passed functions) valid set names, , NULL, standard variable names data","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_coords_names.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check that we have a valid pair of coordinate names — check_coords_names","text":"","code":"check_coords_names(data, coords)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_coords_names.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check that we have a valid pair of coordinate names — check_coords_names","text":"data data.frame containing locations. coords vector length two giving names \"x\" \"y\" coordinates, points data.frame use standard names.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_coords_names.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check that we have a valid pair of coordinate names — check_coords_names","text":"vector length 2 valid names, correct order","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_dataset_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Check dataset and path_to_nc params — check_dataset_path","title":"Check dataset and path_to_nc params — check_dataset_path","text":"Check dataset path_to_nc parameters valid. Specifically, path_to_nc set dataset custom (conversely, custom datasets require path_to_nc).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_dataset_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check dataset and path_to_nc params — check_dataset_path","text":"","code":"check_dataset_path(dataset, path_to_nc)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_dataset_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check dataset and path_to_nc params — check_dataset_path","text":"dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\". path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_dataset_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check dataset and path_to_nc params — check_dataset_path","text":"TRUE dataset path valid.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_time_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Check multiple time variables — check_time_vars","title":"Check multiple time variables — check_time_vars","text":"Check one set times","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_time_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check multiple time variables — check_time_vars","text":"","code":"check_time_vars(time_bp, time_ce, allow_null = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_time_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check multiple time variables — check_time_vars","text":"time_bp times bp time_ce times ce allow_null boolean whether can NULL","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_time_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check multiple time variables — check_time_vars","text":"times bp","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_downloaded.html","id":null,"dir":"Reference","previous_headings":"","what":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","title":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","text":"Internal function check whether downloaded given variable dataset","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_downloaded.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","text":"","code":"check_var_downloaded(variable, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_downloaded.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","text":"variable vector names variables interest dataset dataset interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_downloaded.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","text":"TRUE variable downloaded.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_in_nc.html","id":null,"dir":"Reference","previous_headings":"","what":"Check whether variables exist in a netcdf file — check_var_in_nc","title":"Check whether variables exist in a netcdf file — check_var_in_nc","text":"Internal function test custom nc file.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_in_nc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check whether variables exist in a netcdf file — check_var_in_nc","text":"","code":"check_var_in_nc(bio_variables, path_to_nc)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_in_nc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check whether variables exist in a netcdf file — check_var_in_nc","text":"bio_variables vector names variables extracted path_to_nc path custom nc file containing palaeoclimate reconstructions.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_in_nc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check whether variables exist in a netcdf file — check_var_in_nc","text":"TRUE variable exists","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/clean_data_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Clean the data path — clean_data_path","title":"Clean the data path — clean_data_path","text":"function deletes old reconstructions superseded data_path. assumes files data_path part pastclim (.e. custom datasets stored directory).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/clean_data_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Clean the data path — clean_data_path","text":"","code":"clean_data_path(ask = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/clean_data_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Clean the data path — clean_data_path","text":"ask boolean whether user asked deleting","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/clean_data_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Clean the data path — clean_data_path","text":"TRUE files deleted successfully","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_locations.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","title":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","text":"Deprecated version location_slice() Deprecated version location_slice()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_locations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","text":"","code":"climate_for_locations(...)  climate_for_locations(...)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_locations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","text":"... arguments passed location_slice()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_locations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","text":"data.frame climatic variables interest data.frame climatic variables interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_time_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a climate slice for a region — climate_for_time_slice","title":"Extract a climate slice for a region — climate_for_time_slice","text":"Deprecated version region_slice()]","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_time_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a climate slice for a region — climate_for_time_slice","text":"","code":"climate_for_time_slice(...)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_time_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a climate slice for a region — climate_for_time_slice","text":"... arguments passed region_slice()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_time_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a climate slice for a region — climate_for_time_slice","text":"SpatRaster terra::SpatRaster object, variable layer.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/copy_example_data.html","id":null,"dir":"Reference","previous_headings":"","what":"Internal function to copy the example dataset when a new data path is set — copy_example_data","title":"Internal function to copy the example dataset when a new data path is set — copy_example_data","text":"Copy example dataset","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/copy_example_data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Internal function to copy the example dataset when a new data path is set — copy_example_data","text":"","code":"copy_example_data()"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/copy_example_data.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Internal function to copy the example dataset when a new data path is set — copy_example_data","text":"TRUE data copied successfully","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract data frame from a region series — df_from_region_series","title":"Extract data frame from a region series — df_from_region_series","text":"Extract climatic information region series organise data frame.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract data frame from a region series — df_from_region_series","text":"","code":"df_from_region_series(x, xy = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract data frame from a region series — df_from_region_series","text":"x climate time series generated region_series() xy boolean whether x y coordinates added dataframe (default TRUE)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract data frame from a region series — df_from_region_series","text":"data.frame cell raster layer (.e. timestep) row, available variables columns.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Extract data frame from a region series — df_from_region_series","text":"extract data frame region slice, see df_from_region_slice().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract data frame from a region slice — df_from_region_slice","title":"Extract data frame from a region slice — df_from_region_slice","text":"Extract climatic information region slice organise data frame. just wrapper around terra::.data.frame().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract data frame from a region slice — df_from_region_slice","text":"","code":"df_from_region_slice(x, xy = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract data frame from a region slice — df_from_region_slice","text":"x climate time slice (.e. terra::SpatRaster) generated region_slice() xy boolean whether x y coordinates added dataframe (default TRUE)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract data frame from a region slice — df_from_region_slice","text":"data.frame cell raster row, available variables columns.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Extract data frame from a region slice — df_from_region_slice","text":"extract data frame region series, see df_from_region_series().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/distance_from_sea.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","title":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","text":"Get land mask dataset given time point, compute distance sea land pixel.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/distance_from_sea.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","text":"","code":"distance_from_sea(time_bp = NULL, time_ce = NULL, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/distance_from_sea.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","text":"time_bp time slice years present (negative) time_ce time slice years CE. one time_bp time_ce used. dataset string defining dataset use (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/distance_from_sea.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","text":"terra::SpatRaster distances coastline km","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":null,"dir":"Reference","previous_headings":"","what":"Coefficient of variables (expressed as percentage) — .cv","title":"Coefficient of variables (expressed as percentage) — .cv","text":"R function compute coefficient variation (expressed percentage). single value, stats::sd = NA. However, one argue cv =0; NA may break code receives . function returns 0 mean close zero.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coefficient of variables (expressed as percentage) — .cv","text":"","code":".cv(x)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coefficient of variables (expressed as percentage) — .cv","text":"x vector values","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coefficient of variables (expressed as percentage) — .cv","text":"cv","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coefficient of variables (expressed as percentage) — .cv","text":"ODD: abs avoid small (zero) mean e.g. -5:5","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":null,"dir":"Reference","previous_headings":"","what":"Download the CHELSA modern observations. — download_chelsa","title":"Download the CHELSA modern observations. — download_chelsa","text":"function downloads monthly variables CHELSA 2.1 dataset. variables saved format can read load_chelsa, easily used delta downscaling palaeoclimate observations.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download the CHELSA modern observations. — download_chelsa","text":"","code":"download_chelsa(var, res, path = NULL, version = \"2.1\", ...)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download the CHELSA modern observations. — download_chelsa","text":"var character Valid variables names \"tas\", \"tasmax\",\"tasmin\", \"prec\". path character. Path download data . left NULL, data downloaded directory returned get_data_path().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download the CHELSA modern observations. — download_chelsa","text":"TRUE requested CHELSA variable downloaded successfully.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download the CHELSA modern observations. — download_chelsa","text":"Note variables named differently WorldClim. \"tas\" mean temperature (\"tavg\" WorldClim), \"tasmax\" \"tasmin\" equivalent \"tmax\" \"tmin\".","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Download palaeoclimate reconstructions. — download_dataset","title":"Download palaeoclimate reconstructions. — download_dataset","text":"function downloads palaeoclimate reconstructions. Files stored data path pastclim, can inspected get_data_path() changed set_data_path()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download palaeoclimate reconstructions. — download_dataset","text":"","code":"download_dataset(dataset, bio_variables = NULL, annual = TRUE, monthly = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download palaeoclimate reconstructions. — download_dataset","text":"dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets. bio_variables one variable names downloaded. left NULL, variables available dataset downloaded (parameters annual monthly, see , define types) annual boolean download annual variables monthly boolean download monthly variables","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download palaeoclimate reconstructions. — download_dataset","text":"TRUE dataset(s) downloaded correctly.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_etopo.html","id":null,"dir":"Reference","previous_headings":"","what":"Download the ETOPO Global relief model — download_etopo","title":"Download the ETOPO Global relief model — download_etopo","text":"function downloads ETOPO2022 global relief model 30 60 arcsecs resolution. large file (>1Gb), worth downloading planning use repeatedly.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_etopo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download the ETOPO Global relief model — download_etopo","text":"","code":"download_etopo(path = NULL, resolution = 60)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_etopo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download the ETOPO Global relief model — download_etopo","text":"path character. Path download data . left NULL, data downloaded directory returned get_data_path(), automatically named \"etopo2022_resolutions_v1.nc\" resolution numeric resolution arcsecs (one 30, 60). Defaults 60 arcsecs.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_etopo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download the ETOPO Global relief model — download_etopo","text":"dataframe produced curl::multi_download() information download (including error codes)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_future.html","id":null,"dir":"Reference","previous_headings":"","what":"Download a WorldClim future predictions. — download_worldclim_future","title":"Download a WorldClim future predictions. — download_worldclim_future","text":"function downloads annual monthly variables WorldClim 2.1 predictions future.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_future.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download a WorldClim future predictions. — download_worldclim_future","text":"","code":"download_worldclim_future(dataset, bio_var, filename)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_future.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download a WorldClim future predictions. — download_worldclim_future","text":"dataset name dataset bio_var variable name filename file name (full path) file saved","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_future.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download a WorldClim future predictions. — download_worldclim_future","text":"TRUE requested WorldClim variable downloaded successfully","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_present.html","id":null,"dir":"Reference","previous_headings":"","what":"Download a WorldClim modern observations. — download_worldclim_present","title":"Download a WorldClim modern observations. — download_worldclim_present","text":"function downloads annual monthly variables WorldClim 2.1 dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_present.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download a WorldClim modern observations. — download_worldclim_present","text":"","code":"download_worldclim_present(dataset, bio_var, filename)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_present.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download a WorldClim modern observations. — download_worldclim_present","text":"dataset name dataset bio_var variable name filename file name (full path) file saved","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_present.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download a WorldClim modern observations. — download_worldclim_present","text":"TRUE requested WorldClim variable downloaded successfully","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_available_datasets.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the available datasets. — get_available_datasets","title":"Get the available datasets. — get_available_datasets","text":"List datasets available pastclim, can passed functions pastclim values parameter dataset. functions can also used custom datasets setting dataset=\"custom\"","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_available_datasets.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the available datasets. — get_available_datasets","text":"","code":"get_available_datasets()"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_available_datasets.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the available datasets. — get_available_datasets","text":"character vector available datasets","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_available_datasets.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get the available datasets. — get_available_datasets","text":"function provides user-friendly list, summarising many datasets available WorldClim. comprehensive list available datasets can obtained list_available_datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_biome_classes.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the biome classes for a dataset. — get_biome_classes","title":"Get the biome classes for a dataset. — get_biome_classes","text":"Get full list biomes id coded biome variable given dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_biome_classes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the biome classes for a dataset. — get_biome_classes","text":"","code":"get_biome_classes(dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_biome_classes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the biome classes for a dataset. — get_biome_classes","text":"dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_biome_classes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the biome classes for a dataset. — get_biome_classes","text":"data.frame columns id category.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the data path where climate reconstructions are stored — get_data_path","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"function returns path climate reconstructions stored.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"","code":"get_data_path(silent = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"silent boolean whether message returned data_path set (.e. equal NULL)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"data path","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"path stored option pastclim named data_path. configuration file saved using set_data_path(), path retrieved file named \"pastclim_data.txt\", found directory returned tools::R_user_dir(\"pastclim\",\"config\") (.e. default configuration directory package set R >= 4.0).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_dataset_info.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the information about a dataset — get_dataset_info","title":"Get the information about a dataset — get_dataset_info","text":"function provides full information given dataset. full list datasets available pastclim can obtained list_available_datasets()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_dataset_info.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the information about a dataset — get_dataset_info","text":"","code":"get_dataset_info(dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_dataset_info.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the information about a dataset — get_dataset_info","text":"dataset dataset pastclim","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_dataset_info.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the information about a dataset — get_dataset_info","text":"text describing dataset","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_downloaded_datasets.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the variables downloaded for each dataset. — get_downloaded_datasets","title":"Get the variables downloaded for each dataset. — get_downloaded_datasets","text":"List downloaded variable dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_downloaded_datasets.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the variables downloaded for each dataset. — get_downloaded_datasets","text":"","code":"get_downloaded_datasets(data_path = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_downloaded_datasets.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the variables downloaded for each dataset. — get_downloaded_datasets","text":"data_path leave NULL use default data_path","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_downloaded_datasets.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the variables downloaded for each dataset. — get_downloaded_datasets","text":"list variable names per dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_file_for_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the file details for a variable and dataset. — get_file_for_dataset","title":"Get the file details for a variable and dataset. — get_file_for_dataset","text":"Internal getter function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_file_for_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the file details for a variable and dataset. — get_file_for_dataset","text":"","code":"get_file_for_dataset(variable, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_file_for_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the file details for a variable and dataset. — get_file_for_dataset","text":"variable one variable names downloaded dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_file_for_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the file details for a variable and dataset. — get_file_for_dataset","text":"filename variable dataset","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_ice_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the ice mask for a dataset. — get_ice_mask","title":"Get the ice mask for a dataset. — get_ice_mask","text":"Get ice mask dataset, either whole series specific time points.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_ice_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the ice mask for a dataset. — get_ice_mask","text":"","code":"get_ice_mask(time_bp = NULL, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_ice_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the ice mask for a dataset. — get_ice_mask","text":"time_bp time slices years present (negative values represent time present, positive values time future). parameter can vector times (slices need exist dataset), list min max element setting range values, left NULL retrieve time steps. check slices available, can use get_time_bp_steps(). dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_ice_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the ice mask for a dataset. — get_ice_mask","text":"binary terra::SpatRaster ice mask 1s","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_land_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the land mask for a dataset. — get_land_mask","title":"Get the land mask for a dataset. — get_land_mask","text":"Get land mask dataset, either whole series specific time points.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_land_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the land mask for a dataset. — get_land_mask","text":"","code":"get_land_mask(time_bp = NULL, time_ce = NULL, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_land_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the land mask for a dataset. — get_land_mask","text":"time_bp time slices years present (negative values represent time present, positive values time future). parameter can vector times (slices need exist dataset), list min max element setting range values, left NULL retrieve time steps. check slices available, can use get_time_bp_steps(). time_ce time years CE alternative time_bp.one time_bp time_ce used. available time slices years CE, use get_time_ce_steps(). dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_land_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the land mask for a dataset. — get_land_mask","text":"binary terra::SpatRaster land mask 1s","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_mis_time_steps.html","id":null,"dir":"Reference","previous_headings":"","what":"Get time steps for a given MIS — get_mis_time_steps","title":"Get time steps for a given MIS — get_mis_time_steps","text":"Get time steps available given dataset MIS.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_mis_time_steps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get time steps for a given MIS — get_mis_time_steps","text":"","code":"get_mis_time_steps(mis, dataset, path_to_nc = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_mis_time_steps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get time steps for a given MIS — get_mis_time_steps","text":"mis string giving mis; must use spelling used mis_boundaries dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_mis_time_steps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get time steps for a given MIS — get_mis_time_steps","text":"vector time steps","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_sea_level.html","id":null,"dir":"Reference","previous_headings":"","what":"Get sea level estimate — get_sea_level","title":"Get sea level estimate — get_sea_level","text":"function returns estimated sea level Spratt et al. 2016, using long PC1. Sea levels contemporary sea level (note original data reference sea level Holocene ~5k year ago).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_sea_level.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get sea level estimate — get_sea_level","text":"","code":"get_sea_level(time_bp)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_sea_level.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get sea level estimate — get_sea_level","text":"time_bp time interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_sea_level.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get sea level estimate — get_sea_level","text":"vector sea levels meters present level","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_time_bp_steps.html","id":null,"dir":"Reference","previous_headings":"","what":"Get time steps for a given dataset — get_time_bp_steps","title":"Get time steps for a given dataset — get_time_bp_steps","text":"Get time steps (time_bp time_ce) available given dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_time_bp_steps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get time steps for a given dataset — get_time_bp_steps","text":"","code":"get_time_bp_steps(dataset, path_to_nc = NULL)  get_time_ce_steps(dataset, path_to_nc = NULL)  get_time_steps(dataset, path_to_nc = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_time_bp_steps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get time steps for a given dataset — get_time_bp_steps","text":"dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_time_bp_steps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get time steps for a given dataset — get_time_bp_steps","text":"vector time steps (time_bp, time_ce)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_varname.html","id":null,"dir":"Reference","previous_headings":"","what":"Get a the varname for this variable — get_varname","title":"Get a the varname for this variable — get_varname","text":"Internal function get varname variable","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_varname.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get a the varname for this variable — get_varname","text":"","code":"get_varname(variable, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_varname.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get a the varname for this variable — get_varname","text":"variable string defining variable name dataset string defining dataset downloaded","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_varname.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get a the varname for this variable — get_varname","text":"name variable","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_vars_for_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Get a list of variables for a given dataset. — get_vars_for_dataset","title":"Get a list of variables for a given dataset. — get_vars_for_dataset","text":"function lists variables available given dataset. Note spelling use capitals names might differ original publications, pastclim harmonises names variables across different reconstructions.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_vars_for_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get a list of variables for a given dataset. — get_vars_for_dataset","text":"","code":"get_vars_for_dataset(   dataset,   path_to_nc = NULL,   details = FALSE,   annual = TRUE,   monthly = FALSE )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_vars_for_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get a list of variables for a given dataset. — get_vars_for_dataset","text":"dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). path_to_nc path custom nc file containing palaeoclimate reconstructions. custom nc file given, 'details', 'annual' 'monthly' ignored details boolean determining whether output include information including long names variables units. annual boolean show annual variables monthly boolean show monthly variables","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_vars_for_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get a list of variables for a given dataset. — get_vars_for_dataset","text":"vector variable names","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/help_console.html","id":null,"dir":"Reference","previous_headings":"","what":"Print help to console — help_console","title":"Print help to console — help_console","text":"function prints help file console. based function published R-bloggers: https://www.r-bloggers.com/2013/06/printing-r-help-files---console---knitr-documents/","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/help_console.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Print help to console — help_console","text":"","code":"help_console(   topic,   format = c(\"text\", \"html\", \"latex\"),   lines = NULL,   before = NULL,   after = NULL )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/help_console.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Print help to console — help_console","text":"topic topic help format output formatted string printed output string printed output lines printed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/help_console.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Print help to console — help_console","text":"text help file","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Check the object is a valid region series — is_region_series","title":"Check the object is a valid region series — is_region_series","text":"region series terra::SpatRasterDataset sub-dataset variable, variables number time steps.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check the object is a valid region series — is_region_series","text":"","code":"is_region_series(x, strict = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check the object is a valid region series — is_region_series","text":"x terra::SpatRasterDataset representing time series regional reconstructions obtained region_series(). strict boolean defining whether preform thorough test (see description details).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check the object is a valid region series — is_region_series","text":"TRUE object region series","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Check the object is a valid region series — is_region_series","text":"standard test checks sub-datasets (terra::SpatRaster) number layers. thorough test (obtained strict=TRUE) actually checks variables identical time steps comparing result terra::time() applied variable.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/list_available_datasets.html","id":null,"dir":"Reference","previous_headings":"","what":"List all the available datasets. — list_available_datasets","title":"List all the available datasets. — list_available_datasets","text":"List datasets available pastclim. list comprehensive, includes combinations models future scenarios WorldClim. user-friendly list, use get_available_datasets(). functions can also used custom datasets setting dataset=\"custom\"","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/list_available_datasets.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"List all the available datasets. — list_available_datasets","text":"","code":"list_available_datasets()"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/list_available_datasets.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"List all the available datasets. — list_available_datasets","text":"character vector available datasets","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_dataset_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Load the dataset list — load_dataset_list","title":"Load the dataset list — load_dataset_list","text":"function returns dataframe details variable available every dataset. defaults copy stored within package, checks case updated version stored 'dataset_list_included.csv' tools::R_user_dir(\"pastclim\",\"config\"). latter present, last column, named 'dataset_list_v', provides version table, advanced table used.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_dataset_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load the dataset list — load_dataset_list","text":"","code":"load_dataset_list(on_cran = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_dataset_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load the dataset list — load_dataset_list","text":"on_cran boolean make function run ci tests using tempdir","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_dataset_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Load the dataset list — load_dataset_list","text":"dataset list","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":null,"dir":"Reference","previous_headings":"","what":"Load the ETOPO global relief — load_etopo","title":"Load the ETOPO global relief — load_etopo","text":"function loads previously downloaded ETOPO 2022 global relief dataset, 30 60 arcsec resolution. save variables compatible format, use download_etopo().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load the ETOPO global relief — load_etopo","text":"","code":"load_etopo(path = NULL, resolution = 60, version = \"1\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load the ETOPO global relief — load_etopo","text":"path character. Path dataset stored. left NULL, data downloaded directory returned get_data_path() resolution numeric resolution arcsecs (one 30, 60). Defaults 60 arcsecs. version character numeric. ETOPO2022 version number. \"1\" supported moment","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Load the ETOPO global relief — load_etopo","text":"terra::SpatRaster relief","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Load the ETOPO global relief — load_etopo","text":"function assumes file name etopo2022_resolutions_v1.nc","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a time series of bioclimatic variables for one or more locations. — location_series","title":"Extract a time series of bioclimatic variables for one or more locations. — location_series","text":"function extract time series local climate set locations. Note function apply interpolation (opposed location_slice()). coastal location just falls water reconstructions, amend coordinates put firmly land.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a time series of bioclimatic variables for one or more locations. — location_series","text":"","code":"location_series(   x,   time_bp = NULL,   time_ce = NULL,   coords = NULL,   bio_variables,   dataset,   path_to_nc = NULL,   nn_interpol = FALSE,   buffer = FALSE,   directions = 8 )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a time series of bioclimatic variables for one or more locations. — location_series","text":"x data.frame columns x y coordinates (optional name column), vector cell numbers. See coords standard coordinate names, use custom ones. time_bp time slices years present (negative values represent time present, positive values time future). parameter can vector times (slices need exist dataset), list min max element setting range values, left NULL retrieve time steps. check slices available, can use get_time_bp_steps(). time_ce time slice years CE (see time_bp options). available time slices years CE, use get_time_ce_steps(). one time_bp time_ce used. coords vector length two giving names \"x\" \"y\" coordinates, found data. left NULL, function try guess columns based standard names c(\"x\", \"y\"), c(\"X\",\"Y\"), c(\"longitude\", \"latitude\"), c(\"lon\", \"lat\") bio_variables vector names variables extracted. dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file. nn_interpol boolean determining whether nearest neighbour interpolation used estimate climate cells lack information (.e. water ice). default, interpolation performed first ring nearest neighbours; climate available, NA returned location. number neighbours can changed argument directions. nn_interpol defaults FALSE (DIFFERENT location_slice(). buffer boolean determining whether variable returned mean buffer around focal cell. set TRUE, overrides nn_interpol (provides estimates buffer locations cells NA). buffer size determined argument directions. buffer defaults FALSE. directions character matrix indicate directions cells considered connected using nn_interpol buffer. following character values allowed: \"rook\" \"4\" horizontal vertical neighbours; \"bishop\" get diagonal neighbours; \"queen\" \"8\" get vertical, horizontal diagonal neighbours; \"16\" knight one-cell queen move neighbours. directions matrix odd dimensions logical (0, 1) values.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a time series of bioclimatic variables for one or more locations. — location_series","text":"data.frame climatic variables interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract local climate for one or more locations for a given time slice. — location_slice","title":"Extract local climate for one or more locations for a given time slice. — location_slice","text":"function extract local climate set locations appropriate times (selecting closest time slice available specific date associated location).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract local climate for one or more locations for a given time slice. — location_slice","text":"","code":"location_slice(   x,   time_bp = NULL,   time_ce = NULL,   coords = NULL,   bio_variables,   dataset,   path_to_nc = NULL,   nn_interpol = TRUE,   buffer = FALSE,   directions = 8 )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract local climate for one or more locations for a given time slice. — location_slice","text":"x data.frame columns x y coordinates(see coords standard coordinate names, use custom ones), plus optional columns time_bp time_ce (depending units used) name. Alternatively, vector cell numbers. time_bp used time_bp column present x: dates years present (negative values represent time present, .e. 1950, positive values time future) location. time_ce time years CE alternative time_bp.one time_bp time_ce used. coords vector length two giving names \"x\" \"y\" coordinates, found data. left NULL, function try guess columns based standard names c(\"x\", \"y\"), c(\"X\",\"Y\"), c(\"longitude\", \"latitude\"), c(\"lon\", \"lat\") bio_variables vector names variables extracted. dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file. nn_interpol boolean determining whether nearest neighbour interpolation used estimate climate cells lack information (.e. water ice). default, interpolation performed first ring nearest neighbours; climate available, NA returned location. number neighbours can changed argument directions. nn_interpol defaults TRUE. buffer boolean determining whether variable returned mean buffer around focal cell. set TRUE, overrides nn_interpol (provides estimates buffer locations cells NA). buffer size determined argument directions. buffer defaults FALSE. directions character matrix indicate directions cells considered connected using nn_interpol buffer. following character values allowed: \"rook\" \"4\" horizontal vertical neighbours; \"bishop\" get diagonal neighbours; \"queen\" \"8\" get vertical, horizontal diagonal neighbours; \"16\" knight one-cell queen move neighbours. directions matrix odd dimensions logical (0, 1) values.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract local climate for one or more locations for a given time slice. — location_slice","text":"data.frame climatic variables interest.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice_from_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","title":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","text":"function extract local climate set locations appropriate times (selecting closest time slice available specific date associated location).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice_from_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","text":"","code":"location_slice_from_region_series(   x,   time_bp = NULL,   time_ce = NULL,   coords = NULL,   region_series,   nn_interpol = TRUE,   buffer = FALSE,   directions = 8 )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice_from_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","text":"x data.frame columns x y coordinates(see coords standard coordinate names, use custom ones), plus optional columns time_bp time_ce (depending units used) name. Alternatively, vector cell numbers. time_bp used time_bp column present x: dates years present (negative values represent time present, .e. 1950, positive values time future) location. time_ce time years CE alternative time_bp.one time_bp time_ce used. coords vector length two giving names \"x\" \"y\" coordinates, found data. left NULL, function try guess columns based standard names c(\"x\", \"y\"), c(\"X\",\"Y\"), c(\"longitude\", \"latitude\"), c(\"lon\", \"lat\") region_series SpatRasterDataset obtained region_series() nn_interpol boolean determining whether nearest neighbour interpolation used estimate climate cells lack information (.e. water ice). default, interpolation performed first ring nearest neighbours; climate available, NA returned location. number neighbours can changed argument directions. nn_interpol defaults TRUE. buffer boolean determining whether variable returned mean buffer around focal cell. set TRUE, overrides nn_interpol (provides estimates buffer locations cells NA). buffer size determined argument directions. buffer defaults FALSE. directions character matrix indicate directions cells considered connected using nn_interpol buffer. following character values allowed: \"rook\" \"4\" horizontal vertical neighbours; \"bishop\" get diagonal neighbours; \"queen\" \"8\" get vertical, horizontal diagonal neighbours; \"16\" knight one-cell queen move neighbours. directions matrix odd dimensions logical (0, 1) values.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice_from_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","text":"data.frame climatic variables interest.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_binary_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a binary mask — make_binary_mask","title":"Create a binary mask — make_binary_mask","text":"Create binary mask raster: NAs converted 0s, value 1.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_binary_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a binary mask — make_binary_mask","text":"","code":"make_binary_mask(x)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_binary_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a binary mask — make_binary_mask","text":"x terra::SpatRaster","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_binary_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a binary mask — make_binary_mask","text":"terra::SpatRaster 0s 1s","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_ice_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Downscale an ice mask — make_ice_mask","title":"Downscale an ice mask — make_ice_mask","text":"Downscaling ice mask presents issues. mask binary raster, standard downscaling approach still look blocky. can smooth contour applying Gaussian filter. strong filter much matter personal opinion, data compare . function attempts use sensible default value, worth exploring alternative values find good solution.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_ice_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Downscale an ice mask — make_ice_mask","text":"","code":"make_ice_mask(ice_mask_low_res, land_mask_high_res, d = c(0.5, 3))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_ice_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Downscale an ice mask — make_ice_mask","text":"ice_mask_low_res terra::SpatRaster low resolution ice mask downscale (e.g. obtained get_ice_mask()) land_mask_high_res terra::SpatRaster land masks different times (e.g. obtained make_land_mask()). ice mask cropped matched resolution land mask.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_ice_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Downscale an ice mask — make_ice_mask","text":"terra::SpatRaster ice mask (1's), rest world (sea land) NA's","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_land_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a land mask — make_land_mask","title":"Create a land mask — make_land_mask","text":"Create land mask given time step. land mask based simple logic moving ocean given current relief profile ( topography+bathymetry, .e. elevation sea level). Note approach ignores rebound due changing mass distribution ice sheets. LIMITATIONS: land mask show internal lakes/seas land, level unrelated general sea level. specific reconstructions internal lakes (want simply reuse current extents), add onto masks generated function. Also note land mask include ice sheets. means areas permanently covered ice two poles show sea. means , reconstruction including Greenland Antarctica, resulting land mask need modified include appropriate ice sheets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_land_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a land mask — make_land_mask","text":"","code":"make_land_mask(relief_rast, time_bp, sea_level = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_land_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a land mask — make_land_mask","text":"relief_rast terra::SpatRaster relief time_bp time interest sea_level sea level time interest (left NULL, computed using Spratt 2016)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_land_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a land mask — make_land_mask","text":"terra::SpatRaster land masks (land 1's sea NAs), layers different times","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mis_boundaries.html","id":null,"dir":"Reference","previous_headings":"","what":"Time boundaries of marine isotope stages (MIS). — mis_boundaries","title":"Time boundaries of marine isotope stages (MIS). — mis_boundaries","text":"dataset containing beginning end MIS.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mis_boundaries.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Time boundaries of marine isotope stages (MIS). — mis_boundaries","text":"","code":"mis_boundaries"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mis_boundaries.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Time boundaries of marine isotope stages (MIS). — mis_boundaries","text":"data frame 24 rows 2 variables: mis stage, string start start given MIS, kya end start given MIS, kya","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mode.html","id":null,"dir":"Reference","previous_headings":"","what":"Mode — mode","title":"Mode — mode","text":"Find mode vector x (note , multiple values frequency, function simply picks first occurring one)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mode.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Mode — mode","text":"","code":"mode(x)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mode.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Mode — mode","text":"x vector","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mode.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Mode — mode","text":"mode","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/pastclim.html","id":null,"dir":"Reference","previous_headings":"","what":"pastclim — pastclim","title":"pastclim — pastclim","text":"R library designed provide easy way extract manipulate palaeoclimate reconstructions ecological anthropological analyses.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/pastclim.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"pastclim — pastclim","text":"functionalities pastclim described Leonardi et al. (2023) doi:10.1111/ecog.06481 . Please cite use pastclim research. dedicated website, can find Articles giving step--step overview package, cheatsheet. also version site updated dev version (top left, version number red, format x.x.x.9xxx, indicating development version). pastclim currently includes data Beyer et al 2020, reconstruction climate based HadCM3 model last 120k years, Krapp et al 2021, covers last 800k years. reconstructions bias-corrected downscaled 0.5 degree. details datasets can found . also instructions build use custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_extent.html","id":null,"dir":"Reference","previous_headings":"","what":"Region extents. — region_extent","title":"Region extents. — region_extent","text":"list extents major regions.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_extent.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Region extents. — region_extent","text":"","code":"region_extent"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_extent.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Region extents. — region_extent","text":"list vectors giving extents.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline.html","id":null,"dir":"Reference","previous_headings":"","what":"Region outlines. — region_outline","title":"Region outlines. — region_outline","text":"sf::sf object containing outlines major regions. Outlines span antimeridian split multiple polygons.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Region outlines. — region_outline","text":"","code":"region_outline"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Region outlines. — region_outline","text":"sf::sf outlines. name names regions","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline_union.html","id":null,"dir":"Reference","previous_headings":"","what":"Region outlines unioned. — region_outline_union","title":"Region outlines unioned. — region_outline_union","text":"sf::sf object containing outlines major regions. outline represented single polygon. want multiple polygons, use region_outline.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline_union.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Region outlines unioned. — region_outline_union","text":"","code":"region_outline_union"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline_union.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Region outlines unioned. — region_outline_union","text":"sf::sf outlines. name names regions","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a time series of climate variables for a region — region_series","title":"Extract a time series of climate variables for a region — region_series","text":"function extracts time series one climate variables given dataset covering region (whole world). function returns terra::SpatRasterDataset object, variable sub-dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a time series of climate variables for a region — region_series","text":"","code":"region_series(   time_bp = NULL,   time_ce = NULL,   bio_variables,   dataset,   path_to_nc = NULL,   ext = NULL,   crop = NULL )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a time series of climate variables for a region — region_series","text":"time_bp time slices years present (negative values represent time present, positive values time future). parameter can vector times (slices need exist dataset), list min max element setting range values, left NULL retrieve time steps. check slices available, can use get_time_bp_steps(). time_ce time slices years CE (see time_bp options). available time slices years CE, use get_time_ce_steps(). one time_bp time_ce used. bio_variables vector names variables extracted dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file. ext extent, coded numeric vector (length=4; order= xmin, xmax, ymin, ymax) terra::SpatExtent object. NULL, full extent reconstruction given. crop polygon used crop reconstructions (e.g. outline continental mass). sf::sfg terra::SpatVector object used define polygon.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a time series of climate variables for a region — region_series","text":"terra::SpatRasterDataset object, variable sub-dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a climate slice for a region — region_slice","title":"Extract a climate slice for a region — region_slice","text":"function extracts slice one climate variables given dataset covering region (whole world). function returns SpatRaster terra::SpatRaster object, variable layer.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a climate slice for a region — region_slice","text":"","code":"region_slice(   time_bp = NULL,   time_ce = NULL,   bio_variables,   dataset,   path_to_nc = NULL,   ext = NULL,   crop = NULL )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a climate slice for a region — region_slice","text":"time_bp time slice years present (negative values represent time present, positive values time future). slice needs exist dataset. check slices available, can use get_time_bp_steps(). time_ce time slice years CE. available time slices years CE, use get_time_ce_steps(). one time_bp time_ce used. bio_variables vector names variables extracted dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file. ext extent, coded numeric vector (length=4; order= xmin, xmax, ymin, ymax) terra::SpatExtent object. NULL, full extent reconstruction given. crop polygon used crop reconstructions (e.g. outline continental mass). sf::sfg terra::SpatVector object used define polygon.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a climate slice for a region — region_slice","text":"SpatRaster terra::SpatRaster object, variable layer.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample points from a region time series — sample_region_series","title":"Sample points from a region time series — sample_region_series","text":"function samples points region time series. Sampling can either performed locations time steps (one value given size), different locations time step (size vector length equal number time steps). sample number points, different locations, time step, provide vector repeating value time step.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample points from a region time series — sample_region_series","text":"","code":"sample_region_series(x, size, method = \"random\", replace = FALSE, na.rm = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sample points from a region time series — sample_region_series","text":"x terra::SpatRasterDataset returned region_series() size number points sampled. single value used sample locations across time steps, vector values sample different locations time step. method one sampling methods terra::spatSample(). defaults \"random\" replace boolean determining whether sample replacement na.rm boolean determining whether NAs removed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sample points from a region time series — sample_region_series","text":"data.frame sampled cells respective values climate variables.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Sample points from a region time series — sample_region_series","text":"function wraps terra::spatSample() appropriate sample terra::SpatRasters terra::SpatRasterDataset returned region_series().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample points from a region time slice — sample_region_slice","title":"Sample points from a region time slice — sample_region_slice","text":"function samples points region time slice (.e. time point).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample points from a region time slice — sample_region_slice","text":"","code":"sample_region_slice(x, size, method = \"random\", replace = FALSE, na.rm = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sample points from a region time slice — sample_region_slice","text":"x terra::SpatRaster returned region_slice() size number points sampled. method one sampling methods terra::spatSample(). defaults \"random\" replace boolean determining whether sample replacement na.rm boolean determining whether NAs removed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sample points from a region time slice — sample_region_slice","text":"data.frame sampled cells respective values climate variables.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Sample points from a region time slice — sample_region_slice","text":"function wraps terra::spatSample() appropriate sample terra::SpatRaster returned region_slice(). can also use terra::spatSample() directly slice (standard terra::SpatRaster).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_fixed.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample the same locations from a region time series — sample_rs_fixed","title":"Sample the same locations from a region time series — sample_rs_fixed","text":"Internal function fixed sampling sample_region_series(), used single size given.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_fixed.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample the same locations from a region time series — sample_rs_fixed","text":"","code":"sample_rs_fixed(x, size, method = \"random\", replace = FALSE, na.rm = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_fixed.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sample the same locations from a region time series — sample_rs_fixed","text":"x terra::SpatRasterDataset returned region_series() size number points sampled; locations across time steps method one sampling methods terra::spatSample(). defaults \"random\" replace boolean determining whether sample replacement na.rm boolean determining whether NAs removed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_fixed.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sample the same locations from a region time series — sample_rs_fixed","text":"data.frame sampled cells respective values climate variables.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_variable.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample the different number of points from a region time series — sample_rs_variable","title":"Sample the different number of points from a region time series — sample_rs_variable","text":"Internal function sampling different number points timestep region series sample_region_series(), used size vector values.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_variable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample the different number of points from a region time series — sample_rs_variable","text":"","code":"sample_rs_variable(x, size, method = \"random\", replace = FALSE, na.rm = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_variable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sample the different number of points from a region time series — sample_rs_variable","text":"x terra::SpatRasterDataset returned region_series() size vector number points sampled time step method one sampling methods terra::spatSample(). defaults \"random\" replace boolean determining whether sample replacement na.rm boolean determining whether NAs removed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_variable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sample the different number of points from a region time series — sample_rs_variable","text":"data.frame sampled cells respective values climate variables.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/set_data_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Set the data path where climate reconstructions will be stored — set_data_path","title":"Set the data path where climate reconstructions will be stored — set_data_path","text":"function sets path climate reconstructions stored. information stored file names \"pastclim_data.txt\", found directory returned tools::R_user_dir(\"pastclim\",\"config\") (.e. default configuration directory package set R >= 4.0).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/set_data_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set the data path where climate reconstructions will be stored — set_data_path","text":"","code":"set_data_path(   path_to_nc = NULL,   ask = TRUE,   write_config = TRUE,   copy_example = TRUE,   on_CRAN = FALSE )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/set_data_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set the data path where climate reconstructions will be stored — set_data_path","text":"path_to_nc path file contains downloaded reconstructions. left unset, default location returned tools::R_user_dir(\"pastclim\",\"data\") used ask boolean whether user asked confirm choices write_config boolean whether path saved config file copy_example boolean whether example dataset saved data_path on_CRAN boolean; users need parameters. used set data path temporary directory examples tests run CRAN.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/set_data_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set the data path where climate reconstructions will be stored — set_data_path","text":"TRUE path set correctly","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/slice_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a slice for a time series of climate variables for a region — slice_region_series","title":"Extract a slice for a time series of climate variables for a region — slice_region_series","text":"function extracts time slice time series one climate variables given dataset covering region (whole world).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/slice_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a slice for a time series of climate variables for a region — slice_region_series","text":"","code":"slice_region_series(x, time_bp = NULL, time_ce = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/slice_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a slice for a time series of climate variables for a region — slice_region_series","text":"x climate time series generated region_series() time_bp time slice years present (.e. 1950, negative integers values past). slices need exist dataset. check slices available, can use time_bp(x). time_ce time slice years CE. one time_bp time_ce used.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/slice_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a slice for a time series of climate variables for a region — slice_region_series","text":"SpatRaster relevant slice.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","title":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","text":"functions extracts sets time years BP (.e. 1950) terra::SpatRaster  terra::SpatRasterDataset. terra::SpatRaster object, time stored unit \"years\", years 0AD. means , summary terra::SpatRaster inspected, times appear time_bp+1950. applies function terra::time() used instead time_bp().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","text":"","code":"time_bp(x)  # S4 method for SpatRaster time_bp(x)  # S4 method for SpatRasterDataset time_bp(x)  time_bp(x) <- value  # S4 method for SpatRaster time_bp(x) <- value  # S4 method for SpatRasterDataset time_bp(x) <- value"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","text":"x terra::SpatRaster value numeric vector times years BP","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","text":"date years BP (negative numbers indicate date past)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_i_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert a time BP to indexes for a series — time_bp_to_i_series","title":"Convert a time BP to indexes for a series — time_bp_to_i_series","text":"Internal function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_i_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert a time BP to indexes for a series — time_bp_to_i_series","text":"","code":"time_bp_to_i_series(time_bp, time_steps)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_i_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert a time BP to indexes for a series — time_bp_to_i_series","text":"time_bp vector times BP time_steps time steps reconstructions available","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_i_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert a time BP to indexes for a series — time_bp_to_i_series","text":"indeces relevant time steps","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Find the closest index to a given time in years BP — time_bp_to_index","title":"Find the closest index to a given time in years BP — time_bp_to_index","text":"Internal function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find the closest index to a given time in years BP — time_bp_to_index","text":"","code":"time_bp_to_index(time_bp, time_steps)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find the closest index to a given time in years BP — time_bp_to_index","text":"time_bp vector times BP time_steps time steps reconstructions available","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_index.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Find the closest index to a given time in years BP — time_bp_to_index","text":"indeces relevant time steps","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_series_for_locations.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","title":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","text":"Deprecated version location_series()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_series_for_locations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","text":"","code":"time_series_for_locations(...)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_series_for_locations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","text":"... arguments passed location_series()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_series_for_locations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","text":"data.frame climatic variables interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/update_dataset_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Update the dataset list — update_dataset_list","title":"Update the dataset list — update_dataset_list","text":"newer dataset list (includes information files storing data pastclim), download start using 'dataset_list_included.csv' tools::R_user_dir(\"pastclim\",\"config\"). latter present, last column, named 'dataset_list_v', provides version table, advanced table used.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/update_dataset_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Update the dataset list — update_dataset_list","text":"","code":"update_dataset_list(on_cran = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/update_dataset_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Update the dataset list — update_dataset_list","text":"on_cran boolean make function run ci tests using tempdir","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/update_dataset_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Update the dataset list — update_dataset_list","text":"TRUE dataset updated","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/validate_nc.html","id":null,"dir":"Reference","previous_headings":"","what":"Validate an netcdf file for pastclim — validate_nc","title":"Validate an netcdf file for pastclim — validate_nc","text":"function validates netcdf file potential dataset pastclim. key checks : ) dimensions (longitude, latitude time) set correctly. b) variables appropriate metadata (longname units)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/validate_nc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Validate an netcdf file for pastclim — validate_nc","text":"","code":"validate_nc(path_to_nc)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/validate_nc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Validate an netcdf file for pastclim — validate_nc","text":"path_to_nc path nc file interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/validate_nc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Validate an netcdf file for pastclim — validate_nc","text":"TRUE file valid.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate pretty variable labels for plotting — var_labels","title":"Generate pretty variable labels for plotting — var_labels","text":"Generate pretty labels (form expression) can used plotting","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate pretty variable labels for plotting — var_labels","text":"","code":"var_labels(x, dataset, with_units = TRUE, abbreviated = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate pretty variable labels for plotting — var_labels","text":"x either character vector names variables, terra::SpatRaster generated [region_slice())] [region_slice())]: R:region_slice()) dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets. with_units boolean defining whether label include units abbreviated boolean defining whether label use abbreviations variable","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generate pretty variable labels for plotting — var_labels","text":"expression can used label plots","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate pretty variable labels for plotting — var_labels","text":"","code":"var_labels(\"bio01\", dataset = \"Example\") #> expression(\"annual mean temperature (\" * degree * C * \")\")  # set the data_path for this example to run on CRAN # users don't need to run this line set_data_path(on_CRAN = TRUE) #> [1] TRUE  # for a SpatRaster climate_20k <- region_slice( time_bp = -20000, bio_variables = c(\"bio01\", \"bio10\", \"bio12\"), dataset = \"Example\" ) terra::plot(climate_20k, main = var_labels(climate_20k, dataset = \"Example\"))  terra::plot(climate_20k, main = var_labels(climate_20k, dataset = \"Example\",                    abbreviated = TRUE))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-124","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.4","title":"pastclim 1.2.4","text":"CRAN release: 2023-04-25 Updates time handled stay sync changes terra.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-123","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.3","title":"pastclim 1.2.3","text":"CRAN release: 2023-01-06 Added lai Krapp2021 (variable now also present original OSF repository dataset). Change column names data.frame returned location_series() match location_slice() Allow interpolation nearest neighbours location_series(), allow buffer estimates returned location_*() functions.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-122","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.2","title":"pastclim 1.2.2","text":"Update Krapp2021 files make compatible terra now handles time. Users re-download datasets. Old files can removed clean_data_path()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-121","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.1","title":"pastclim 1.2.1","text":"Small updates CRAN submission.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-120","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.0","title":"pastclim 1.2.0","text":"Provide additional information variables units, create pretty labels plots. Names locations now stored automatically outputs. Update time handled work terra 1.6-41 (now imports units netcdf files).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-110","dir":"Changelog","previous_headings":"","what":"pastclim 1.1.0","title":"pastclim 1.1.0","text":"Expand functionality handle time series regions; rename functions extract data regions locations make consistent. Old code still work, raise warning functions deprecated. Remove need pastclimData, now put data user dir returned R>=4.0.0. removes need re-downloading data upgrading R. Add monthly variables Beyer2020 Krapp2021.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-101","dir":"Changelog","previous_headings":"","what":"pastclim 1.0.1","title":"pastclim 1.0.1","text":"Fix bug information extracted just one location.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-100","dir":"Changelog","previous_headings":"","what":"pastclim 1.0.0","title":"pastclim 1.0.0","text":"Initial public release","code":""}]
+[{"path":"https://evolecolgroup.github.io/pastclim/dev/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"CC BY 4.0","title":"CC BY 4.0","text":"Attribution 4.0 International ======================================================================= Creative Commons Corporation (“Creative Commons”) law firm provide legal services legal advice. Distribution Creative Commons public licenses create lawyer-client relationship. Creative Commons makes licenses related information available “-” basis. Creative Commons gives warranties regarding licenses, material licensed terms conditions, related information. Creative Commons disclaims liability damages resulting use fullest extent possible. Using Creative Commons Public Licenses Creative Commons public licenses provide standard set terms conditions creators rights holders may use share original works authorship material subject copyright certain rights specified public license . following considerations informational purposes , exhaustive, form part licenses. ======================================================================= Creative Commons Attribution 4.0 International Public License exercising Licensed Rights (defined ), accept agree bound terms conditions Creative Commons Attribution 4.0 International Public License (“Public License”). extent Public License may interpreted contract, granted Licensed Rights consideration acceptance terms conditions, Licensor grants rights consideration benefits Licensor receives making Licensed Material available terms conditions. Section 1 – Definitions. Adapted Material means material subject Copyright Similar Rights derived based upon Licensed Material Licensed Material translated, altered, arranged, transformed, otherwise modified manner requiring permission Copyright Similar Rights held Licensor. purposes Public License, Licensed Material musical work, performance, sound recording, Adapted Material always produced Licensed Material synched timed relation moving image. Adapter’s License means license apply Copyright Similar Rights contributions Adapted Material accordance terms conditions Public License. Copyright Similar Rights means copyright /similar rights closely related copyright including, without limitation, performance, broadcast, sound recording, Sui Generis Database Rights, without regard rights labeled categorized. purposes Public License, rights specified Section 2(b)(1)-(2) Copyright Similar Rights. Effective Technological Measures means measures , absence proper authority, may circumvented laws fulfilling obligations Article 11 WIPO Copyright Treaty adopted December 20, 1996, /similar international agreements. Exceptions Limitations means fair use, fair dealing, /exception limitation Copyright Similar Rights applies use Licensed Material. Licensed Material means artistic literary work, database, material Licensor applied Public License. Licensed Rights means rights granted subject terms conditions Public License, limited Copyright Similar Rights apply use Licensed Material Licensor authority license. Licensor means individual(s) entity(ies) granting rights Public License. Share means provide material public means process requires permission Licensed Rights, reproduction, public display, public performance, distribution, dissemination, communication, importation, make material available public including ways members public may access material place time individually chosen . Sui Generis Database Rights means rights copyright resulting Directive 96/9/EC European Parliament Council 11 March 1996 legal protection databases, amended /succeeded, well essentially equivalent rights anywhere world. means individual entity exercising Licensed Rights Public License. corresponding meaning. Section 2 – Scope. License grant. Subject terms conditions Public License, Licensor hereby grants worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license exercise Licensed Rights Licensed Material : reproduce Share Licensed Material, whole part; produce, reproduce, Share Adapted Material. Exceptions Limitations. avoidance doubt, Exceptions Limitations apply use, Public License apply, need comply terms conditions. Term. term Public License specified Section 6(). Media formats; technical modifications allowed. Licensor authorizes exercise Licensed Rights media formats whether now known hereafter created, make technical modifications necessary . Licensor waives /agrees assert right authority forbid making technical modifications necessary exercise Licensed Rights, including technical modifications necessary circumvent Effective Technological Measures. purposes Public License, simply making modifications authorized Section 2() never produces Adapted Material. Downstream recipients. Offer Licensor – Licensed Material. Every recipient Licensed Material automatically receives offer Licensor exercise Licensed Rights terms conditions Public License. downstream restrictions. may offer impose additional different terms conditions , apply Effective Technological Measures , Licensed Material restricts exercise Licensed Rights recipient Licensed Material. endorsement. Nothing Public License constitutes may construed permission assert imply , use Licensed Material , connected , sponsored, endorsed, granted official status , Licensor others designated receive attribution provided Section 3()(1)()(). rights. Moral rights, right integrity, licensed Public License, publicity, privacy, /similar personality rights; however, extent possible, Licensor waives /agrees assert rights held Licensor limited extent necessary allow exercise Licensed Rights, otherwise. Patent trademark rights licensed Public License. extent possible, Licensor waives right collect royalties exercise Licensed Rights, whether directly collecting society voluntary waivable statutory compulsory licensing scheme. cases Licensor expressly reserves right collect royalties. Section 3 – License Conditions. exercise Licensed Rights expressly made subject following conditions. Attribution. Share Licensed Material (including modified form), must: retain following supplied Licensor Licensed Material: identification creator(s) Licensed Material others designated receive attribution, reasonable manner requested Licensor (including pseudonym designated); copyright notice; notice refers Public License; notice refers disclaimer warranties; URI hyperlink Licensed Material extent reasonably practicable; indicate modified Licensed Material retain indication previous modifications; indicate Licensed Material licensed Public License, include text , URI hyperlink , Public License. may satisfy conditions Section 3()(1) reasonable manner based medium, means, context Share Licensed Material. example, may reasonable satisfy conditions providing URI hyperlink resource includes required information. requested Licensor, must remove information required Section 3()(1)() extent reasonably practicable. Share Adapted Material produce, Adapter’s License apply must prevent recipients Adapted Material complying Public License. Section 4 – Sui Generis Database Rights. Licensed Rights include Sui Generis Database Rights apply use Licensed Material: avoidance doubt, Section 2()(1) grants right extract, reuse, reproduce, Share substantial portion contents database; include substantial portion database contents database Sui Generis Database Rights, database Sui Generis Database Rights (individual contents) Adapted Material; must comply conditions Section 3() Share substantial portion contents database. avoidance doubt, Section 4 supplements replace obligations Public License Licensed Rights include Copyright Similar Rights. Section 5 – Disclaimer Warranties Limitation Liability. UNLESS OTHERWISE SEPARATELY UNDERTAKEN LICENSOR, EXTENT POSSIBLE, LICENSOR OFFERS LICENSED MATERIAL --AVAILABLE, MAKES REPRESENTATIONS WARRANTIES KIND CONCERNING LICENSED MATERIAL, WHETHER EXPRESS, IMPLIED, STATUTORY, . INCLUDES, WITHOUT LIMITATION, WARRANTIES TITLE, MERCHANTABILITY, FITNESS PARTICULAR PURPOSE, NON-INFRINGEMENT, ABSENCE LATENT DEFECTS, ACCURACY, PRESENCE ABSENCE ERRORS, WHETHER KNOWN DISCOVERABLE. DISCLAIMERS WARRANTIES ALLOWED FULL PART, DISCLAIMER MAY APPLY . EXTENT POSSIBLE, EVENT LICENSOR LIABLE LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, NEGLIGENCE) OTHERWISE DIRECT, SPECIAL, INDIRECT, INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, LOSSES, COSTS, EXPENSES, DAMAGES ARISING PUBLIC LICENSE USE LICENSED MATERIAL, EVEN LICENSOR ADVISED POSSIBILITY LOSSES, COSTS, EXPENSES, DAMAGES. LIMITATION LIABILITY ALLOWED FULL PART, LIMITATION MAY APPLY . disclaimer warranties limitation liability provided shall interpreted manner , extent possible, closely approximates absolute disclaimer waiver liability. Section 6 – Term Termination. Public License applies term Copyright Similar Rights licensed . However, fail comply Public License, rights Public License terminate automatically. right use Licensed Material terminated Section 6(), reinstates: automatically date violation cured, provided cured within 30 days discovery violation; upon express reinstatement Licensor. avoidance doubt, Section 6(b) affect right Licensor may seek remedies violations Public License. avoidance doubt, Licensor may also offer Licensed Material separate terms conditions stop distributing Licensed Material time; however, terminate Public License. Sections 1, 5, 6, 7, 8 survive termination Public License. Section 7 – Terms Conditions. Licensor shall bound additional different terms conditions communicated unless expressly agreed. arrangements, understandings, agreements regarding Licensed Material stated herein separate independent terms conditions Public License. Section 8 – Interpretation. avoidance doubt, Public License , shall interpreted , reduce, limit, restrict, impose conditions use Licensed Material lawfully made without permission Public License. extent possible, provision Public License deemed unenforceable, shall automatically reformed minimum extent necessary make enforceable. provision reformed, shall severed Public License without affecting enforceability remaining terms conditions. term condition Public License waived failure comply consented unless expressly agreed Licensor. Nothing Public License constitutes may interpreted limitation upon, waiver , privileges immunities apply Licensor , including legal processes jurisdiction authority. ======================================================================= Creative Commons party public licenses. Notwithstanding, Creative Commons may elect apply one public licenses material publishes instances considered “Licensor.” text Creative Commons public licenses dedicated public domain CC0 Public Domain Dedication. Except limited purpose indicating material shared Creative Commons public license otherwise permitted Creative Commons policies published creativecommons.org/policies, Creative Commons authorize use trademark “Creative Commons” trademark logo Creative Commons without prior written consent including, without limitation, connection unauthorized modifications public licenses arrangements, understandings, agreements concerning use licensed material. avoidance doubt, paragraph form part public licenses. Creative Commons may contacted creativecommons.org.","code":"Considerations for licensors: Our public licenses are  intended for use by those authorized to give the public  permission to use material in ways otherwise restricted by  copyright and certain other rights. Our licenses are  irrevocable. Licensors should read and understand the terms  and conditions of the license they choose before applying it.  Licensors should also secure all rights necessary before  applying our licenses so that the public can reuse the  material as expected. Licensors should clearly mark any  material not subject to the license. This includes other CC-  licensed material, or material used under an exception or  limitation to copyright. More considerations for licensors: wiki.creativecommons.org/Considerations_for_licensors   Considerations for the public: By using one of our public  licenses, a licensor grants the public permission to use the  licensed material under specified terms and conditions. If  the licensor's permission is not necessary for any reason--for  example, because of any applicable exception or limitation to  copyright--then that use is not regulated by the license. Our  licenses grant only permissions under copyright and certain  other rights that a licensor has authority to grant. Use of  the licensed material may still be restricted for other  reasons, including because others have copyright or other  rights in the material. A licensor may make special requests,  such as asking that all changes be marked or described.  Although not required by our licenses, you are encouraged to  respect those requests where reasonable. More considerations  for the public:  wiki.creativecommons.org/Considerations_for_licensees"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"install-the-library","dir":"Articles","previous_headings":"","what":"Install the library","title":"pastclim overview","text":"pastclim CRAN, easiest way install : want latest development version, can get GitHub. install GitHub, need use devtools; haven’t done already, install CRAN install.packages(\"devtools\"). Also, note dev version pastclim tracks changes dev version terra, need upgrade : dedicated website, can find Articles giving step--step overview package, cheatsheet. also version site updated dev version (top left, version number red, format x.x.x.9xxx, indicating development version). want build vignette directly R installing pastclim GitHub, can : read directly R : Depending operating system use, might need additional packages build vignette. NOTE: pastclim relies terra process rasters. known bug terra leads occasional message: reported. error related garbage collection, affect script correctly executed, can ignored. discussion issue can found stackoverflow","code":"install.packages(\"pastclim\") install.packages('terra', repos='https://rspatial.r-universe.dev') devtools::install_github(\"EvolEcolGroup/pastclim\", ref=\"dev\") devtools::install_github(\"EvolEcolGroup/pastclim\", ref=\"dev\", build_vignettes = TRUE) vignette(\"pastclim_overview\", package = \"pastclim\") \"Error in x$.self$finalize() : attempt to apply non-function\""},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"download-the-data","dir":"Articles","previous_headings":"","what":"Download the data","title":"pastclim overview","text":"need download climatic reconstructions able real work pastclim. Currently library contains two datasets: Beyer2020 covers last 120k years; , project go back time, Krapp2021 goes back 800kya. possible add additional, custom datasets, need familiarity handling netcdf files (see vignette ‘custom dataset’). list datasets available can obtained typing Please aware using dataset made available pastclim require cite pastclim well original publication presenting dataset. reference cite pastclim can obtained typing reference associated dataset choice (case “Beyer2020”) displayed together general information dataset command: datasets available pastclim, functions help download data choose variables. start pastclim first time, need set path reconstructions stored using set_data_path. default, package data path used: Press 1 happy offered choices, pastclim remember data path future sessions. Note data path look different example, depends user name operating system. prefer using custom path (e.g. “~/my_reconstructions”), can set : package includes small dataset, Example, use vignette suitable running real analyses; real datasets large (100s Mb Gb), need specify want download (see ). Let us start inspecting Example dataset. can get list variables available dataset : available time steps can obtained : Beyer2020 Krapp2021, can get list available variables dataset : Note , default, annual variables shown. see available monthly variables, simply use: monthly variables, months coded “_xx” end variable names; e.g. “temperature_02” mean monthly temperature February. thorough description variable (including units) can obtained : able get available time steps download dataset. pastclim offers interface download necessary files data path. inspect datasets variables already downloaded data path, can use: Let’s now download bio01 bio05 Beyer2020 dataset (operation might take several minutes, datasets large; R pause download complete): Note multiple variables can packed together single file, get_downloaded_datasets() might list variables ones chose download (depends dataset). upgrading pastclim, new version various datasets might become available. make previously downloaded datasets obsolete, might suddenly told pastclim variables re-downloaded. can lead accumulation old datasets data path. function clean_data_path() can used delete old files longer needed.","code":"vignette(\"custom_datasets\", package = \"pastclim\") vignette(\"available_datasets\", package = \"pastclim\") citation(\"pastclim\") #> To cite pastclim in publications use: #>  #>   Leonardi M, Hallet EY, Beyer R, Krapp M, Manica A (2023). \"pastclim #>   1.2: an R package to easily access and use paleoclimatic #>   reconstructions.\" _Ecography_, *2023*, e06481. doi:10.1111/ecog.06481 #>   . #>  #> A BibTeX entry for LaTeX users is #>  #>   @Article{pastclim-article, #>     title = {pastclim 1.2: an R package to easily access and use paleoclimatic reconstructions}, #>     author = {Michela Leonardi and Emily Y. Hallet and Robert Beyer and Mario Krapp and Andrea Manica}, #>     journal = {Ecography}, #>     year = {2023}, #>     volume = {2023}, #>     pages = {e06481}, #>     publisher = {Wiley}, #>     doi = {10.1111/ecog.06481}, #>   } help(\"Beyer2020\") #> Documentation for the Beyer2020 dataset #>  #> Description: #>  #>      This dataset covers the last 120k years, at intervals of 1/2 k #>      years, and a resolution of 0.5 degrees in latitude and longitude. #>  #> Details: #>  #>      If you use this dataset, make sure to cite the original #>      publication: #>  #>      Beyer, R.M., Krapp, M. & Manica, A. High-resolution terrestrial #>      climate, bioclimate and vegetation for the last 120,000 years. Sci #>      Data 7, 236 (2020). doi:doi.org/10.1038/s41597-020-0552-1 #>       #>  #>      The version included in 'pastclim' has the ice sheets masked, as #>      well as internal seas (Black and Caspian Sea) removed. The latter #>      are based on: #>  #>       #>  #>       #>  #>      As there is no reconstruction of their depth through time, modern #>      outlines were used for all time steps. #>  #>      Also, for bio15, the coefficient of variation was computed after #>      adding one to monthly estimates, and it was multiplied by 100 #>      following  #>  #>      Changelog #>  #>      v1.1.0 Added monthly variables. Files can be downloaded from: #>       #>  #>      v1.0.0 Remove ice sheets and internal seas, and use correct #>      formula for bio15. Files can be downloaded from: #>      doi:doi.org/10.6084/m9.figshare.19723405.v1 #>       library(pastclim) set_data_path() #> Loading required package: terra #> terra 1.7.48 #> The data_path will be set to /home/andrea/.local/share/R/pastclim. #> A copy of the Example dataset will be copied there. #> This path will be saved by pastclim for future use. #> Proceed?  #>  #> 1: Yes #> 2: No set_data_path(path_to_nc = \"~/my_reconstructions\") get_vars_for_dataset(dataset = \"Example\") #> [1] \"bio01\" \"bio10\" \"bio12\" \"biome\" get_time_bp_steps(dataset = \"Example\") #> [1] -20000 -15000 -10000  -5000      0 get_vars_for_dataset(dataset = \"Beyer2020\") #>  [1] \"bio01\"    \"bio04\"    \"bio05\"    \"bio06\"    \"bio07\"    \"bio08\"    #>  [7] \"bio09\"    \"bio10\"    \"bio11\"    \"bio12\"    \"bio13\"    \"bio14\"    #> [13] \"bio15\"    \"bio16\"    \"bio17\"    \"bio18\"    \"bio19\"    \"npp\"      #> [19] \"lai\"      \"biome\"    \"altitude\" \"rugosity\" get_vars_for_dataset(dataset = \"Krapp2021\") #>  [1] \"bio01\"    \"bio04\"    \"bio05\"    \"bio06\"    \"bio07\"    \"bio08\"    #>  [7] \"bio09\"    \"bio10\"    \"bio11\"    \"bio12\"    \"bio13\"    \"bio14\"    #> [13] \"bio15\"    \"bio16\"    \"bio17\"    \"bio18\"    \"bio19\"    \"npp\"      #> [19] \"biome\"    \"lai\"      \"altitude\" \"rugosity\" get_vars_for_dataset(dataset = \"Beyer2020\", annual=FALSE, monthly=TRUE) #>  [1] \"temperature_01\"       \"temperature_02\"       \"temperature_03\"       #>  [4] \"temperature_04\"       \"temperature_05\"       \"temperature_06\"       #>  [7] \"temperature_07\"       \"temperature_08\"       \"temperature_09\"       #> [10] \"temperature_10\"       \"temperature_11\"       \"temperature_12\"       #> [13] \"precipitation_01\"     \"precipitation_02\"     \"precipitation_03\"     #> [16] \"precipitation_04\"     \"precipitation_05\"     \"precipitation_06\"     #> [19] \"precipitation_07\"     \"precipitation_08\"     \"precipitation_09\"     #> [22] \"precipitation_10\"     \"precipitation_11\"     \"precipitation_12\"     #> [25] \"cloudiness_01\"        \"cloudiness_02\"        \"cloudiness_03\"        #> [28] \"cloudiness_04\"        \"cloudiness_05\"        \"cloudiness_06\"        #> [31] \"cloudiness_07\"        \"cloudiness_08\"        \"cloudiness_09\"        #> [34] \"cloudiness_10\"        \"cloudiness_11\"        \"cloudiness_12\"        #> [37] \"relative_humidity_01\" \"relative_humidity_02\" \"relative_humidity_03\" #> [40] \"relative_humidity_04\" \"relative_humidity_05\" \"relative_humidity_06\" #> [43] \"relative_humidity_07\" \"relative_humidity_08\" \"relative_humidity_09\" #> [46] \"relative_humidity_10\" \"relative_humidity_11\" \"relative_humidity_12\" #> [49] \"wind_speed_01\"        \"wind_speed_02\"        \"wind_speed_03\"        #> [52] \"wind_speed_04\"        \"wind_speed_05\"        \"wind_speed_06\"        #> [55] \"wind_speed_07\"        \"wind_speed_08\"        \"wind_speed_09\"        #> [58] \"wind_speed_10\"        \"wind_speed_11\"        \"wind_speed_12\"        #> [61] \"mo_npp_01\"            \"mo_npp_02\"            \"mo_npp_03\"            #> [64] \"mo_npp_04\"            \"mo_npp_05\"            \"mo_npp_06\"            #> [67] \"mo_npp_07\"            \"mo_npp_08\"            \"mo_npp_09\"            #> [70] \"mo_npp_10\"            \"mo_npp_11\"            \"mo_npp_12\" get_vars_for_dataset(dataset=\"Example\", details = TRUE) #>   variable                           long_name           units #> 1    bio01             annual mean temperature degrees Celsius #> 2    bio10 mean temperature of warmest quarter degrees Celsius #> 3    bio12                annual precipitation     mm per year #> 4    biome                 biome (from BIOME4) get_downloaded_datasets() #> $Example #> [1] \"bio01\" \"bio10\" \"bio12\" \"biome\" download_dataset(dataset = \"Beyer2020\", bio_variables = c(\"bio01\", \"bio05\"))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"get-climate-for-locations","dir":"Articles","previous_headings":"","what":"Get climate for locations","title":"pastclim overview","text":"Often want get climate specific locations. can using function location_slice. function, get slices climate times relevant locations interest. Let us consider five possible locations interest: Iho Eleru (Late Stone Age inland site Nigeria), La Riera (Late Palaeolithic coastal site Spain), Chalki (Mesolithic site Greek island), Oronsay (Mesolithic site Scottish Hebrides), Atlantis (fabled submersed city mentioned Plato). site date (realistic, made ) interested associating climatic reconstructions. extract climatic conditions bio01 bio12: pastclim finds closest time step (slice) available given date, outputs slice used column time_bp_slice (Example dataset use vignette temporal resolution 5k years). Note Chalki Atlantis available (get NA) appropriate time steps. occurs location, reconstructions, either water ice, pastclim can return estimate. instances, due discretisation space raster. can interpolate climate among nearest neighbours, thus using climate reconstructions neighbouring pixels location just one land pixels: Chalki, can see problem indeed , since small island, well represented reconstructions (bear mind Example dataset coarse spatial resolution), can reconstruct appropriate climate interpolating. Atlantis, hand, middle ocean, information climate might became submerged (assuming ever existed…). Note nn_interpol = TRUE default function. Sometimes, want get time series climatic reconstructions, thus allowing us see climate changed time: resulting dataframe can subsetted get time series location (small Example dataset contains 5 time slices): Also note locations, climate can available certain time steps, depending sea level ice sheet extent. case Oronsay: can quickly plot bio01 time locations:  expected, don’t data Atlantis (always underwater), also fail retrieve data Chalki. location_series interpolate nearest neighbours default (, differs location_slice behaviour). rationale behaviour interested whether locations might end underwater, want grab climate estimates submerged. However, cases (Chalki) might necessary allow interpolation. Pretty labels environmental variables can generated var_labels:  Note climatic reconstructions extracted Example dataset, coarse, used base real inference environmental conditions. note also higher resolution always better. important consider appropriate spatial scale relevant question hand. Sometimes, might necessary downscale simulations (see section end vignette), cases might want get estimates cover area around specific location (e.g. comparing proxies capture climatology broad area, certain sediment cores capture pollen broader region). location_slice location_series can provide mean estimates areas around location coordinates setting buffer parameter (see help pages functions details).","code":"locations <- data.frame(   name = c(\"Iho Eleru\",\"La Riera\", \"Chalki\", \"Oronsay\",\"Atlantis\"),    longitude = c(5,-4, 27, -6, -24), latitude = c(7, 44, 36, 56, 31),   time_bp = c(-11200, -18738,-10227, -10200, -11600) ) locations #>        name longitude latitude time_bp #> 1 Iho Eleru         5        7  -11200 #> 2  La Riera        -4       44  -18738 #> 3    Chalki        27       36  -10227 #> 4   Oronsay        -6       56  -10200 #> 5  Atlantis       -24       31  -11600 location_slice(   x = locations, bio_variables = c(\"bio01\", \"bio12\"),   dataset = \"Example\", nn_interpol = FALSE ) #>        name longitude latitude time_bp time_bp_slice     bio01    bio12 #> 1 Iho Eleru         5        7  -11200        -10000 25.346703 2204.595 #> 2  La Riera        -4       44  -18738        -20000  5.741851 1149.570 #> 3    Chalki        27       36  -10227        -10000        NA       NA #> 4   Oronsay        -6       56  -10200        -10000  6.937467 1362.824 #> 5  Atlantis       -24       31  -11600        -10000        NA       NA location_slice(   x = locations, bio_variables = c(\"bio01\", \"bio12\"),   dataset = \"Example\", nn_interpol = TRUE) #>        name longitude latitude time_bp time_bp_slice     bio01     bio12 #> 1 Iho Eleru         5        7  -11200        -10000 25.346703 2204.5950 #> 2  La Riera        -4       44  -18738        -20000  5.741851 1149.5703 #> 3    Chalki        27       36  -10227        -10000 17.432425  723.1012 #> 4   Oronsay        -6       56  -10200        -10000  6.937467 1362.8245 #> 5  Atlantis       -24       31  -11600        -10000        NA        NA locations_ts <- location_series(   x = locations,   bio_variables = c(\"bio01\", \"bio12\"),   dataset = \"Example\") subset(locations_ts, name == \"Iho Eleru\") #>          name longitude latitude time_bp    bio01    bio12 #> 1   Iho Eleru         5        7  -20000 22.55133 1577.238 #> 1.1 Iho Eleru         5        7  -15000 23.27008 1850.715 #> 1.2 Iho Eleru         5        7  -10000 25.34670 2204.595 #> 1.3 Iho Eleru         5        7   -5000 25.65009 2109.735 #> 1.4 Iho Eleru         5        7       0 26.77033 1840.845 subset(locations_ts, name == \"Oronsay\") #>        name longitude latitude time_bp    bio01    bio12 #> 4   Oronsay        -6       56  -20000       NA       NA #> 4.1 Oronsay        -6       56  -15000       NA       NA #> 4.2 Oronsay        -6       56  -10000 6.937467 1362.824 #> 4.3 Oronsay        -6       56   -5000 8.167976 1462.253 #> 4.4 Oronsay        -6       56       0 8.185000 1434.490 library(ggplot2) ggplot(data=locations_ts, aes(x=time_bp, y=bio01, group=name)) +   geom_line(aes(col=name))+   geom_point(aes(col=name)) #> Warning: Removed 12 rows containing missing values (`geom_line()`). #> Warning: Removed 12 rows containing missing values (`geom_point()`). library(ggplot2) ggplot(data=locations_ts, aes(x=time_bp, y=bio01, group=name)) +   geom_line(aes(col=name))+   geom_point(aes(col=name))+   labs(y = var_labels(\"bio01\", dataset=\"Example\", abbreviated=TRUE),        x = \"time BP (yr)\") #> Warning: Removed 12 rows containing missing values (`geom_line()`). #> Warning: Removed 12 rows containing missing values (`geom_point()`)."},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"get-climate-for-a-region","dir":"Articles","previous_headings":"","what":"Get climate for a region","title":"pastclim overview","text":"Instead focussing specific locations, might want look whole region. given time step, can extract slice climate returns raster (technically SpatRaster object defined terra library, meaning can perform standard terra raster operations object). interact SpatRaster objects, need library terra loaded (otherwise might get errors correct method found, e.g. plotting). pastclim automatically loads terra, able work terra objects without problem: plot three variables (layers raster):  can add informative labels var_labels:  possible also load time series rasters function region_series. case, function returns SpatRasterDataset, variable sub-dataset: sub-dataset SpatRaster, time steps layers: Note terra stores dates years AD, BP. can inspect times years BP : can plot time series given variable (relabel plots use years bp):  plot climate variables given time step, can slice time series:  Instead giving minimum maximum time step, can also provide specific time steps region_series. Note pastclim function get vector time steps given MIS dataset. example, MIS 1, get: can use:","code":"climate_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\" ) climate_20k #> class       : SpatRaster  #> dimensions  : 150, 360, 3  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -60, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84  #> sources     : example_climate_v1.3.0.nc:BIO1   #>               example_climate_v1.3.0.nc:BIO10   #>               example_climate_v1.3.0.nc:BIO12   #> varnames    : bio01 (annual mean temperature)  #>               bio10 (mean temperature of warmest quarter)  #>               bio12 (annual precipitation)  #> names       :           bio01,           bio10,       bio12  #> unit        : degrees Celsius, degrees Celsius, mm per year  #> time (years): -18050 terra::plot(climate_20k) terra::plot(climate_20k,              main = var_labels(climate_20k, dataset = \"Example\", abbreviated = TRUE)) climate_region <- region_series(   time_bp = list(min = -15000, max = 0),    bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\") climate_region #> class       : SpatRasterDataset  #> subdatasets : 3  #> dimensions  : 150, 360 (nrow, ncol) #> nlyr        : 4, 4, 4  #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -60, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84  #> source(s)   : example_climate_v1.3.0.nc  #> names       : bio01, bio10, bio12 climate_region$bio01 #> class       : SpatRaster  #> dimensions  : 150, 360, 4  (nrow, ncol, nlyr) #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -60, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84  #> source      : example_climate_v1.3.0.nc:BIO1  #> varname     : bio01 (annual mean temperature)  #> names       :    bio01_-15000,    bio01_-10000,     bio01_-5000,         bio01_0  #> unit        : degrees Celsius, degrees Celsius, degrees Celsius, degrees Celsius  #> time (years): -13050 to 1950 time_bp(climate_region) #> [1] -15000 -10000  -5000      0 terra::plot(climate_region$bio01, main=time_bp(climate_region)) slice_10k <- slice_region_series(climate_region, time_bp = -10000) terra::plot(slice_10k) mis1_steps <- get_mis_time_steps(mis = 1, dataset = \"Example\") mis1_steps #> [1] -10000  -5000      0 climate_mis1 <- region_series(   time_bp = mis1_steps,    bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\" ) climate_mis1 #> class       : SpatRasterDataset  #> subdatasets : 3  #> dimensions  : 150, 360 (nrow, ncol) #> nlyr        : 3, 3, 3  #> resolution  : 1, 1  (x, y) #> extent      : -180, 180, -60, 90  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84  #> source(s)   : example_climate_v1.3.0.nc  #> names       : bio01, bio10, bio12"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"cropping","dir":"Articles","previous_headings":"","what":"Cropping","title":"pastclim overview","text":"Often want focus given region. number preset rectangular extents pastclim: can get corners European extent: can extract climate Europe setting ext region_slice:  can see plot, cutting Europe using rectangular shape keeps portion Northern Africa map. pastclim includes number pre-generated masks main continental masses, stored dataset region_outline sf::sfc object. can get list : can use function crop within region_slice keep area within desired outline.  can combine multiple regions together. example, can crop Africa Eurasia unioning two individual outlines:  Note outlines cross antimeridian split multiple polygons (can used without projecting rasters). Eurasia, eastern end Siberia left hand side plot. continent_outlines_union provides outlines single polygons (case want use projection). can also use custom outline (.e. polygon, coded terra::vect object) mask limit area covered raster. Note need reuse first vertex last vertex, close polygon:  region_series takes ext crop options region_slice limit extent climatic reconstructions.","code":"names(region_extent) #> [1] \"Africa\"    \"America\"   \"Asia\"      \"Europe\"    \"Eurasia\"   \"N_America\" #> [7] \"Oceania\"   \"S_America\" region_extent$Europe #> [1] -15  70  33  75 europe_climate_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   ext = region_extent$Europe ) terra::plot(europe_climate_20k) names(region_outline) #> [1] \"Africa\"    \"Eurasia\"   \"N_America\" \"Oceania\"   \"S_America\" \"Europe\" europe_climate_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   crop = region_outline$Europe ) terra::plot(europe_climate_20k) library(sf) #> Linking to GEOS 3.10.2, GDAL 3.4.1, PROJ 8.2.1; sf_use_s2() is TRUE afr_eurasia <- sf::st_union(region_outline$Africa, region_outline$Eurasia) climate_20k_afr_eurasia <- region_slice(   time_bp = -20000,   bio_variables  = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   crop = afr_eurasia) terra::plot(climate_20k_afr_eurasia) custom_vec <- terra::vect(\"POLYGON ((0 70, 25 70, 50 80, 170 80, 170 10,                               119 2.4, 119 0.8, 116 -7.6, 114 -12, 100 -40,                               -25 -40, -25 64, 0 70))\") climate_20k_custom <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   crop = custom_vec) terra::plot(climate_20k_custom)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"working-with-biomes-and-ice-sheets","dir":"Articles","previous_headings":"","what":"Working with biomes and ice sheets","title":"pastclim overview","text":"Beyer2020 Krapp2021 datasets include categorical variable detailing extension biomes. need plot extent specific biome, example desert, first extract variable subset just class interested using ID (21, case):  climate reconstructions show areas permanent ice. Ice sheets stored class 28 “biome” variable. can retrieve directly ice land (biome categories) masks :  can also add ice sheets plots climatic variables. First, need turn ice mask polygons: can add polygons layer (.e. variable) climate slice following code (note , add polygons every panel figure, need create function used argument fun within plot):  cases, multiple time points variable want see ice sheets change:  Note add ice sheets instance, build function takes single parameter index image (.e. 1 4 plot ) use subset list ice outlines. Sometimes interesting measure distance coastline (e.g. modelling species rely brackish water, determine distance marine resources archaeology). pastclim, can use use distance_from_sea, accounts sea level change based landmask:","code":"get_biome_classes(\"Example\") #>    id                           category #> 1   0                       Water bodies #> 2   1          Tropical evergreen forest #> 3   2     Tropical semi-deciduous forest #> 4   3 Tropical deciduous forest/woodland #> 5   4         Temperate deciduous forest #> 6   5           Temperate conifer forest #> 7   6                  Warm mixed forest #> 8   7                  Cool mixed forest #> 9   8                Cool conifer forest #> 10  9                  Cold mixed forest #> 11 10      Evegreen taiga/montane forest #> 12 11     Deciduous taiga/montane forest #> 13 12                   Tropical savanna #> 14 13      Tropical xerophytic shrubland #> 15 14     Temperate xerophytic shrubland #> 16 15     Temperate sclerophyll woodland #> 17 16      Temperate broadleaved savanna #> 18 17              Open conifer woodland #> 19 18                    Boreal parkland #> 20 19                 Tropical grassland #> 21 20                Temperate grassland #> 22 21                             Desert #> 23 22                      Steppe tundra #> 24 23                       Shrub tundra #> 25 24                 Dwarf shrub tundra #> 26 25             Prostrate shrub tundra #> 27 26    Cushion forb lichen moss tundra #> 28 27                             Barren #> 29 28                           Land ice biome_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"biome\"),   dataset = \"Example\" ) biome_20k$desert <- biome_20k$biome biome_20k$desert[biome_20k$desert != 21] <- FALSE biome_20k$desert[biome_20k$desert == 21] <- TRUE terra::plot(biome_20k) ice_mask <- get_ice_mask(-20000, dataset = \"Example\") land_mask <- get_land_mask(-20000, dataset = \"Example\") terra::plot(c(ice_mask, land_mask)) ice_mask_vect <- as.polygons(ice_mask) plot(climate_20k,       fun=function() polys(ice_mask_vect, col=\"gray\", lwd=0.5)) europe_climate <- region_series(   time_bp = c(-20000, -15000, -10000, 0),   bio_variables = c(\"bio01\"),   dataset = \"Example\",   ext = region_extent$Europe ) ice_masks <- get_ice_mask(c(-20000, -15000, -10000, 0),                           dataset = \"Example\") ice_poly_list<- lapply(ice_masks, as.polygons) plot(europe_climate$bio01, main=time_bp(europe_climate),      fun=function(i) polys(ice_poly_list[[i]],                             col=\"gray\",                            lwd=0.5)) distances_sea <- distance_from_sea(time_bp = c(-20000,0), dataset=\"Example\") #>  |---------|---------|---------|---------| =========================================                                             |---------|---------|---------|---------| =========================================                                            distances_sea_australia <- crop(distances_sea, terra::ext(100,170,-60,20)) plot(distances_sea_australia, main=time_bp(distances_sea_australia))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"adding-locations-to-region-plots","dir":"Articles","previous_headings":"","what":"Adding locations to region plots","title":"pastclim overview","text":"plot locations region plots, first need create SpatVector object dataframe metadata, specifying names columns x y coordinates: can add climate slice following code (note , add points every panel figure, need create function used argument fun within plot):  points within extent region plotted (, case, European locations). can combine ice sheets locations single plot:","code":"locations_vect <- vect(locations, geom=c(\"longitude\", \"latitude\")) locations_vect #>  class       : SpatVector  #>  geometry    : points  #>  dimensions  : 5, 2  (geometries, attributes) #>  extent      : -24, 27, 7, 56  (xmin, xmax, ymin, ymax) #>  coord. ref. :   #>  names       :      name    time_bp #>  type        :            #>  values      : Iho Eleru  -1.12e+04 #>                 La Riera -1.874e+04 #>                   Chalki -1.023e+04 plot(europe_climate_20k,       fun=function() points(locations_vect, col=\"red\", cex=2)) plot(europe_climate_20k,       fun=function() {         polys(ice_mask_vect, col=\"gray\", lwd=0.5)         points(locations_vect, col=\"red\", cex=2)      })"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"set-the-samples-within-the-background","dir":"Articles","previous_headings":"","what":"Set the samples within the background","title":"pastclim overview","text":"many studies, want set environmental conditions given set location within background time period. Let us start visualising background time step interest PCA:  can now get climatic conditions locations time step compute PCA scores based axes defined background: now can plot points top background  want pool background multiple time steps, can simple use region_series get series, transform data frame df_from_region_series.","code":"bio_vars <- c(\"bio01\", \"bio10\", \"bio12\") climate_10k <- region_slice(-10000,   bio_variables = bio_vars,   dataset = \"Example\" ) climate_values_10k <- df_from_region_slice(climate_10k) climate_10k_pca <- prcomp(climate_values_10k[, bio_vars],                            scale = TRUE, center = TRUE) plot(climate_10k_pca$x[, 2] ~ climate_10k_pca$x[, 1],   pch = 20, col = \"lightgray\",   xlab = \"PC1\", ylab = \"PC2\" ) locations_10k <- data.frame(   longitude = c(0, 90, 20, 5), latitude = c(20, 45, 50, 47),   time_bp = c(-9932, -9753, -10084, -10249) ) climate_loc_10k <- location_slice(   x = locations_10k[, c(\"longitude\", \"latitude\")],   time_bp = locations_10k$time_bp, bio_variables = bio_vars,   dataset = \"Example\" ) locations_10k_pca_scores <- predict(climate_10k_pca,                                      newdata = climate_loc_10k[, bio_vars]) plot(climate_10k_pca$x[, 2] ~ climate_10k_pca$x[, 1],   pch = 20, col = \"lightgray\",   xlab = \"PC1\", ylab = \"PC2\" ) points(locations_10k_pca_scores, pch = 20, col = \"red\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"random-sampling-of-background","dir":"Articles","previous_headings":"","what":"Random sampling of background","title":"pastclim overview","text":"instances (e.g. underlying raster large handle), might desirable sample background instead using values. interested single time step, can simply generate raster time slice interest, use sample_region_slice: samples multiple time steps, need sample background proportionally number points time step. , example, wanted 30 samples 20k years ago 50 samples 10k years ago: use data build PCA.","code":"climate_20k <- region_slice(   time_bp = -20000,   bio_variables = c(\"bio01\", \"bio10\"),   dataset = \"Example\" ) this_sample <- sample_region_slice(climate_20k, size = 100) head(this_sample) #>    cell     x     y      bio01    bio10 #> 1  8981 160.5  65.5 -20.492542  2.79441 #> 2 27552  11.5  13.5  23.633068 28.35611 #> 3 22230  89.5  28.5  -5.519563  4.36088 #> 4 11484 143.5  58.5 -12.875105 10.90693 #> 5 44250 149.5 -32.5  12.043017 19.04924 #> 6 21109  48.5  31.5  19.990810 29.66088 climate_ts <- region_series(   time_bp = c(-20000,-10000),   bio_variables = c(\"bio01\", \"bio10\", \"bio12\"),   dataset = \"Example\",   ext = terra::ext(region_extent$Europe) ) sampled_climate <- sample_region_series(climate_ts, size = c(3,5)) sampled_climate #>          cell    x    y      bio01    bio10     bio12 time_bp #> -20000.1 1681 50.5 55.5 -6.0324616 13.58117  430.1882  -20000 #> -20000.2 3256 10.5 36.5 14.0106421 23.11121  453.8929  -20000 #> -20000.3 1525 64.5 57.5 -8.7510185 12.83404  293.2224  -20000 #> -10000.1 2814 -6.5 41.5 11.7551479 22.32403  654.6106  -10000 #> -10000.2 1383  7.5 58.5  3.3640807 11.76538 1432.7773  -10000 #> -10000.3 1776 60.5 54.5  0.5935395 20.97770  398.5586  -10000 #> -10000.4 1237 31.5 60.5  1.3792480 10.32065  485.8271  -10000 #> -10000.5 3374 43.5 35.5 20.2427788 36.12845  262.7458  -10000"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a0_pastclim_overview.html","id":"downscaling","dir":"Articles","previous_headings":"","what":"Downscaling","title":"pastclim overview","text":"pastclim contain built-code change spatial resolution climatic reconstructions, possible downscale data using relevant function terra package. first need extract region time choice, case Europe 10,000 years ago  can downscale using disagg() function terra package, requiring aggregation factor expressed number cells direction (horizontally, vertically, , needed, layers). example used 25 horizontally vertically, using bilinear interpolation.  Note , whilst smoothed climate, land mask changed, thus still blocky edges.","code":"europe_10k <- region_slice(dataset=\"Example\",                             bio_variables = c(\"bio01\"),                            time_bp=-10000, ext=region_extent$Europe) terra::plot(europe_10k) europe_ds <- terra::disagg(europe_10k, fact=25, method='bilinear') terra::plot(europe_ds)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a1_available_datasets.html","id":"overview-of-datasets-available-in-pastclim","dir":"Articles","previous_headings":"","what":"Overview of datasets available in pastclim","title":"available datasets","text":"number datasets available pastclim. possible use custom datasets long properly formatted (look article format custom datasets interested). possible get list available datasets : comprehensive list can obtained : dataset, can get detailed information using help function: provide full documentation dataset (sorted alphabetical order):","code":"library(pastclim) #> Loading required package: terra #> terra 1.7.48 get_available_datasets() #> [1] \"Example\"   \"Beyer2020\" \"Krapp2021\" #> for present day reconstructions, use \"WorldClim_2.1_RESm\", where RES is an available resolution. #> for future predictions, use \"WorldClim_2.1_GCM_SSP_RESm\", where GCM is the GCM model, SSP is the Shared Societ-economic Pathways scenario. #> use help(\"WorldClim_2.1\") for a list of available options list_available_datasets() #>   [1] \"Example\"                                  #>   [2] \"Beyer2020\"                                #>   [3] \"Krapp2021\"                                #>   [4] \"WorldClim_2.1_10m\"                        #>   [5] \"WorldClim_2.1_5m\"                         #>   [6] \"WorldClim_2.1_ACCESS-CM2_ssp126_10m\"      #>   [7] \"WorldClim_2.1_ACCESS-CM2_ssp126_5m\"       #>   [8] \"WorldClim_2.1_ACCESS-CM2_ssp245_10m\"      #>   [9] \"WorldClim_2.1_ACCESS-CM2_ssp245_5m\"       #>  [10] \"WorldClim_2.1_ACCESS-CM2_ssp370_10m\"      #>  [11] \"WorldClim_2.1_ACCESS-CM2_ssp370_5m\"       #>  [12] \"WorldClim_2.1_ACCESS-CM2_ssp585_10m\"      #>  [13] \"WorldClim_2.1_ACCESS-CM2_ssp585_5m\"       #>  [14] \"WorldClim_2.1_BCC-CSM2-MR_ssp126_10m\"     #>  [15] \"WorldClim_2.1_BCC-CSM2-MR_ssp126_5m\"      #>  [16] \"WorldClim_2.1_BCC-CSM2-MR_ssp245_10m\"     #>  [17] \"WorldClim_2.1_BCC-CSM2-MR_ssp245_5m\"      #>  [18] \"WorldClim_2.1_BCC-CSM2-MR_ssp370_10m\"     #>  [19] \"WorldClim_2.1_BCC-CSM2-MR_ssp370_5m\"      #>  [20] \"WorldClim_2.1_BCC-CSM2-MR_ssp585_10m\"     #>  [21] \"WorldClim_2.1_BCC-CSM2-MR_ssp585_5m\"      #>  [22] \"WorldClim_2.1_CMCC-ESM2_ssp126_10m\"       #>  [23] \"WorldClim_2.1_CMCC-ESM2_ssp126_5m\"        #>  [24] \"WorldClim_2.1_CMCC-ESM2_ssp245_10m\"       #>  [25] \"WorldClim_2.1_CMCC-ESM2_ssp245_5m\"        #>  [26] \"WorldClim_2.1_CMCC-ESM2_ssp370_10m\"       #>  [27] \"WorldClim_2.1_CMCC-ESM2_ssp370_5m\"        #>  [28] \"WorldClim_2.1_CMCC-ESM2_ssp585_10m\"       #>  [29] \"WorldClim_2.1_CMCC-ESM2_ssp585_5m\"        #>  [30] \"WorldClim_2.1_EC-Earth3-Veg_ssp126_10m\"   #>  [31] \"WorldClim_2.1_EC-Earth3-Veg_ssp126_5m\"    #>  [32] \"WorldClim_2.1_EC-Earth3-Veg_ssp245_10m\"   #>  [33] \"WorldClim_2.1_EC-Earth3-Veg_ssp245_5m\"    #>  [34] \"WorldClim_2.1_EC-Earth3-Veg_ssp370_10m\"   #>  [35] \"WorldClim_2.1_EC-Earth3-Veg_ssp370_5m\"    #>  [36] \"WorldClim_2.1_EC-Earth3-Veg_ssp585_10m\"   #>  [37] \"WorldClim_2.1_EC-Earth3-Veg_ssp585_5m\"    #>  [38] \"WorldClim_2.1_FIO-ESM-2-0_ssp126_10m\"     #>  [39] \"WorldClim_2.1_FIO-ESM-2-0_ssp126_5m\"      #>  [40] \"WorldClim_2.1_FIO-ESM-2-0_ssp245_10m\"     #>  [41] \"WorldClim_2.1_FIO-ESM-2-0_ssp245_5m\"      #>  [42] \"WorldClim_2.1_FIO-ESM-2-0_ssp370_10m\"     #>  [43] \"WorldClim_2.1_FIO-ESM-2-0_ssp370_5m\"      #>  [44] \"WorldClim_2.1_FIO-ESM-2-0_ssp585_10m\"     #>  [45] \"WorldClim_2.1_FIO-ESM-2-0_ssp585_5m\"      #>  [46] \"WorldClim_2.1_GFDL-ESM4_ssp126_10m\"       #>  [47] \"WorldClim_2.1_GFDL-ESM4_ssp126_5m\"        #>  [48] \"WorldClim_2.1_GFDL-ESM4_ssp245_10m\"       #>  [49] \"WorldClim_2.1_GFDL-ESM4_ssp245_5m\"        #>  [50] \"WorldClim_2.1_GFDL-ESM4_ssp370_10m\"       #>  [51] \"WorldClim_2.1_GFDL-ESM4_ssp370_5m\"        #>  [52] \"WorldClim_2.1_GFDL-ESM4_ssp585_10m\"       #>  [53] \"WorldClim_2.1_GFDL-ESM4_ssp585_5m\"        #>  [54] \"WorldClim_2.1_GISS-E2-1-G_ssp126_10m\"     #>  [55] \"WorldClim_2.1_GISS-E2-1-G_ssp126_5m\"      #>  [56] \"WorldClim_2.1_GISS-E2-1-G_ssp245_10m\"     #>  [57] \"WorldClim_2.1_GISS-E2-1-G_ssp245_5m\"      #>  [58] \"WorldClim_2.1_GISS-E2-1-G_ssp370_10m\"     #>  [59] \"WorldClim_2.1_GISS-E2-1-G_ssp370_5m\"      #>  [60] \"WorldClim_2.1_GISS-E2-1-G_ssp585_10m\"     #>  [61] \"WorldClim_2.1_GISS-E2-1-G_ssp585_5m\"      #>  [62] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp126_10m\" #>  [63] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp126_5m\"  #>  [64] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\" #>  [65] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_5m\"  #>  [66] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp370_10m\" #>  [67] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp370_5m\"  #>  [68] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp585_10m\" #>  [69] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp585_5m\"  #>  [70] \"WorldClim_2.1_INM-CM5-0_ssp126_10m\"       #>  [71] \"WorldClim_2.1_INM-CM5-0_ssp126_5m\"        #>  [72] \"WorldClim_2.1_INM-CM5-0_ssp245_10m\"       #>  [73] \"WorldClim_2.1_INM-CM5-0_ssp245_5m\"        #>  [74] \"WorldClim_2.1_INM-CM5-0_ssp370_10m\"       #>  [75] \"WorldClim_2.1_INM-CM5-0_ssp370_5m\"        #>  [76] \"WorldClim_2.1_INM-CM5-0_ssp585_10m\"       #>  [77] \"WorldClim_2.1_INM-CM5-0_ssp585_5m\"        #>  [78] \"WorldClim_2.1_IPSL-CM6A-LR_ssp126_10m\"    #>  [79] \"WorldClim_2.1_IPSL-CM6A-LR_ssp126_5m\"     #>  [80] \"WorldClim_2.1_IPSL-CM6A-LR_ssp245_10m\"    #>  [81] \"WorldClim_2.1_IPSL-CM6A-LR_ssp245_5m\"     #>  [82] \"WorldClim_2.1_IPSL-CM6A-LR_ssp370_10m\"    #>  [83] \"WorldClim_2.1_IPSL-CM6A-LR_ssp370_5m\"     #>  [84] \"WorldClim_2.1_IPSL-CM6A-LR_ssp585_10m\"    #>  [85] \"WorldClim_2.1_IPSL-CM6A-LR_ssp585_5m\"     #>  [86] \"WorldClim_2.1_MIROC6_ssp126_10m\"          #>  [87] \"WorldClim_2.1_MIROC6_ssp126_5m\"           #>  [88] \"WorldClim_2.1_MIROC6_ssp245_10m\"          #>  [89] \"WorldClim_2.1_MIROC6_ssp245_5m\"           #>  [90] \"WorldClim_2.1_MIROC6_ssp370_10m\"          #>  [91] \"WorldClim_2.1_MIROC6_ssp370_5m\"           #>  [92] \"WorldClim_2.1_MIROC6_ssp585_10m\"          #>  [93] \"WorldClim_2.1_MIROC6_ssp585_5m\"           #>  [94] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp126_10m\"   #>  [95] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp126_5m\"    #>  [96] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp245_10m\"   #>  [97] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp245_5m\"    #>  [98] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp370_10m\"   #>  [99] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp370_5m\"    #> [100] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp585_10m\"   #> [101] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp585_5m\"    #> [102] \"WorldClim_2.1_MRI-ESM2-0_ssp126_10m\"      #> [103] \"WorldClim_2.1_MRI-ESM2-0_ssp126_5m\"       #> [104] \"WorldClim_2.1_MRI-ESM2-0_ssp245_10m\"      #> [105] \"WorldClim_2.1_MRI-ESM2-0_ssp245_5m\"       #> [106] \"WorldClim_2.1_MRI-ESM2-0_ssp370_10m\"      #> [107] \"WorldClim_2.1_MRI-ESM2-0_ssp370_5m\"       #> [108] \"WorldClim_2.1_MRI-ESM2-0_ssp585_10m\"      #> [109] \"WorldClim_2.1_MRI-ESM2-0_ssp585_5m\"       #> [110] \"WorldClim_2.1_UKESM1-0-LL_ssp126_10m\"     #> [111] \"WorldClim_2.1_UKESM1-0-LL_ssp126_5m\"      #> [112] \"WorldClim_2.1_UKESM1-0-LL_ssp245_10m\"     #> [113] \"WorldClim_2.1_UKESM1-0-LL_ssp245_5m\"      #> [114] \"WorldClim_2.1_UKESM1-0-LL_ssp370_10m\"     #> [115] \"WorldClim_2.1_UKESM1-0-LL_ssp370_5m\"      #> [116] \"WorldClim_2.1_UKESM1-0-LL_ssp585_10m\"     #> [117] \"WorldClim_2.1_UKESM1-0-LL_ssp585_5m\" help(\"Example\") #> Documentation for the Example dataset #>  #> Description: #>  #>      This dataset is a subset of Beyer2020, used for the vignette of #>      pastclim. Do not use this dataset for any real work, as it might #>      not reflect the most up-to-date version of Beyer2020. #> Documentation for the Beyer2020 dataset #>  #> Description: #>  #>      This dataset covers the last 120k years, at intervals of 1/2 k #>      years, and a resolution of 0.5 degrees in latitude and longitude. #>  #> Details: #>  #>      If you use this dataset, make sure to cite the original #>      publication: #>  #>      Beyer, R.M., Krapp, M. & Manica, A. High-resolution terrestrial #>      climate, bioclimate and vegetation for the last 120,000 years. Sci #>      Data 7, 236 (2020). doi:doi.org/10.1038/s41597-020-0552-1 #>       #>  #>      The version included in 'pastclim' has the ice sheets masked, as #>      well as internal seas (Black and Caspian Sea) removed. The latter #>      are based on: #>  #>       #>  #>       #>  #>      As there is no reconstruction of their depth through time, modern #>      outlines were used for all time steps. #>  #>      Also, for bio15, the coefficient of variation was computed after #>      adding one to monthly estimates, and it was multiplied by 100 #>      following  #>  #>      Changelog #>  #>      v1.1.0 Added monthly variables. Files can be downloaded from: #>       #>  #>      v1.0.0 Remove ice sheets and internal seas, and use correct #>      formula for bio15. Files can be downloaded from: #>      doi:doi.org/10.6084/m9.figshare.19723405.v1 #>       #>  #>  #> ####################################################### #> Documentation for the Example dataset #>  #> Description: #>  #>      This dataset is a subset of Beyer2020, used for the vignette of #>      pastclim. Do not use this dataset for any real work, as it might #>      not reflect the most up-to-date version of Beyer2020. #>  #>  #> ####################################################### #> Documentation for the Krapp2021 dataset #>  #> Description: #>  #>      This dataset covers the last 800k years, at intervals of 1k years, #>      and a resolution of 0.5 degrees in latitude and longitude. #>  #> Details: #>  #>      If you use this dataset, make sure to cite the original #>      publication: #>  #>      Krapp, M., Beyer, R.M., Edmundson, S.L. et al. A statistics-based #>      reconstruction of high-resolution global terrestrial climate for #>      the last 800,000 years. Sci Data 8, 228 (2021). #>      doi:doi.org/10.1038/s41597-021-01009-3 #>       #>  #>      The version included in 'pastclim' has the ice sheets masked. #>  #>      Note that, for bio15, we use the corrected version, which follows #>       #>  #>      Changelog #>  #>      v1.1.0 Added monthly variables. Files can be downloaded from: #>       #>  #>      v1.0.0 Remove ice sheets and use correct formula for bio15. Files #>      can be downloaded from: #>      doi:doi.org/10.6084/m9.figshare.19733680.v1 #>       #>  #>  #> ####################################################### #> Documentation for the WorldClim datasets #>  #> Description: #>  #>      WorldClim version 2.1 is a database of high spatial resolution #>      global weather and climate data, covering both the present and #>      future projections. #>  #> Details: #>  #>      *Present-day reconstructions* are based on the mean for the period #>      1970-2000, and are available at multiple resolutions of 10 #>      arc-minutes, 5 arc-minutes, 2.5 arc-minute and 0.5 arc-minutes. #>      The resolution of interest can be obtained by changing the ending #>      of the dataset name _WorldClim_2.1_RESm_, e.g. _WorldClim_2.1_10m_ #>      or _WorldClim_2.1_5m_ (currently, only 10m and 5m are currently #>      available in 'pastclim'). In 'pastclim', the datasets are given a #>      date of 1985 CE (the mid-point of the period of interest), #>      corresponding to a time_bp of 35. There are 19 <80><9c>bioclimatic<80><9d> #>      variables, as well as monthly estimates for minimum, mean, and #>      maximum temperature, and precipitation. #>  #>      *Future projections* are based on the models in CMIP6, downscaled #>      and de-biased using WorldClim 2.1 for the present as a baseline. #>      Monthly values of minimum temperature, maximum temperature, and #>      precipitation, as well as 19 bioclimatic variables were processed #>      for 23 global climate models (GCMs), and for four Shared #>      Socio-economic Pathways (SSPs): 126, 245, 370 and 585. Model and #>      SSP can be chosen by changing the ending of the dataset name #>      _WorldClim_2.1_GCM_SSP_RESm_. #>  #>      Available values for GCM are: \"ACCESS-CM2\", \"BCC-CSM2-MR\", #>      \"CMCC-ESM2\", \"EC-Earth3-Veg\", \"FIO-ESM-2-0\", \"GFDL-ESM4\", #>      \"GISS-E2-1-G\", \"HadGEM3-GC31-LL\", \"INM-CM5-0\", \"IPSL-CM6A-LR\", #>      \"MIROC6\", \"MPI-ESM1-2-HR\", \"MRI-ESM2-0\", and \"UKESM1-0-LL\". For #>      SSP, use: \"ssp126\", \"ssp245\", \"ssp370\", and \"ssp585\". RES takes #>      the same values as for present reconstructions (i.e. \"10m\", \"5m\", #>      \"2.5m\", and \"0.5m\"). Example dataset names are #>      _WorldClim_2.1_ACCESS-CM2_ssp245_10m_ and #>      _WorldClim_2.1_MRI-ESM2-0_ssp370_5m_ #>  #>      The dataset are averages over 20 year periods (2021-2040, #>      2041-2060, 2061-2080, 2081-2100). In 'pastclim', the midpoints of #>      the periods (2030, 2050, 2070, 2090) are used as the time stamps. #>      All 4 periods are automatically downloaded for each combination of #>      GCM model and SSP, and are selected as usual by defining the time #>      in functions such as 'region_slice()'. #>  #>      If you use this dataset, make sure to cite the original #>      publication: #>  #>      Fick, S.E. and R.J. Hijmans, 2017. WorldClim 2: new 1km spatial #>      resolution climate surfaces for global land areas. International #>      Journal of Climatology 37 (12): 4302-4315. #>      doi:doi.org/10.1002/joc.5086 #>       #>  #>  #> #######################################################"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a2_custom_datasets.html","id":"formatting-a-custom-dataset-for-pastclim","dir":"Articles","previous_headings":"","what":"Formatting a custom dataset for pastclim","title":"custom dataset","text":"guide aimed formatting data way can used pastclim. pastclim designed extract data netcdf files, format commonly used storing climate reconstructions. netcdf files number advantages, can store compressed information, well allowing access data required (e.g. extracting time steps location interest without reading data memory). expected format pastclim requires time steps given variable stored within single netcdf file. variables combined () flexible: can separate file variable, collate everything within single file, create multiple files including number variables. time variable years since 1950 (.e. negative integers indicating past). number command line tools well R libraries (e.g. cdo, gdal, terra) can help creating editing netcdf files.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a2_custom_datasets.html","id":"an-example-the-trace21k-chelsea","dir":"Articles","previous_headings":"","what":"An example: the Trace21k-CHELSEA","title":"custom dataset","text":"provide simple example format dataset R. use version Trace21k dataset, downscaled 30 arcsecs using CHELSEA algorithm(available website). data stored geoTIFF files, one file per time step per variable. First, need collate files given variable (use bio01 example) within single netcdf file. original files large, illustrate time steps aggregated 3x3 degrees keep files sizes small. start translating geoTIFF netcdf file. files prefix CHELSA_TraCE21k_bio01_-xxx_V1.0.small.tif, xxx number time step. use 3 time step illustrative purposes. store files single directory, create spatRaster list files directory: NOTE: terra changed way handles time reading netcdf. dev version terra can easily format netcdf files correctly, vignette presents number workarounds needed version CRAN Now need set time axis raster (case, reconstructions every 100 years), generate user friendly names layers raster: Now save data nc file (use temporary directory) can now read custom netcdf file pastclim. expected, one variable (“bio01”) 3 time steps (nlyr). can get times time steps : can slice series plot given time point:  Note reconstructions include ocean ice sheets, much better remove needed ecological/archaeological studies (allows smaller files).","code":"tiffs_path <- system.file(\"extdata/CHELSA_bio01\",package=\"pastclim\") list_of_tiffs <- file.path(tiffs_path,dir(tiffs_path)) bio01 <- terra::rast(list_of_tiffs) library(pastclim) #> Loading required package: terra #> terra 1.7.48 time_bp(bio01)<-c(0,-100,-200) names(bio01)<-paste(\"bio01\",terra::time(bio01),sep=\"_\") nc_name <- file.path(tempdir(),\"CHELSA_TraCE21k_bio01.nc\") terra::writeCDF(bio01, filename = nc_name, varname = \"bio01\",                 compression = 9, overwrite=TRUE) custom_series <- region_series(bio_variables = \"bio01\",                                 dataset = \"custom\",                                 path_to_nc = nc_name ) custom_series #> class       : SpatRasterDataset  #> subdatasets : 1  #> dimensions  : 174, 360 (nrow, ncol) #> nlyr        : 3  #> resolution  : 1, 1  (x, y) #> extent      : -180.0001, 179.9999, -90.00014, 83.99986  (xmin, xmax, ymin, ymax) #> coord. ref. : lon/lat WGS 84 (EPSG:4326)  #> source(s)   : CHELSA_TraCE21k_bio01.nc  #> names       : bio01 get_time_bp_steps(dataset=\"custom\", path_to_nc = nc_name) #> [1]    0 -100 -200 climate_100<-slice_region_series(custom_series, time_bp = -100) terra::plot(climate_100)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a2_custom_datasets.html","id":"making-the-data-available-to-others","dir":"Articles","previous_headings":"","what":"Making the data available to others","title":"custom dataset","text":"created suitably formatted netcdf files can used custom datasets pastclim, can add data officially package, thus make available others. necessary steps: Put files freely available repository. Update table used pastclim store information available datasets. table found “./data-raw/data_files/dataset_list_included.csv”. includes following fields: variable: variable name used pastclim ncvar: variable name within nc file (can variable) dataset: name dataset. monthly: boolean whether variable monthly. file_name: name file variable. download_path: URL download file. donwload_function: datasets can easily converted user valid netcdf, possibly leave download_path empty, create internal function downloads converts files. example, see WorldClim datasets. file_name_orig: name original file(s) used create nc dataset. download_path_orig: path original files. version: version dataset created long_name: long name variable abbreviated_name: abbreviated version long_name (used plot labels) time_frame: either year appropriate month units: units variable, displayed plain text table units_exp: units formatted included expression creating plot labels added lines detailing variables dataset, run script “./raw-data/dataset_list_included.R” store information appropriate dataset pastclim. Provide information new dataset file “./R/dataset_docs”, using roxygen2 syntax. Make sure provide appropriate reference original data, important users can refer back original source. Make Pull Request GitHub.","code":"#>   variable ncvar dataset monthly                 file_name download_path #> 1    bio01  BIO1 Example   FALSE example_climate_v1.3.0.nc               #> 2    bio10 BIO10 Example   FALSE example_climate_v1.3.0.nc               #>   download_function file_name_orig download_path_orig version #> 1                                                       1.3.0 #> 2                                                       1.3.0 #>                             long_name      abbreviated_name time_frame #> 1             annual mean temperature           ann. mean T       year #> 2 mean temperature of warmest quarter mean T of warmest qtr       year #>             units  units_exp dataset_list_v #> 1 degrees Celsius *degree*C*          1.3.9 #> 2 degrees Celsius *degree*C*"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a3_pastclim_present_and_future.html","id":"present-reconstructions","dir":"Articles","previous_headings":"","what":"Present reconstructions","title":"present and future","text":"Present-day reconstructions WorldClim v2.1 based mean period 1970-2000, available multiple resolutions 10 arc-minutes, 5 arc-minutes, 2.5 arc-minute 0.5 arc-minutes. resolution interest can obtained changing ending dataset name WorldClim_2.1_RESm, e.g. WorldClim_2.1_10m WorldClim_2.1_5m (currently, 10m 5m currently available pastclim). pastclim, datasets given date 1985 CE (mid-point period interest), corresponding time_bp 35. 19 “bioclimatic” variables, well monthly estimates minimum, mean, maximum temperature, precipitation. , annual variables 10m arc-minutes dataset : monthly variables can manipulate data usual way. start downloading dataset: can use region_slice extract data SpatRaster:","code":"library(pastclim) #> Loading required package: terra #> terra 1.7.48 get_vars_for_dataset(\"WorldClim_2.1_10m\") #>  [1] \"bio01\"    \"bio02\"    \"bio03\"    \"bio04\"    \"bio05\"    \"bio06\"    #>  [7] \"bio07\"    \"bio08\"    \"bio09\"    \"bio10\"    \"bio11\"    \"bio12\"    #> [13] \"bio13\"    \"bio14\"    \"bio15\"    \"bio16\"    \"bio17\"    \"bio18\"    #> [19] \"bio19\"    \"altitude\" get_vars_for_dataset(\"WorldClim_2.1_10m\", monthly =TRUE, annual=FALSE) #>  [1] \"temperature_01\"     \"temperature_02\"     \"temperature_03\"     #>  [4] \"temperature_04\"     \"temperature_05\"     \"temperature_06\"     #>  [7] \"temperature_07\"     \"temperature_08\"     \"temperature_09\"     #> [10] \"temperature_10\"     \"temperature_11\"     \"temperature_12\"     #> [13] \"precipitation_01\"   \"precipitation_02\"   \"precipitation_03\"   #> [16] \"precipitation_04\"   \"precipitation_05\"   \"precipitation_06\"   #> [19] \"precipitation_07\"   \"precipitation_08\"   \"precipitation_09\"   #> [22] \"precipitation_10\"   \"precipitation_11\"   \"precipitation_12\"   #> [25] \"temperature_min_01\" \"temperature_min_02\" \"temperature_min_03\" #> [28] \"temperature_min_04\" \"temperature_min_05\" \"temperature_min_06\" #> [31] \"temperature_min_07\" \"temperature_min_08\" \"temperature_min_09\" #> [34] \"temperature_min_10\" \"temperature_min_11\" \"temperature_min_12\" #> [37] \"temperature_max_01\" \"temperature_max_02\" \"temperature_max_03\" #> [40] \"temperature_max_04\" \"temperature_max_05\" \"temperature_max_06\" #> [43] \"temperature_max_07\" \"temperature_max_08\" \"temperature_max_09\" #> [46] \"temperature_max_10\" \"temperature_max_11\" \"temperature_max_12\" download_dataset(dataset = \"WorldClim_2.1_10m\",                   bio_variables = c(\"bio01\",\"bio02\",\"altitude\")) climate_present <- region_slice(time_ce=1985,                                  bio_variables = c(\"bio01\",\"bio02\",\"altitude\"),                                  dataset=\"WorldClim_2.1_10m\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/articles/a3_pastclim_present_and_future.html","id":"future-projections","dir":"Articles","previous_headings":"","what":"Future projections","title":"present and future","text":"Future projections based models CMIP6, downscaled de-biased using WorldClim 2.1 present baseline. Monthly values minimum temperature, maximum temperature, precipitation, well 19 bioclimatic variables processed 23 global climate models (GCMs), four Shared Socio-economic Pathways (SSPs): 126, 245, 370 585. Model SSP can chosen changing ending dataset name WorldClim_2.1_GCM_SSP_RESm. complete list available combinations can obtained : , interested HadGEM3-GC31-LL model, ssp set 245 10 arc-minutes, can get available variables: can now download “bio01” “bio02” dataset : dataset averages 20 year periods (2021-2040, 2041-2060, 2061-2080, 2081-2100). pastclim, midpoints periods (2030, 2050, 2070, 2090) used time stamps. 4 periods automatically downloaded combination GCM model SSP, can selected usual defining time region_slice. Alternatively, possible get full time series 4 slices : possible simply use time_ce(dataset = \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\") get available time points dataset. Help WorldClim datasets (modern future) can accessed help(\"WorldClim_2.1\")","code":"list_available_datasets() #>   [1] \"Example\"                                  #>   [2] \"Beyer2020\"                                #>   [3] \"Krapp2021\"                                #>   [4] \"WorldClim_2.1_10m\"                        #>   [5] \"WorldClim_2.1_5m\"                         #>   [6] \"WorldClim_2.1_ACCESS-CM2_ssp126_10m\"      #>   [7] \"WorldClim_2.1_ACCESS-CM2_ssp126_5m\"       #>   [8] \"WorldClim_2.1_ACCESS-CM2_ssp245_10m\"      #>   [9] \"WorldClim_2.1_ACCESS-CM2_ssp245_5m\"       #>  [10] \"WorldClim_2.1_ACCESS-CM2_ssp370_10m\"      #>  [11] \"WorldClim_2.1_ACCESS-CM2_ssp370_5m\"       #>  [12] \"WorldClim_2.1_ACCESS-CM2_ssp585_10m\"      #>  [13] \"WorldClim_2.1_ACCESS-CM2_ssp585_5m\"       #>  [14] \"WorldClim_2.1_BCC-CSM2-MR_ssp126_10m\"     #>  [15] \"WorldClim_2.1_BCC-CSM2-MR_ssp126_5m\"      #>  [16] \"WorldClim_2.1_BCC-CSM2-MR_ssp245_10m\"     #>  [17] \"WorldClim_2.1_BCC-CSM2-MR_ssp245_5m\"      #>  [18] \"WorldClim_2.1_BCC-CSM2-MR_ssp370_10m\"     #>  [19] \"WorldClim_2.1_BCC-CSM2-MR_ssp370_5m\"      #>  [20] \"WorldClim_2.1_BCC-CSM2-MR_ssp585_10m\"     #>  [21] \"WorldClim_2.1_BCC-CSM2-MR_ssp585_5m\"      #>  [22] \"WorldClim_2.1_CMCC-ESM2_ssp126_10m\"       #>  [23] \"WorldClim_2.1_CMCC-ESM2_ssp126_5m\"        #>  [24] \"WorldClim_2.1_CMCC-ESM2_ssp245_10m\"       #>  [25] \"WorldClim_2.1_CMCC-ESM2_ssp245_5m\"        #>  [26] \"WorldClim_2.1_CMCC-ESM2_ssp370_10m\"       #>  [27] \"WorldClim_2.1_CMCC-ESM2_ssp370_5m\"        #>  [28] \"WorldClim_2.1_CMCC-ESM2_ssp585_10m\"       #>  [29] \"WorldClim_2.1_CMCC-ESM2_ssp585_5m\"        #>  [30] \"WorldClim_2.1_EC-Earth3-Veg_ssp126_10m\"   #>  [31] \"WorldClim_2.1_EC-Earth3-Veg_ssp126_5m\"    #>  [32] \"WorldClim_2.1_EC-Earth3-Veg_ssp245_10m\"   #>  [33] \"WorldClim_2.1_EC-Earth3-Veg_ssp245_5m\"    #>  [34] \"WorldClim_2.1_EC-Earth3-Veg_ssp370_10m\"   #>  [35] \"WorldClim_2.1_EC-Earth3-Veg_ssp370_5m\"    #>  [36] \"WorldClim_2.1_EC-Earth3-Veg_ssp585_10m\"   #>  [37] \"WorldClim_2.1_EC-Earth3-Veg_ssp585_5m\"    #>  [38] \"WorldClim_2.1_FIO-ESM-2-0_ssp126_10m\"     #>  [39] \"WorldClim_2.1_FIO-ESM-2-0_ssp126_5m\"      #>  [40] \"WorldClim_2.1_FIO-ESM-2-0_ssp245_10m\"     #>  [41] \"WorldClim_2.1_FIO-ESM-2-0_ssp245_5m\"      #>  [42] \"WorldClim_2.1_FIO-ESM-2-0_ssp370_10m\"     #>  [43] \"WorldClim_2.1_FIO-ESM-2-0_ssp370_5m\"      #>  [44] \"WorldClim_2.1_FIO-ESM-2-0_ssp585_10m\"     #>  [45] \"WorldClim_2.1_FIO-ESM-2-0_ssp585_5m\"      #>  [46] \"WorldClim_2.1_GFDL-ESM4_ssp126_10m\"       #>  [47] \"WorldClim_2.1_GFDL-ESM4_ssp126_5m\"        #>  [48] \"WorldClim_2.1_GFDL-ESM4_ssp245_10m\"       #>  [49] \"WorldClim_2.1_GFDL-ESM4_ssp245_5m\"        #>  [50] \"WorldClim_2.1_GFDL-ESM4_ssp370_10m\"       #>  [51] \"WorldClim_2.1_GFDL-ESM4_ssp370_5m\"        #>  [52] \"WorldClim_2.1_GFDL-ESM4_ssp585_10m\"       #>  [53] \"WorldClim_2.1_GFDL-ESM4_ssp585_5m\"        #>  [54] \"WorldClim_2.1_GISS-E2-1-G_ssp126_10m\"     #>  [55] \"WorldClim_2.1_GISS-E2-1-G_ssp126_5m\"      #>  [56] \"WorldClim_2.1_GISS-E2-1-G_ssp245_10m\"     #>  [57] \"WorldClim_2.1_GISS-E2-1-G_ssp245_5m\"      #>  [58] \"WorldClim_2.1_GISS-E2-1-G_ssp370_10m\"     #>  [59] \"WorldClim_2.1_GISS-E2-1-G_ssp370_5m\"      #>  [60] \"WorldClim_2.1_GISS-E2-1-G_ssp585_10m\"     #>  [61] \"WorldClim_2.1_GISS-E2-1-G_ssp585_5m\"      #>  [62] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp126_10m\" #>  [63] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp126_5m\"  #>  [64] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\" #>  [65] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_5m\"  #>  [66] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp370_10m\" #>  [67] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp370_5m\"  #>  [68] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp585_10m\" #>  [69] \"WorldClim_2.1_HadGEM3-GC31-LL_ssp585_5m\"  #>  [70] \"WorldClim_2.1_INM-CM5-0_ssp126_10m\"       #>  [71] \"WorldClim_2.1_INM-CM5-0_ssp126_5m\"        #>  [72] \"WorldClim_2.1_INM-CM5-0_ssp245_10m\"       #>  [73] \"WorldClim_2.1_INM-CM5-0_ssp245_5m\"        #>  [74] \"WorldClim_2.1_INM-CM5-0_ssp370_10m\"       #>  [75] \"WorldClim_2.1_INM-CM5-0_ssp370_5m\"        #>  [76] \"WorldClim_2.1_INM-CM5-0_ssp585_10m\"       #>  [77] \"WorldClim_2.1_INM-CM5-0_ssp585_5m\"        #>  [78] \"WorldClim_2.1_IPSL-CM6A-LR_ssp126_10m\"    #>  [79] \"WorldClim_2.1_IPSL-CM6A-LR_ssp126_5m\"     #>  [80] \"WorldClim_2.1_IPSL-CM6A-LR_ssp245_10m\"    #>  [81] \"WorldClim_2.1_IPSL-CM6A-LR_ssp245_5m\"     #>  [82] \"WorldClim_2.1_IPSL-CM6A-LR_ssp370_10m\"    #>  [83] \"WorldClim_2.1_IPSL-CM6A-LR_ssp370_5m\"     #>  [84] \"WorldClim_2.1_IPSL-CM6A-LR_ssp585_10m\"    #>  [85] \"WorldClim_2.1_IPSL-CM6A-LR_ssp585_5m\"     #>  [86] \"WorldClim_2.1_MIROC6_ssp126_10m\"          #>  [87] \"WorldClim_2.1_MIROC6_ssp126_5m\"           #>  [88] \"WorldClim_2.1_MIROC6_ssp245_10m\"          #>  [89] \"WorldClim_2.1_MIROC6_ssp245_5m\"           #>  [90] \"WorldClim_2.1_MIROC6_ssp370_10m\"          #>  [91] \"WorldClim_2.1_MIROC6_ssp370_5m\"           #>  [92] \"WorldClim_2.1_MIROC6_ssp585_10m\"          #>  [93] \"WorldClim_2.1_MIROC6_ssp585_5m\"           #>  [94] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp126_10m\"   #>  [95] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp126_5m\"    #>  [96] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp245_10m\"   #>  [97] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp245_5m\"    #>  [98] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp370_10m\"   #>  [99] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp370_5m\"    #> [100] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp585_10m\"   #> [101] \"WorldClim_2.1_MPI-ESM1-2-HR_ssp585_5m\"    #> [102] \"WorldClim_2.1_MRI-ESM2-0_ssp126_10m\"      #> [103] \"WorldClim_2.1_MRI-ESM2-0_ssp126_5m\"       #> [104] \"WorldClim_2.1_MRI-ESM2-0_ssp245_10m\"      #> [105] \"WorldClim_2.1_MRI-ESM2-0_ssp245_5m\"       #> [106] \"WorldClim_2.1_MRI-ESM2-0_ssp370_10m\"      #> [107] \"WorldClim_2.1_MRI-ESM2-0_ssp370_5m\"       #> [108] \"WorldClim_2.1_MRI-ESM2-0_ssp585_10m\"      #> [109] \"WorldClim_2.1_MRI-ESM2-0_ssp585_5m\"       #> [110] \"WorldClim_2.1_UKESM1-0-LL_ssp126_10m\"     #> [111] \"WorldClim_2.1_UKESM1-0-LL_ssp126_5m\"      #> [112] \"WorldClim_2.1_UKESM1-0-LL_ssp245_10m\"     #> [113] \"WorldClim_2.1_UKESM1-0-LL_ssp245_5m\"      #> [114] \"WorldClim_2.1_UKESM1-0-LL_ssp370_10m\"     #> [115] \"WorldClim_2.1_UKESM1-0-LL_ssp370_5m\"      #> [116] \"WorldClim_2.1_UKESM1-0-LL_ssp585_10m\"     #> [117] \"WorldClim_2.1_UKESM1-0-LL_ssp585_5m\" get_vars_for_dataset(dataset = \"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\") #>  [1] \"bio01\" \"bio02\" \"bio03\" \"bio04\" \"bio05\" \"bio06\" \"bio07\" \"bio08\" \"bio09\" #> [10] \"bio10\" \"bio11\" \"bio12\" \"bio13\" \"bio14\" \"bio15\" \"bio16\" \"bio17\" \"bio18\" #> [19] \"bio19\" download_dataset(dataset=\"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\",                  bio_variables = c(\"bio01\",\"bio02\")) future_slice <- region_slice(time_ce = 2030,                               dataset=\"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\",                               bio_variables = c(\"bio01\",\"bio02\")) future_series <- region_series(dataset=\"WorldClim_2.1_HadGEM3-GC31-LL_ssp245_10m\",                               bio_variables = c(\"bio01\",\"bio02\"))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"Michela Leonardi. Author. Emily Y. Hallet. Contributor. Robert Beyer. Contributor. Mario Krapp. Contributor. Andrea Manica. Author, maintainer.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Leonardi M, Hallet EY, Beyer R, Krapp M, Manica (2023). “pastclim 1.2: R package easily access use paleoclimatic reconstructions.” Ecography, 2023, e06481. doi:10.1111/ecog.06481.","code":"@Article{pastclim-article,   title = {pastclim 1.2: an R package to easily access and use paleoclimatic reconstructions},   author = {Michela Leonardi and Emily Y. Hallet and Robert Beyer and Mario Krapp and Andrea Manica},   journal = {Ecography},   year = {2023},   volume = {2023},   pages = {e06481},   publisher = {Wiley},   doi = {10.1111/ecog.06481}, }"},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"pastclim-","dir":"","previous_headings":"","what":"Manipulate Time Series of Palaeoclimate Reconstructions ","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"R library designed provide easy way extract manipulate palaeoclimate reconstructions ecological anthropological analyses. functionalities pastclim described Leonardi et al. (2023). Please cite use pastclim research.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"install-the-library","dir":"","previous_headings":"","what":"Install the library","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"pastclim CRAN, easiest way install : version CRAN recommended every day use. New features bug fixes appear first dev branch GitHub, make way CRAN. need early access new features, can install pastclim directly GitHub. install GitHub, need use devtools; haven’t done already, get CRAN install.packages(\"devtools\"). Also, note dev version pastclim tracks changes dev version terra, need upgrade libraries :","code":"install.packages(\"pastclim\") install.packages('terra', repos='https://rspatial.r-universe.dev')  devtools::install_github(\"EvolEcolGroup/pastclim\", ref=\"dev\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"overview-of-functionality","dir":"","previous_headings":"","what":"Overview of functionality","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"dedicated website, can find Articles giving step--step overview package, cheatsheet. also dev version site updated dev branch pastclim (top left dev website, version number red format x.x.x.9xxx, indicating development version). Pastclim currently includes data Beyer et al 2020, reconstruction climate based HadCM3 model last 120k years, Krapp et al 2021, covers last 800k years. reconstructions bias-corrected downscaled 0.5 degree. details datasets can found . also instructions build use custom datasets. can also build vignettes installing pastclim (note need necessary tools build vignettes already installed; requirements depend OS): built vignettes, can read directly R. example, overview can obtained :","code":"devtools::install_github(\"EvolEcolGroup/pastclim\", build_vignette = TRUE) vignette(\"pastclim_overview\", package = \"pastclim\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"current-issues","dir":"","previous_headings":"","what":"Current issues","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"something work, check issues GitHub see whether problem already reported. , feel free create new issue. Please make sure updated latest version pastclim CRAN, well updating packages system, provide reproducible example developers investigate problem.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/index.html","id":"error-in-xselffinalize","dir":"","previous_headings":"Current issues","what":"Error in x$.self$finalize()","title":"Manipulate Time Series of Palaeoclimate Reconstructions ","text":"pastclim relies terra process rasters. known bug terra leads occasional message: error related garbage collection, affect script correctly executed, can ignored. discussion issue can found stackoverflow","code":"\"Error in x$.self$finalize() : attempt to apply non-function\""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Beyer2020.html","id":null,"dir":"Reference","previous_headings":"","what":"Documentation for the Beyer2020 dataset — Beyer2020","title":"Documentation for the Beyer2020 dataset — Beyer2020","text":"dataset covers last 120k years, intervals 1/2 k years, resolution 0.5 degrees latitude longitude.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Beyer2020.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Documentation for the Beyer2020 dataset — Beyer2020","text":"use dataset, make sure cite original publication: Beyer, R.M., Krapp, M. & Manica, . High-resolution terrestrial climate, bioclimate vegetation last 120,000 years. Sci Data 7, 236 (2020). doi:doi.org/10.1038/s41597-020-0552-1 version included pastclim ice sheets masked, well internal seas (Black Caspian Sea) removed. latter based : https://www.marineregions.org/gazetteer.php?p=details&id=4278 https://www.marineregions.org/gazetteer.php?p=details&id=4282 reconstruction depth time, modern outlines used time steps. Also, bio15, coefficient variation computed adding one monthly estimates, multiplied 100 following https://pubs.usgs.gov/ds/691/ds691.pdf Changelog v1.1.0 Added monthly variables. Files can downloaded : https://zenodo.org/deposit/7062281 v1.0.0 Remove ice sheets internal seas, use correct formula bio15. Files can downloaded : doi:doi.org/10.6084/m9.figshare.19723405.v1","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Example.html","id":null,"dir":"Reference","previous_headings":"","what":"Documentation for the Example dataset — Example","title":"Documentation for the Example dataset — Example","text":"dataset subset Beyer2020, used vignette pastclim. use dataset real work, might reflect --date version Beyer2020.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Krapp2021.html","id":null,"dir":"Reference","previous_headings":"","what":"Documentation for the Krapp2021 dataset — Krapp2021","title":"Documentation for the Krapp2021 dataset — Krapp2021","text":"dataset covers last 800k years, intervals 1k years, resolution 0.5 degrees latitude longitude.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/Krapp2021.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Documentation for the Krapp2021 dataset — Krapp2021","text":"use dataset, make sure cite original publication: Krapp, M., Beyer, R.M., Edmundson, S.L. et al. statistics-based reconstruction high-resolution global terrestrial climate last 800,000 years. Sci Data 8, 228 (2021). doi:doi.org/10.1038/s41597-021-01009-3 version included pastclim ice sheets masked. Note , bio15, use corrected version, follows https://pubs.usgs.gov/ds/691/ds691.pdf Changelog v1.1.0 Added monthly variables. Files can downloaded : https://zenodo.org/record/7065055 v1.0.0 Remove ice sheets use correct formula bio15. Files can downloaded : doi:doi.org/10.6084/m9.figshare.19733680.v1","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/WorldClim_2.1.html","id":null,"dir":"Reference","previous_headings":"","what":"Documentation for the WorldClim datasets — WorldClim_2.1","title":"Documentation for the WorldClim datasets — WorldClim_2.1","text":"WorldClim version 2.1 database high spatial resolution global weather climate data, covering present future projections.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/WorldClim_2.1.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Documentation for the WorldClim datasets — WorldClim_2.1","text":"Present-day reconstructions based mean period 1970-2000, available multiple resolutions 10 arc-minutes, 5 arc-minutes, 2.5 arc-minute 0.5 arc-minutes. resolution interest can obtained changing ending dataset name WorldClim_2.1_RESm, e.g. WorldClim_2.1_10m WorldClim_2.1_5m (currently, 10m 5m currently available pastclim). pastclim, datasets given date 1985 CE (mid-point period interest), corresponding time_bp 35. 19 “bioclimatic” variables, well monthly estimates minimum, mean, maximum temperature, precipitation. Future projections based models CMIP6, downscaled de-biased using WorldClim 2.1 present baseline. Monthly values minimum temperature, maximum temperature, precipitation, well 19 bioclimatic variables processed 23 global climate models (GCMs), four Shared Socio-economic Pathways (SSPs): 126, 245, 370 585. Model SSP can chosen changing ending dataset name WorldClim_2.1_GCM_SSP_RESm. Available values GCM : \"ACCESS-CM2\", \"BCC-CSM2-MR\", \"CMCC-ESM2\", \"EC-Earth3-Veg\", \"FIO-ESM-2-0\", \"GFDL-ESM4\", \"GISS-E2-1-G\", \"HadGEM3-GC31-LL\", \"INM-CM5-0\", \"IPSL-CM6A-LR\", \"MIROC6\", \"MPI-ESM1-2-HR\", \"MRI-ESM2-0\", \"UKESM1-0-LL\". SSP, use: \"ssp126\", \"ssp245\",\t\"ssp370\",\t\"ssp585\". RES takes values present reconstructions (.e. \"10m\", \"5m\", \"2.5m\", \"0.5m\"). Example dataset names WorldClim_2.1_ACCESS-CM2_ssp245_10m WorldClim_2.1_MRI-ESM2-0_ssp370_5m dataset averages 20 year periods (2021-2040, 2041-2060, 2061-2080, 2081-2100). pastclim, midpoints periods (2030, 2050, 2070, 2090) used time stamps. 4 periods automatically downloaded combination GCM model SSP, selected usual defining time functions region_slice(). use dataset, make sure cite original publication: Fick, S.E. R.J. Hijmans, 2017. WorldClim 2: new 1km spatial resolution climate surfaces global land areas. International Journal Climatology 37 (12): 4302-4315. doi:doi.org/10.1002/joc.5086","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute the BIOCLIM variables — bioclim_vars","title":"Compute the BIOCLIM variables — bioclim_vars","text":"compute BIOCLIM variables monthly average temperature precipitation data. modern data, variables generally computed using min maximum temperature, many palaeoclimatic reconstructions average temperature available. variables, exception BIO02 BIO03, can rephrased meaningfully terms mean temperature. function modified version predicts::bcvars.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute the BIOCLIM variables — bioclim_vars","text":"","code":"bioclim_vars(prec, tavg, ...)  # S4 method for numeric,numeric bioclim_vars(prec, tavg)  # S4 method for SpatRaster,SpatRaster bioclim_vars(prec, tavg, filename = \"\", ...)  # S4 method for SpatRasterDataset,SpatRasterDataset bioclim_vars(prec, tavg, filename = \"\", ...)  # S4 method for matrix,matrix bioclim_vars(prec, tavg)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute the BIOCLIM variables — bioclim_vars","text":"prec monthly precipitation tavg monthly average temperatures ... additional variables specific methods filename filename raster can stored.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute the BIOCLIM variables — bioclim_vars","text":"bioclim variables","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/bioclim_vars-methods.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Compute the BIOCLIM variables — bioclim_vars","text":"variables : BIO01 = Annual Mean Temperature BIO04 = Temperature Seasonality (standard deviation *100) BIO05 = Max Temperature Warmest Month BIO06 = Min Temperature Coldest Month BIO07 = Temperature Annual Range (P5-P6) BIO08 = Mean Temperature Wettest Quarter BIO09 = Mean Temperature Driest Quarter BIO10 = Mean Temperature Warmest Quarter BIO11 = Mean Temperature Coldest Quarter BIO12 = Annual Precipitation BIO13 = Precipitation Wettest Month BIO14 = Precipitation Driest Month BIO15 = Precipitation Seasonality (Coefficient Variation) BIO16 = Precipitation Wettest Quarter BIO17 = Precipitation Driest Quarter BIO18 = Precipitation Warmest Quarter BIO19 = Precipitation Coldest Quarter summary Bioclimatic variables : Nix, 1986. biogeographic analysis Australian elapid snakes. : R. Longmore (ed.). Atlas elapid snakes Australia. Australian Flora Fauna Series 7. Australian Government Publishing Service, Canberra.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if dataset is available. — check_available_dataset","title":"Check if dataset is available. — check_available_dataset","text":"Internal getter function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if dataset is available. — check_available_dataset","text":"","code":"check_available_dataset(dataset, include_custom = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if dataset is available. — check_available_dataset","text":"dataset string defining dataset include_custom boolean whether 'custom' dataset allowed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if dataset is available. — check_available_dataset","text":"TRUE dataset available","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_variable.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if var is available for this dataset. — check_available_variable","title":"Check if var is available for this dataset. — check_available_variable","text":"Internal getter function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_variable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if var is available for this dataset. — check_available_variable","text":"","code":"check_available_variable(variable, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_variable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if var is available for this dataset. — check_available_variable","text":"variable vector names variables interest dataset dataset interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_available_variable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if var is available for this dataset. — check_available_variable","text":"TRUE var available","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_coords_names.html","id":null,"dir":"Reference","previous_headings":"","what":"Check that we have a valid pair of coordinate names — check_coords_names","title":"Check that we have a valid pair of coordinate names — check_coords_names","text":"internal function checks coords (passed functions) valid set names, , NULL, standard variable names data","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_coords_names.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check that we have a valid pair of coordinate names — check_coords_names","text":"","code":"check_coords_names(data, coords)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_coords_names.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check that we have a valid pair of coordinate names — check_coords_names","text":"data data.frame containing locations. coords vector length two giving names \"x\" \"y\" coordinates, points data.frame use standard names.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_coords_names.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check that we have a valid pair of coordinate names — check_coords_names","text":"vector length 2 valid names, correct order","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_dataset_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Check dataset and path_to_nc params — check_dataset_path","title":"Check dataset and path_to_nc params — check_dataset_path","text":"Check dataset path_to_nc parameters valid. Specifically, path_to_nc set dataset custom (conversely, custom datasets require path_to_nc).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_dataset_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check dataset and path_to_nc params — check_dataset_path","text":"","code":"check_dataset_path(dataset, path_to_nc)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_dataset_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check dataset and path_to_nc params — check_dataset_path","text":"dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\". path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_dataset_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check dataset and path_to_nc params — check_dataset_path","text":"TRUE dataset path valid.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_time_vars.html","id":null,"dir":"Reference","previous_headings":"","what":"Check multiple time variables — check_time_vars","title":"Check multiple time variables — check_time_vars","text":"Check one set times","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_time_vars.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check multiple time variables — check_time_vars","text":"","code":"check_time_vars(time_bp, time_ce, allow_null = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_time_vars.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check multiple time variables — check_time_vars","text":"time_bp times bp time_ce times ce allow_null boolean whether can NULL","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_time_vars.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check multiple time variables — check_time_vars","text":"times bp","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_downloaded.html","id":null,"dir":"Reference","previous_headings":"","what":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","title":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","text":"Internal function check whether downloaded given variable dataset","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_downloaded.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","text":"","code":"check_var_downloaded(variable, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_downloaded.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","text":"variable vector names variables interest dataset dataset interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_downloaded.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Internal function to check whether we have downloaded a given variable\nfor a dataset — check_var_downloaded","text":"TRUE variable downloaded.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_in_nc.html","id":null,"dir":"Reference","previous_headings":"","what":"Check whether variables exist in a netcdf file — check_var_in_nc","title":"Check whether variables exist in a netcdf file — check_var_in_nc","text":"Internal function test custom nc file.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_in_nc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check whether variables exist in a netcdf file — check_var_in_nc","text":"","code":"check_var_in_nc(bio_variables, path_to_nc)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_in_nc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check whether variables exist in a netcdf file — check_var_in_nc","text":"bio_variables vector names variables extracted path_to_nc path custom nc file containing palaeoclimate reconstructions.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/check_var_in_nc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check whether variables exist in a netcdf file — check_var_in_nc","text":"TRUE variable exists","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/clean_data_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Clean the data path — clean_data_path","title":"Clean the data path — clean_data_path","text":"function deletes old reconstructions superseded data_path. assumes files data_path part pastclim (.e. custom datasets stored directory).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/clean_data_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Clean the data path — clean_data_path","text":"","code":"clean_data_path(ask = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/clean_data_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Clean the data path — clean_data_path","text":"ask boolean whether user asked deleting","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/clean_data_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Clean the data path — clean_data_path","text":"TRUE files deleted successfully","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_locations.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","title":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","text":"Deprecated version location_slice() Deprecated version location_slice()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_locations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","text":"","code":"climate_for_locations(...)  climate_for_locations(...)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_locations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","text":"... arguments passed location_slice()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_locations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract local climate for one or more locations for a given time slice. — climate_for_locations","text":"data.frame climatic variables interest data.frame climatic variables interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_time_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a climate slice for a region — climate_for_time_slice","title":"Extract a climate slice for a region — climate_for_time_slice","text":"Deprecated version region_slice()]","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_time_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a climate slice for a region — climate_for_time_slice","text":"","code":"climate_for_time_slice(...)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_time_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a climate slice for a region — climate_for_time_slice","text":"... arguments passed region_slice()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/climate_for_time_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a climate slice for a region — climate_for_time_slice","text":"SpatRaster terra::SpatRaster object, variable layer.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/copy_example_data.html","id":null,"dir":"Reference","previous_headings":"","what":"Internal function to copy the example dataset when a new data path is set — copy_example_data","title":"Internal function to copy the example dataset when a new data path is set — copy_example_data","text":"Copy example dataset","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/copy_example_data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Internal function to copy the example dataset when a new data path is set — copy_example_data","text":"","code":"copy_example_data()"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/copy_example_data.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Internal function to copy the example dataset when a new data path is set — copy_example_data","text":"TRUE data copied successfully","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract data frame from a region series — df_from_region_series","title":"Extract data frame from a region series — df_from_region_series","text":"Extract climatic information region series organise data frame.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract data frame from a region series — df_from_region_series","text":"","code":"df_from_region_series(x, xy = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract data frame from a region series — df_from_region_series","text":"x climate time series generated region_series() xy boolean whether x y coordinates added dataframe (default TRUE)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract data frame from a region series — df_from_region_series","text":"data.frame cell raster layer (.e. timestep) row, available variables columns.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_series.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Extract data frame from a region series — df_from_region_series","text":"extract data frame region slice, see df_from_region_slice().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract data frame from a region slice — df_from_region_slice","title":"Extract data frame from a region slice — df_from_region_slice","text":"Extract climatic information region slice organise data frame. just wrapper around terra::.data.frame().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract data frame from a region slice — df_from_region_slice","text":"","code":"df_from_region_slice(x, xy = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract data frame from a region slice — df_from_region_slice","text":"x climate time slice (.e. terra::SpatRaster) generated region_slice() xy boolean whether x y coordinates added dataframe (default TRUE)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract data frame from a region slice — df_from_region_slice","text":"data.frame cell raster row, available variables columns.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/df_from_region_slice.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Extract data frame from a region slice — df_from_region_slice","text":"extract data frame region series, see df_from_region_series().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/distance_from_sea.html","id":null,"dir":"Reference","previous_headings":"","what":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","title":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","text":"Get land mask dataset given time point, compute distance sea land pixel.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/distance_from_sea.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","text":"","code":"distance_from_sea(time_bp = NULL, time_ce = NULL, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/distance_from_sea.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","text":"time_bp time slice years present (negative) time_ce time slice years CE. one time_bp time_ce used. dataset string defining dataset use (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/distance_from_sea.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Compute a raster of distances from the sea for each land pixel. — distance_from_sea","text":"terra::SpatRaster distances coastline km","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":null,"dir":"Reference","previous_headings":"","what":"Coefficient of variables (expressed as percentage) — .cv","title":"Coefficient of variables (expressed as percentage) — .cv","text":"R function compute coefficient variation (expressed percentage). single value, stats::sd = NA. However, one argue cv =0; NA may break code receives . function returns 0 mean close zero.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Coefficient of variables (expressed as percentage) — .cv","text":"","code":".cv(x)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Coefficient of variables (expressed as percentage) — .cv","text":"x vector values","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Coefficient of variables (expressed as percentage) — .cv","text":"cv","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/dot-cv.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Coefficient of variables (expressed as percentage) — .cv","text":"ODD: abs avoid small (zero) mean e.g. -5:5","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":null,"dir":"Reference","previous_headings":"","what":"Download the CHELSA modern observations. — download_chelsa","title":"Download the CHELSA modern observations. — download_chelsa","text":"function downloads monthly variables CHELSA 2.1 dataset. variables saved format can read load_chelsa, easily used delta downscaling palaeoclimate observations.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download the CHELSA modern observations. — download_chelsa","text":"","code":"download_chelsa(var, res, path = NULL, version = \"2.1\", ...)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download the CHELSA modern observations. — download_chelsa","text":"var character Valid variables names \"tas\", \"tasmax\",\"tasmin\", \"prec\". path character. Path download data . left NULL, data downloaded directory returned get_data_path().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download the CHELSA modern observations. — download_chelsa","text":"TRUE requested CHELSA variable downloaded successfully.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_chelsa.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download the CHELSA modern observations. — download_chelsa","text":"Note variables named differently WorldClim. \"tas\" mean temperature (\"tavg\" WorldClim), \"tasmax\" \"tasmin\" equivalent \"tmax\" \"tmin\".","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Download palaeoclimate reconstructions. — download_dataset","title":"Download palaeoclimate reconstructions. — download_dataset","text":"function downloads palaeoclimate reconstructions. Files stored data path pastclim, can inspected get_data_path() changed set_data_path()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download palaeoclimate reconstructions. — download_dataset","text":"","code":"download_dataset(dataset, bio_variables = NULL, annual = TRUE, monthly = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download palaeoclimate reconstructions. — download_dataset","text":"dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets. bio_variables one variable names downloaded. left NULL, variables available dataset downloaded (parameters annual monthly, see , define types) annual boolean download annual variables monthly boolean download monthly variables","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download palaeoclimate reconstructions. — download_dataset","text":"TRUE dataset(s) downloaded correctly.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_etopo.html","id":null,"dir":"Reference","previous_headings":"","what":"Download the ETOPO Global relief model — download_etopo","title":"Download the ETOPO Global relief model — download_etopo","text":"function downloads ETOPO2022 global relief model 30 60 arcsecs resolution. large file (>1Gb), worth downloading planning use repeatedly.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_etopo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download the ETOPO Global relief model — download_etopo","text":"","code":"download_etopo(path = NULL, resolution = 60)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_etopo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download the ETOPO Global relief model — download_etopo","text":"path character. Path download data . left NULL, data downloaded directory returned get_data_path(), automatically named \"etopo2022_resolutions_v1.nc\" resolution numeric resolution arcsecs (one 30, 60). Defaults 60 arcsecs.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_etopo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download the ETOPO Global relief model — download_etopo","text":"dataframe produced curl::multi_download() information download (including error codes)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_future.html","id":null,"dir":"Reference","previous_headings":"","what":"Download a WorldClim future predictions. — download_worldclim_future","title":"Download a WorldClim future predictions. — download_worldclim_future","text":"function downloads annual monthly variables WorldClim 2.1 predictions future.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_future.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download a WorldClim future predictions. — download_worldclim_future","text":"","code":"download_worldclim_future(dataset, bio_var, filename)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_future.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download a WorldClim future predictions. — download_worldclim_future","text":"dataset name dataset bio_var variable name filename file name (full path) file saved","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_future.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download a WorldClim future predictions. — download_worldclim_future","text":"TRUE requested WorldClim variable downloaded successfully","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_present.html","id":null,"dir":"Reference","previous_headings":"","what":"Download a WorldClim modern observations. — download_worldclim_present","title":"Download a WorldClim modern observations. — download_worldclim_present","text":"function downloads annual monthly variables WorldClim 2.1 dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_present.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download a WorldClim modern observations. — download_worldclim_present","text":"","code":"download_worldclim_present(dataset, bio_var, filename)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_present.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download a WorldClim modern observations. — download_worldclim_present","text":"dataset name dataset bio_var variable name filename file name (full path) file saved","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/download_worldclim_present.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download a WorldClim modern observations. — download_worldclim_present","text":"TRUE requested WorldClim variable downloaded successfully","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_available_datasets.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the available datasets. — get_available_datasets","title":"Get the available datasets. — get_available_datasets","text":"List datasets available pastclim, can passed functions pastclim values parameter dataset. functions can also used custom datasets setting dataset=\"custom\"","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_available_datasets.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the available datasets. — get_available_datasets","text":"","code":"get_available_datasets()"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_available_datasets.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the available datasets. — get_available_datasets","text":"character vector available datasets","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_available_datasets.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get the available datasets. — get_available_datasets","text":"function provides user-friendly list, summarising many datasets available WorldClim. comprehensive list available datasets can obtained list_available_datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_biome_classes.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the biome classes for a dataset. — get_biome_classes","title":"Get the biome classes for a dataset. — get_biome_classes","text":"Get full list biomes id coded biome variable given dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_biome_classes.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the biome classes for a dataset. — get_biome_classes","text":"","code":"get_biome_classes(dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_biome_classes.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the biome classes for a dataset. — get_biome_classes","text":"dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_biome_classes.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the biome classes for a dataset. — get_biome_classes","text":"data.frame columns id category.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the data path where climate reconstructions are stored — get_data_path","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"function returns path climate reconstructions stored.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"","code":"get_data_path(silent = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"silent boolean whether message returned data_path set (.e. equal NULL)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"data path","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_data_path.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Get the data path where climate reconstructions are stored — get_data_path","text":"path stored option pastclim named data_path. configuration file saved using set_data_path(), path retrieved file named \"pastclim_data.txt\", found directory returned tools::R_user_dir(\"pastclim\",\"config\") (.e. default configuration directory package set R >= 4.0).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_dataset_info.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the information about a dataset — get_dataset_info","title":"Get the information about a dataset — get_dataset_info","text":"function provides full information given dataset. full list datasets available pastclim can obtained list_available_datasets()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_dataset_info.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the information about a dataset — get_dataset_info","text":"","code":"get_dataset_info(dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_dataset_info.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the information about a dataset — get_dataset_info","text":"dataset dataset pastclim","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_dataset_info.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the information about a dataset — get_dataset_info","text":"text describing dataset","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_downloaded_datasets.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the variables downloaded for each dataset. — get_downloaded_datasets","title":"Get the variables downloaded for each dataset. — get_downloaded_datasets","text":"List downloaded variable dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_downloaded_datasets.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the variables downloaded for each dataset. — get_downloaded_datasets","text":"","code":"get_downloaded_datasets(data_path = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_downloaded_datasets.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the variables downloaded for each dataset. — get_downloaded_datasets","text":"data_path leave NULL use default data_path","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_downloaded_datasets.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the variables downloaded for each dataset. — get_downloaded_datasets","text":"list variable names per dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_file_for_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the file details for a variable and dataset. — get_file_for_dataset","title":"Get the file details for a variable and dataset. — get_file_for_dataset","text":"Internal getter function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_file_for_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the file details for a variable and dataset. — get_file_for_dataset","text":"","code":"get_file_for_dataset(variable, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_file_for_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the file details for a variable and dataset. — get_file_for_dataset","text":"variable one variable names downloaded dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_file_for_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the file details for a variable and dataset. — get_file_for_dataset","text":"filename variable dataset","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_ice_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the ice mask for a dataset. — get_ice_mask","title":"Get the ice mask for a dataset. — get_ice_mask","text":"Get ice mask dataset, either whole series specific time points.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_ice_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the ice mask for a dataset. — get_ice_mask","text":"","code":"get_ice_mask(time_bp = NULL, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_ice_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the ice mask for a dataset. — get_ice_mask","text":"time_bp time slices years present (negative values represent time present, positive values time future). parameter can vector times (slices need exist dataset), list min max element setting range values, left NULL retrieve time steps. check slices available, can use get_time_bp_steps(). dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_ice_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the ice mask for a dataset. — get_ice_mask","text":"binary terra::SpatRaster ice mask 1s","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_land_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Get the land mask for a dataset. — get_land_mask","title":"Get the land mask for a dataset. — get_land_mask","text":"Get land mask dataset, either whole series specific time points.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_land_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get the land mask for a dataset. — get_land_mask","text":"","code":"get_land_mask(time_bp = NULL, time_ce = NULL, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_land_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get the land mask for a dataset. — get_land_mask","text":"time_bp time slices years present (negative values represent time present, positive values time future). parameter can vector times (slices need exist dataset), list min max element setting range values, left NULL retrieve time steps. check slices available, can use get_time_bp_steps(). time_ce time years CE alternative time_bp.one time_bp time_ce used. available time slices years CE, use get_time_ce_steps(). dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_land_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get the land mask for a dataset. — get_land_mask","text":"binary terra::SpatRaster land mask 1s","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_mis_time_steps.html","id":null,"dir":"Reference","previous_headings":"","what":"Get time steps for a given MIS — get_mis_time_steps","title":"Get time steps for a given MIS — get_mis_time_steps","text":"Get time steps available given dataset MIS.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_mis_time_steps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get time steps for a given MIS — get_mis_time_steps","text":"","code":"get_mis_time_steps(mis, dataset, path_to_nc = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_mis_time_steps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get time steps for a given MIS — get_mis_time_steps","text":"mis string giving mis; must use spelling used mis_boundaries dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_mis_time_steps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get time steps for a given MIS — get_mis_time_steps","text":"vector time steps","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_sea_level.html","id":null,"dir":"Reference","previous_headings":"","what":"Get sea level estimate — get_sea_level","title":"Get sea level estimate — get_sea_level","text":"function returns estimated sea level Spratt et al. 2016, using long PC1. Sea levels contemporary sea level (note original data reference sea level Holocene ~5k year ago).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_sea_level.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get sea level estimate — get_sea_level","text":"","code":"get_sea_level(time_bp)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_sea_level.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get sea level estimate — get_sea_level","text":"time_bp time interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_sea_level.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get sea level estimate — get_sea_level","text":"vector sea levels meters present level","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_time_bp_steps.html","id":null,"dir":"Reference","previous_headings":"","what":"Get time steps for a given dataset — get_time_bp_steps","title":"Get time steps for a given dataset — get_time_bp_steps","text":"Get time steps (time_bp time_ce) available given dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_time_bp_steps.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get time steps for a given dataset — get_time_bp_steps","text":"","code":"get_time_bp_steps(dataset, path_to_nc = NULL)  get_time_ce_steps(dataset, path_to_nc = NULL)  get_time_steps(dataset, path_to_nc = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_time_bp_steps.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get time steps for a given dataset — get_time_bp_steps","text":"dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_time_bp_steps.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get time steps for a given dataset — get_time_bp_steps","text":"vector time steps (time_bp, time_ce)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_varname.html","id":null,"dir":"Reference","previous_headings":"","what":"Get a the varname for this variable — get_varname","title":"Get a the varname for this variable — get_varname","text":"Internal function get varname variable","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_varname.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get a the varname for this variable — get_varname","text":"","code":"get_varname(variable, dataset)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_varname.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get a the varname for this variable — get_varname","text":"variable string defining variable name dataset string defining dataset downloaded","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_varname.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get a the varname for this variable — get_varname","text":"name variable","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_vars_for_dataset.html","id":null,"dir":"Reference","previous_headings":"","what":"Get a list of variables for a given dataset. — get_vars_for_dataset","title":"Get a list of variables for a given dataset. — get_vars_for_dataset","text":"function lists variables available given dataset. Note spelling use capitals names might differ original publications, pastclim harmonises names variables across different reconstructions.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_vars_for_dataset.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Get a list of variables for a given dataset. — get_vars_for_dataset","text":"","code":"get_vars_for_dataset(   dataset,   path_to_nc = NULL,   details = FALSE,   annual = TRUE,   monthly = FALSE )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_vars_for_dataset.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Get a list of variables for a given dataset. — get_vars_for_dataset","text":"dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). path_to_nc path custom nc file containing palaeoclimate reconstructions. custom nc file given, 'details', 'annual' 'monthly' ignored details boolean determining whether output include information including long names variables units. annual boolean show annual variables monthly boolean show monthly variables","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/get_vars_for_dataset.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Get a list of variables for a given dataset. — get_vars_for_dataset","text":"vector variable names","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/help_console.html","id":null,"dir":"Reference","previous_headings":"","what":"Print help to console — help_console","title":"Print help to console — help_console","text":"function prints help file console. based function published R-bloggers: https://www.r-bloggers.com/2013/06/printing-r-help-files---console---knitr-documents/","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/help_console.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Print help to console — help_console","text":"","code":"help_console(   topic,   format = c(\"text\", \"html\", \"latex\"),   lines = NULL,   before = NULL,   after = NULL )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/help_console.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Print help to console — help_console","text":"topic topic help format output formatted string printed output string printed output lines printed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/help_console.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Print help to console — help_console","text":"text help file","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Check the object is a valid region series — is_region_series","title":"Check the object is a valid region series — is_region_series","text":"region series terra::SpatRasterDataset sub-dataset variable, variables number time steps.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check the object is a valid region series — is_region_series","text":"","code":"is_region_series(x, strict = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check the object is a valid region series — is_region_series","text":"x terra::SpatRasterDataset representing time series regional reconstructions obtained region_series(). strict boolean defining whether preform thorough test (see description details).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check the object is a valid region series — is_region_series","text":"TRUE object region series","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/is_region_series.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Check the object is a valid region series — is_region_series","text":"standard test checks sub-datasets (terra::SpatRaster) number layers. thorough test (obtained strict=TRUE) actually checks variables identical time steps comparing result terra::time() applied variable.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/list_available_datasets.html","id":null,"dir":"Reference","previous_headings":"","what":"List all the available datasets. — list_available_datasets","title":"List all the available datasets. — list_available_datasets","text":"List datasets available pastclim. list comprehensive, includes combinations models future scenarios WorldClim. user-friendly list, use get_available_datasets(). functions can also used custom datasets setting dataset=\"custom\"","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/list_available_datasets.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"List all the available datasets. — list_available_datasets","text":"","code":"list_available_datasets()"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/list_available_datasets.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"List all the available datasets. — list_available_datasets","text":"character vector available datasets","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_dataset_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Load the dataset list — load_dataset_list","title":"Load the dataset list — load_dataset_list","text":"function returns dataframe details variable available every dataset. defaults copy stored within package, checks case updated version stored 'dataset_list_included.csv' tools::R_user_dir(\"pastclim\",\"config\"). latter present, last column, named 'dataset_list_v', provides version table, advanced table used.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_dataset_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load the dataset list — load_dataset_list","text":"","code":"load_dataset_list(on_cran = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_dataset_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load the dataset list — load_dataset_list","text":"on_cran boolean make function run ci tests using tempdir","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_dataset_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Load the dataset list — load_dataset_list","text":"dataset list","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":null,"dir":"Reference","previous_headings":"","what":"Load the ETOPO global relief — load_etopo","title":"Load the ETOPO global relief — load_etopo","text":"function loads previously downloaded ETOPO 2022 global relief dataset, 30 60 arcsec resolution. save variables compatible format, use download_etopo().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Load the ETOPO global relief — load_etopo","text":"","code":"load_etopo(path = NULL, resolution = 60, version = \"1\")"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Load the ETOPO global relief — load_etopo","text":"path character. Path dataset stored. left NULL, data downloaded directory returned get_data_path() resolution numeric resolution arcsecs (one 30, 60). Defaults 60 arcsecs. version character numeric. ETOPO2022 version number. \"1\" supported moment","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Load the ETOPO global relief — load_etopo","text":"terra::SpatRaster relief","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/load_etopo.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Load the ETOPO global relief — load_etopo","text":"function assumes file name etopo2022_resolutions_v1.nc","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a time series of bioclimatic variables for one or more locations. — location_series","title":"Extract a time series of bioclimatic variables for one or more locations. — location_series","text":"function extract time series local climate set locations. Note function apply interpolation (opposed location_slice()). coastal location just falls water reconstructions, amend coordinates put firmly land.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a time series of bioclimatic variables for one or more locations. — location_series","text":"","code":"location_series(   x,   time_bp = NULL,   time_ce = NULL,   coords = NULL,   bio_variables,   dataset,   path_to_nc = NULL,   nn_interpol = FALSE,   buffer = FALSE,   directions = 8 )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a time series of bioclimatic variables for one or more locations. — location_series","text":"x data.frame columns x y coordinates (optional name column), vector cell numbers. See coords standard coordinate names, use custom ones. time_bp time slices years present (negative values represent time present, positive values time future). parameter can vector times (slices need exist dataset), list min max element setting range values, left NULL retrieve time steps. check slices available, can use get_time_bp_steps(). time_ce time slice years CE (see time_bp options). available time slices years CE, use get_time_ce_steps(). one time_bp time_ce used. coords vector length two giving names \"x\" \"y\" coordinates, found data. left NULL, function try guess columns based standard names c(\"x\", \"y\"), c(\"X\",\"Y\"), c(\"longitude\", \"latitude\"), c(\"lon\", \"lat\") bio_variables vector names variables extracted. dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file. nn_interpol boolean determining whether nearest neighbour interpolation used estimate climate cells lack information (.e. water ice). default, interpolation performed first ring nearest neighbours; climate available, NA returned location. number neighbours can changed argument directions. nn_interpol defaults FALSE (DIFFERENT location_slice(). buffer boolean determining whether variable returned mean buffer around focal cell. set TRUE, overrides nn_interpol (provides estimates buffer locations cells NA). buffer size determined argument directions. buffer defaults FALSE. directions character matrix indicate directions cells considered connected using nn_interpol buffer. following character values allowed: \"rook\" \"4\" horizontal vertical neighbours; \"bishop\" get diagonal neighbours; \"queen\" \"8\" get vertical, horizontal diagonal neighbours; \"16\" knight one-cell queen move neighbours. directions matrix odd dimensions logical (0, 1) values.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a time series of bioclimatic variables for one or more locations. — location_series","text":"data.frame climatic variables interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract local climate for one or more locations for a given time slice. — location_slice","title":"Extract local climate for one or more locations for a given time slice. — location_slice","text":"function extract local climate set locations appropriate times (selecting closest time slice available specific date associated location).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract local climate for one or more locations for a given time slice. — location_slice","text":"","code":"location_slice(   x,   time_bp = NULL,   time_ce = NULL,   coords = NULL,   bio_variables,   dataset,   path_to_nc = NULL,   nn_interpol = TRUE,   buffer = FALSE,   directions = 8 )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract local climate for one or more locations for a given time slice. — location_slice","text":"x data.frame columns x y coordinates(see coords standard coordinate names, use custom ones), plus optional columns time_bp time_ce (depending units used) name. Alternatively, vector cell numbers. time_bp used time_bp column present x: dates years present (negative values represent time present, .e. 1950, positive values time future) location. time_ce time years CE alternative time_bp.one time_bp time_ce used. coords vector length two giving names \"x\" \"y\" coordinates, found data. left NULL, function try guess columns based standard names c(\"x\", \"y\"), c(\"X\",\"Y\"), c(\"longitude\", \"latitude\"), c(\"lon\", \"lat\") bio_variables vector names variables extracted. dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file. nn_interpol boolean determining whether nearest neighbour interpolation used estimate climate cells lack information (.e. water ice). default, interpolation performed first ring nearest neighbours; climate available, NA returned location. number neighbours can changed argument directions. nn_interpol defaults TRUE. buffer boolean determining whether variable returned mean buffer around focal cell. set TRUE, overrides nn_interpol (provides estimates buffer locations cells NA). buffer size determined argument directions. buffer defaults FALSE. directions character matrix indicate directions cells considered connected using nn_interpol buffer. following character values allowed: \"rook\" \"4\" horizontal vertical neighbours; \"bishop\" get diagonal neighbours; \"queen\" \"8\" get vertical, horizontal diagonal neighbours; \"16\" knight one-cell queen move neighbours. directions matrix odd dimensions logical (0, 1) values.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract local climate for one or more locations for a given time slice. — location_slice","text":"data.frame climatic variables interest.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice_from_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","title":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","text":"function extract local climate set locations appropriate times (selecting closest time slice available specific date associated location).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice_from_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","text":"","code":"location_slice_from_region_series(   x,   time_bp = NULL,   time_ce = NULL,   coords = NULL,   region_series,   nn_interpol = TRUE,   buffer = FALSE,   directions = 8 )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice_from_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","text":"x data.frame columns x y coordinates(see coords standard coordinate names, use custom ones), plus optional columns time_bp time_ce (depending units used) name. Alternatively, vector cell numbers. time_bp used time_bp column present x: dates years present (negative values represent time present, .e. 1950, positive values time future) location. time_ce time years CE alternative time_bp.one time_bp time_ce used. coords vector length two giving names \"x\" \"y\" coordinates, found data. left NULL, function try guess columns based standard names c(\"x\", \"y\"), c(\"X\",\"Y\"), c(\"longitude\", \"latitude\"), c(\"lon\", \"lat\") region_series SpatRasterDataset obtained region_series() nn_interpol boolean determining whether nearest neighbour interpolation used estimate climate cells lack information (.e. water ice). default, interpolation performed first ring nearest neighbours; climate available, NA returned location. number neighbours can changed argument directions. nn_interpol defaults TRUE. buffer boolean determining whether variable returned mean buffer around focal cell. set TRUE, overrides nn_interpol (provides estimates buffer locations cells NA). buffer size determined argument directions. buffer defaults FALSE. directions character matrix indicate directions cells considered connected using nn_interpol buffer. following character values allowed: \"rook\" \"4\" horizontal vertical neighbours; \"bishop\" get diagonal neighbours; \"queen\" \"8\" get vertical, horizontal diagonal neighbours; \"16\" knight one-cell queen move neighbours. directions matrix odd dimensions logical (0, 1) values.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/location_slice_from_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract local climate for one or more locations for a given time slice. — location_slice_from_region_series","text":"data.frame climatic variables interest.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_binary_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a binary mask — make_binary_mask","title":"Create a binary mask — make_binary_mask","text":"Create binary mask raster: NAs converted 0s, value 1.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_binary_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a binary mask — make_binary_mask","text":"","code":"make_binary_mask(x)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_binary_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a binary mask — make_binary_mask","text":"x terra::SpatRaster","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_binary_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a binary mask — make_binary_mask","text":"terra::SpatRaster 0s 1s","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_ice_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Downscale an ice mask — make_ice_mask","title":"Downscale an ice mask — make_ice_mask","text":"Downscaling ice mask presents issues. mask binary raster, standard downscaling approach still look blocky. can smooth contour applying Gaussian filter. strong filter much matter personal opinion, data compare . function attempts use sensible default value, worth exploring alternative values find good solution.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_ice_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Downscale an ice mask — make_ice_mask","text":"","code":"make_ice_mask(ice_mask_low_res, land_mask_high_res, d = c(0.5, 3))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_ice_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Downscale an ice mask — make_ice_mask","text":"ice_mask_low_res terra::SpatRaster low resolution ice mask downscale (e.g. obtained get_ice_mask()) land_mask_high_res terra::SpatRaster land masks different times (e.g. obtained make_land_mask()). ice mask cropped matched resolution land mask.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_ice_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Downscale an ice mask — make_ice_mask","text":"terra::SpatRaster ice mask (1's), rest world (sea land) NA's","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_land_mask.html","id":null,"dir":"Reference","previous_headings":"","what":"Create a land mask — make_land_mask","title":"Create a land mask — make_land_mask","text":"Create land mask given time step. land mask based simple logic moving ocean given current relief profile ( topography+bathymetry, .e. elevation sea level). Note approach ignores rebound due changing mass distribution ice sheets. LIMITATIONS: land mask show internal lakes/seas land, level unrelated general sea level. specific reconstructions internal lakes (want simply reuse current extents), add onto masks generated function. Also note land mask include ice sheets. means areas permanently covered ice two poles show sea. means , reconstruction including Greenland Antarctica, resulting land mask need modified include appropriate ice sheets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_land_mask.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create a land mask — make_land_mask","text":"","code":"make_land_mask(relief_rast, time_bp, sea_level = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_land_mask.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create a land mask — make_land_mask","text":"relief_rast terra::SpatRaster relief time_bp time interest sea_level sea level time interest (left NULL, computed using Spratt 2016)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/make_land_mask.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create a land mask — make_land_mask","text":"terra::SpatRaster land masks (land 1's sea NAs), layers different times","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mis_boundaries.html","id":null,"dir":"Reference","previous_headings":"","what":"Time boundaries of marine isotope stages (MIS). — mis_boundaries","title":"Time boundaries of marine isotope stages (MIS). — mis_boundaries","text":"dataset containing beginning end MIS.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mis_boundaries.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Time boundaries of marine isotope stages (MIS). — mis_boundaries","text":"","code":"mis_boundaries"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mis_boundaries.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Time boundaries of marine isotope stages (MIS). — mis_boundaries","text":"data frame 24 rows 2 variables: mis stage, string start start given MIS, kya end start given MIS, kya","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mode.html","id":null,"dir":"Reference","previous_headings":"","what":"Mode — mode","title":"Mode — mode","text":"Find mode vector x (note , multiple values frequency, function simply picks first occurring one)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mode.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Mode — mode","text":"","code":"mode(x)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mode.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Mode — mode","text":"x vector","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/mode.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Mode — mode","text":"mode","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/pastclim.html","id":null,"dir":"Reference","previous_headings":"","what":"pastclim — pastclim","title":"pastclim — pastclim","text":"R library designed provide easy way extract manipulate palaeoclimate reconstructions ecological anthropological analyses.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/pastclim.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"pastclim — pastclim","text":"functionalities pastclim described Leonardi et al. (2023) doi:10.1111/ecog.06481 . Please cite use pastclim research. dedicated website, can find Articles giving step--step overview package, cheatsheet. also version site updated dev version (top left, version number red, format x.x.x.9xxx, indicating development version). pastclim currently includes data Beyer et al 2020, reconstruction climate based HadCM3 model last 120k years, Krapp et al 2021, covers last 800k years. reconstructions bias-corrected downscaled 0.5 degree. details datasets can found . also instructions build use custom datasets.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_extent.html","id":null,"dir":"Reference","previous_headings":"","what":"Region extents. — region_extent","title":"Region extents. — region_extent","text":"list extents major regions.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_extent.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Region extents. — region_extent","text":"","code":"region_extent"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_extent.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Region extents. — region_extent","text":"list vectors giving extents.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline.html","id":null,"dir":"Reference","previous_headings":"","what":"Region outlines. — region_outline","title":"Region outlines. — region_outline","text":"sf::sf object containing outlines major regions. Outlines span antimeridian split multiple polygons.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Region outlines. — region_outline","text":"","code":"region_outline"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Region outlines. — region_outline","text":"sf::sf outlines. name names regions","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline_union.html","id":null,"dir":"Reference","previous_headings":"","what":"Region outlines unioned. — region_outline_union","title":"Region outlines unioned. — region_outline_union","text":"sf::sf object containing outlines major regions. outline represented single polygon. want multiple polygons, use region_outline.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline_union.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Region outlines unioned. — region_outline_union","text":"","code":"region_outline_union"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_outline_union.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Region outlines unioned. — region_outline_union","text":"sf::sf outlines. name names regions","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a time series of climate variables for a region — region_series","title":"Extract a time series of climate variables for a region — region_series","text":"function extracts time series one climate variables given dataset covering region (whole world). function returns terra::SpatRasterDataset object, variable sub-dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a time series of climate variables for a region — region_series","text":"","code":"region_series(   time_bp = NULL,   time_ce = NULL,   bio_variables,   dataset,   path_to_nc = NULL,   ext = NULL,   crop = NULL )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a time series of climate variables for a region — region_series","text":"time_bp time slices years present (negative values represent time present, positive values time future). parameter can vector times (slices need exist dataset), list min max element setting range values, left NULL retrieve time steps. check slices available, can use get_time_bp_steps(). time_ce time slices years CE (see time_bp options). available time slices years CE, use get_time_ce_steps(). one time_bp time_ce used. bio_variables vector names variables extracted dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file. ext extent, coded numeric vector (length=4; order= xmin, xmax, ymin, ymax) terra::SpatExtent object. NULL, full extent reconstruction given. crop polygon used crop reconstructions (e.g. outline continental mass). sf::sfg terra::SpatVector object used define polygon.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a time series of climate variables for a region — region_series","text":"terra::SpatRasterDataset object, variable sub-dataset.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a climate slice for a region — region_slice","title":"Extract a climate slice for a region — region_slice","text":"function extracts slice one climate variables given dataset covering region (whole world). function returns SpatRaster terra::SpatRaster object, variable layer.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a climate slice for a region — region_slice","text":"","code":"region_slice(   time_bp = NULL,   time_ce = NULL,   bio_variables,   dataset,   path_to_nc = NULL,   ext = NULL,   crop = NULL )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a climate slice for a region — region_slice","text":"time_bp time slice years present (negative values represent time present, positive values time future). slice needs exist dataset. check slices available, can use get_time_bp_steps(). time_ce time slice years CE. available time slices years CE, use get_time_ce_steps(). one time_bp time_ce used. bio_variables vector names variables extracted dataset string defining dataset use. set \"custom\", single nc file used \"path_to_nc\" path_to_nc path custom nc file containing palaeoclimate reconstructions. variables interest need included file. ext extent, coded numeric vector (length=4; order= xmin, xmax, ymin, ymax) terra::SpatExtent object. NULL, full extent reconstruction given. crop polygon used crop reconstructions (e.g. outline continental mass). sf::sfg terra::SpatVector object used define polygon.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/region_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a climate slice for a region — region_slice","text":"SpatRaster terra::SpatRaster object, variable layer.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample points from a region time series — sample_region_series","title":"Sample points from a region time series — sample_region_series","text":"function samples points region time series. Sampling can either performed locations time steps (one value given size), different locations time step (size vector length equal number time steps). sample number points, different locations, time step, provide vector repeating value time step.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample points from a region time series — sample_region_series","text":"","code":"sample_region_series(x, size, method = \"random\", replace = FALSE, na.rm = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sample points from a region time series — sample_region_series","text":"x terra::SpatRasterDataset returned region_series() size number points sampled. single value used sample locations across time steps, vector values sample different locations time step. method one sampling methods terra::spatSample(). defaults \"random\" replace boolean determining whether sample replacement na.rm boolean determining whether NAs removed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sample points from a region time series — sample_region_series","text":"data.frame sampled cells respective values climate variables.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_series.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Sample points from a region time series — sample_region_series","text":"function wraps terra::spatSample() appropriate sample terra::SpatRasters terra::SpatRasterDataset returned region_series().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample points from a region time slice — sample_region_slice","title":"Sample points from a region time slice — sample_region_slice","text":"function samples points region time slice (.e. time point).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample points from a region time slice — sample_region_slice","text":"","code":"sample_region_slice(x, size, method = \"random\", replace = FALSE, na.rm = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sample points from a region time slice — sample_region_slice","text":"x terra::SpatRaster returned region_slice() size number points sampled. method one sampling methods terra::spatSample(). defaults \"random\" replace boolean determining whether sample replacement na.rm boolean determining whether NAs removed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sample points from a region time slice — sample_region_slice","text":"data.frame sampled cells respective values climate variables.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_region_slice.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Sample points from a region time slice — sample_region_slice","text":"function wraps terra::spatSample() appropriate sample terra::SpatRaster returned region_slice(). can also use terra::spatSample() directly slice (standard terra::SpatRaster).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_fixed.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample the same locations from a region time series — sample_rs_fixed","title":"Sample the same locations from a region time series — sample_rs_fixed","text":"Internal function fixed sampling sample_region_series(), used single size given.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_fixed.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample the same locations from a region time series — sample_rs_fixed","text":"","code":"sample_rs_fixed(x, size, method = \"random\", replace = FALSE, na.rm = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_fixed.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sample the same locations from a region time series — sample_rs_fixed","text":"x terra::SpatRasterDataset returned region_series() size number points sampled; locations across time steps method one sampling methods terra::spatSample(). defaults \"random\" replace boolean determining whether sample replacement na.rm boolean determining whether NAs removed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_fixed.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sample the same locations from a region time series — sample_rs_fixed","text":"data.frame sampled cells respective values climate variables.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_variable.html","id":null,"dir":"Reference","previous_headings":"","what":"Sample the different number of points from a region time series — sample_rs_variable","title":"Sample the different number of points from a region time series — sample_rs_variable","text":"Internal function sampling different number points timestep region series sample_region_series(), used size vector values.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_variable.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Sample the different number of points from a region time series — sample_rs_variable","text":"","code":"sample_rs_variable(x, size, method = \"random\", replace = FALSE, na.rm = TRUE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_variable.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Sample the different number of points from a region time series — sample_rs_variable","text":"x terra::SpatRasterDataset returned region_series() size vector number points sampled time step method one sampling methods terra::spatSample(). defaults \"random\" replace boolean determining whether sample replacement na.rm boolean determining whether NAs removed","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/sample_rs_variable.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Sample the different number of points from a region time series — sample_rs_variable","text":"data.frame sampled cells respective values climate variables.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/set_data_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Set the data path where climate reconstructions will be stored — set_data_path","title":"Set the data path where climate reconstructions will be stored — set_data_path","text":"function sets path climate reconstructions stored. information stored file names \"pastclim_data.txt\", found directory returned tools::R_user_dir(\"pastclim\",\"config\") (.e. default configuration directory package set R >= 4.0).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/set_data_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Set the data path where climate reconstructions will be stored — set_data_path","text":"","code":"set_data_path(   path_to_nc = NULL,   ask = TRUE,   write_config = TRUE,   copy_example = TRUE,   on_CRAN = FALSE )"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/set_data_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Set the data path where climate reconstructions will be stored — set_data_path","text":"path_to_nc path file contains downloaded reconstructions. left unset, default location returned tools::R_user_dir(\"pastclim\",\"data\") used ask boolean whether user asked confirm choices write_config boolean whether path saved config file copy_example boolean whether example dataset saved data_path on_CRAN boolean; users need parameters. used set data path temporary directory examples tests run CRAN.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/set_data_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Set the data path where climate reconstructions will be stored — set_data_path","text":"TRUE path set correctly","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/slice_region_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a slice for a time series of climate variables for a region — slice_region_series","title":"Extract a slice for a time series of climate variables for a region — slice_region_series","text":"function extracts time slice time series one climate variables given dataset covering region (whole world).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/slice_region_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a slice for a time series of climate variables for a region — slice_region_series","text":"","code":"slice_region_series(x, time_bp = NULL, time_ce = NULL)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/slice_region_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a slice for a time series of climate variables for a region — slice_region_series","text":"x climate time series generated region_series() time_bp time slice years present (.e. 1950, negative integers values past). slices need exist dataset. check slices available, can use time_bp(x). time_ce time slice years CE. one time_bp time_ce used.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/slice_region_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a slice for a time series of climate variables for a region — slice_region_series","text":"SpatRaster relevant slice.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","title":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","text":"functions extracts sets time years BP (.e. 1950) terra::SpatRaster  terra::SpatRasterDataset. terra::SpatRaster object, time stored unit \"years\", years 0AD. means , summary terra::SpatRaster inspected, times appear time_bp+1950. applies function terra::time() used instead time_bp().","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","text":"","code":"time_bp(x)  # S4 method for SpatRaster time_bp(x)  # S4 method for SpatRasterDataset time_bp(x)  time_bp(x) <- value  # S4 method for SpatRaster time_bp(x) <- value  # S4 method for SpatRasterDataset time_bp(x) <- value"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","text":"x terra::SpatRaster value numeric vector times years BP","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract and set time in years before present for SpatRaster and SpatRasterDataset — time_bp","text":"date years BP (negative numbers indicate date past)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_i_series.html","id":null,"dir":"Reference","previous_headings":"","what":"Convert a time BP to indexes for a series — time_bp_to_i_series","title":"Convert a time BP to indexes for a series — time_bp_to_i_series","text":"Internal function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_i_series.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Convert a time BP to indexes for a series — time_bp_to_i_series","text":"","code":"time_bp_to_i_series(time_bp, time_steps)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_i_series.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Convert a time BP to indexes for a series — time_bp_to_i_series","text":"time_bp vector times BP time_steps time steps reconstructions available","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_i_series.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Convert a time BP to indexes for a series — time_bp_to_i_series","text":"indeces relevant time steps","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Find the closest index to a given time in years BP — time_bp_to_index","title":"Find the closest index to a given time in years BP — time_bp_to_index","text":"Internal function","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Find the closest index to a given time in years BP — time_bp_to_index","text":"","code":"time_bp_to_index(time_bp, time_steps)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Find the closest index to a given time in years BP — time_bp_to_index","text":"time_bp vector times BP time_steps time steps reconstructions available","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_bp_to_index.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Find the closest index to a given time in years BP — time_bp_to_index","text":"indeces relevant time steps","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_series_for_locations.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","title":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","text":"Deprecated version location_series()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_series_for_locations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","text":"","code":"time_series_for_locations(...)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_series_for_locations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","text":"... arguments passed location_series()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/time_series_for_locations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract a time series of bioclimatic variables for one or more locations. — time_series_for_locations","text":"data.frame climatic variables interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/update_dataset_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Update the dataset list — update_dataset_list","title":"Update the dataset list — update_dataset_list","text":"newer dataset list (includes information files storing data pastclim), download start using 'dataset_list_included.csv' tools::R_user_dir(\"pastclim\",\"config\"). latter present, last column, named 'dataset_list_v', provides version table, advanced table used.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/update_dataset_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Update the dataset list — update_dataset_list","text":"","code":"update_dataset_list(on_cran = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/update_dataset_list.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Update the dataset list — update_dataset_list","text":"on_cran boolean make function run ci tests using tempdir","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/update_dataset_list.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Update the dataset list — update_dataset_list","text":"TRUE dataset updated","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/validate_nc.html","id":null,"dir":"Reference","previous_headings":"","what":"Validate an netcdf file for pastclim — validate_nc","title":"Validate an netcdf file for pastclim — validate_nc","text":"function validates netcdf file potential dataset pastclim. key checks : ) dimensions (longitude, latitude time) set correctly. b) variables appropriate metadata (longname units)","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/validate_nc.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Validate an netcdf file for pastclim — validate_nc","text":"","code":"validate_nc(path_to_nc)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/validate_nc.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Validate an netcdf file for pastclim — validate_nc","text":"path_to_nc path nc file interest","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/validate_nc.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Validate an netcdf file for pastclim — validate_nc","text":"TRUE file valid.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":null,"dir":"Reference","previous_headings":"","what":"Generate pretty variable labels for plotting — var_labels","title":"Generate pretty variable labels for plotting — var_labels","text":"Generate pretty labels (form expression) can used plotting","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Generate pretty variable labels for plotting — var_labels","text":"","code":"var_labels(x, dataset, with_units = TRUE, abbreviated = FALSE)"},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Generate pretty variable labels for plotting — var_labels","text":"x either character vector names variables, terra::SpatRaster generated [region_slice())] [region_slice())]: R:region_slice()) dataset string defining dataset downloaded (list possible values can obtained list_available_datasets()). function work custom datasets. with_units boolean defining whether label include units abbreviated boolean defining whether label use abbreviations variable","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Generate pretty variable labels for plotting — var_labels","text":"expression can used label plots","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/reference/var_labels.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Generate pretty variable labels for plotting — var_labels","text":"","code":"var_labels(\"bio01\", dataset = \"Example\") #> expression(\"annual mean temperature (\" * degree * C * \")\")  # set the data_path for this example to run on CRAN # users don't need to run this line set_data_path(on_CRAN = TRUE) #> [1] TRUE  # for a SpatRaster climate_20k <- region_slice( time_bp = -20000, bio_variables = c(\"bio01\", \"bio10\", \"bio12\"), dataset = \"Example\" ) terra::plot(climate_20k, main = var_labels(climate_20k, dataset = \"Example\"))  terra::plot(climate_20k, main = var_labels(climate_20k, dataset = \"Example\",                    abbreviated = TRUE))"},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-124","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.4","title":"pastclim 1.2.4","text":"CRAN release: 2023-04-25 Updates time handled stay sync changes terra.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-123","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.3","title":"pastclim 1.2.3","text":"CRAN release: 2023-01-06 Added lai Krapp2021 (variable now also present original OSF repository dataset). Change column names data.frame returned location_series() match location_slice() Allow interpolation nearest neighbours location_series(), allow buffer estimates returned location_*() functions.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-122","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.2","title":"pastclim 1.2.2","text":"Update Krapp2021 files make compatible terra now handles time. Users re-download datasets. Old files can removed clean_data_path()","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-121","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.1","title":"pastclim 1.2.1","text":"Small updates CRAN submission.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-120","dir":"Changelog","previous_headings":"","what":"pastclim 1.2.0","title":"pastclim 1.2.0","text":"Provide additional information variables units, create pretty labels plots. Names locations now stored automatically outputs. Update time handled work terra 1.6-41 (now imports units netcdf files).","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-110","dir":"Changelog","previous_headings":"","what":"pastclim 1.1.0","title":"pastclim 1.1.0","text":"Expand functionality handle time series regions; rename functions extract data regions locations make consistent. Old code still work, raise warning functions deprecated. Remove need pastclimData, now put data user dir returned R>=4.0.0. removes need re-downloading data upgrading R. Add monthly variables Beyer2020 Krapp2021.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-101","dir":"Changelog","previous_headings":"","what":"pastclim 1.0.1","title":"pastclim 1.0.1","text":"Fix bug information extracted just one location.","code":""},{"path":"https://evolecolgroup.github.io/pastclim/dev/news/index.html","id":"pastclim-100","dir":"Changelog","previous_headings":"","what":"pastclim 1.0.0","title":"pastclim 1.0.0","text":"Initial public release","code":""}]