# available datasets

## Overview of datasets available in `pastclim`

A number of datasets are available in pastclim. It is possible to use custom datasets as long as they are properly formatted (look at the article on how to format custom datasets if you are interested). It is possible to get a list of all available datasets with:

    library(pastclim)

    get_available_datasets()
    #> [1] "Example"   "Beyer2020" "Krapp2021"

For each dataset, you can get detailed information using the help function:

    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.

Here we provide the full documentation for each dataset (sorted in alphabetical order):

    #> 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
    #>      <https://doi.org/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:
    #>
    #>      <https://www.marineregions.org/gazetteer.php?p=details&id=4278>
    #>
    #>      <https://www.marineregions.org/gazetteer.php?p=details&id=4282>
    #>
    #>      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 <https://pubs.usgs.gov/ds/691/ds691.pdf>
    #>
    #>      Changelog
    #>
    #>      v1.1.0 Added monthly variables. Files can be downloaded from:
    #>      <https://zenodo.org/deposit/7062281>
    #>
    #>      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
    #>      <https://doi.org/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
    #>      <https://doi.org/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
    #>      <https://pubs.usgs.gov/ds/691/ds691.pdf>
    #>
    #>      Changelog
    #>
    #>      v1.1.0 Added monthly variables. Files can be downloaded from:
    #>      <https://zenodo.org/record/7065055>
    #>
    #>      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
    #>      <https://doi.org/doi.org/10.6084/m9.figshare.19733680.v1>
    #>
    #>
    #> #######################################################