---
title: "Reproducibility"
author: "Steffi LaZerte"
date: "2023-09-20"
output: rmarkdown::html_vignette
vignette: >
  %\VignetteIndexEntry{Reproducibility}
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteEncoding{UTF-8}
---



When using data from external sources it's a good idea to take note of when data
was downloaded, which version (if possible) and with what. 

Reproducibility with `weathercan` can be achieved by taking note (or better yet, 
compiling reports) with the following information:

1. Your computer information (and date)
    - R version
2. Specific information on packages you're using
    - Citations if presenting in papers/reports
3. The stations list version

For example:


```r
# Work
library(weathercan)
s <- stations_search("Winnipeg", normals_years = "current")
w <- weather_dl(s, interval = "month", start = "2021-01-01")

# Reproducibility
stations_meta()
citation('weathercan')
devtools::session_info() # Install devtools if you don't have it
```



```
## $ECCC_modified
## [1] "2023-01-24 23:30:00 UTC"
## 
## $weathercan_modified
## [1] "2023-09-20"
```

```
## To cite 'weathercan' in publications, please use:
## 
##   LaZerte, Stefanie E and Sam Albers (2018). weathercan: Download and format weather data from
##   Environment and Climate Change Canada. The Journal of Open Source Software 3(22):571.
##   doi:10.21105/joss.00571.
## 
## A BibTeX entry for LaTeX users is
## 
##   @Article{,
##     title = {{weathercan}: {D}ownload and format weather data from Environment and Climate Change Canada},
##     author = {Stefanie E LaZerte and Sam Albers},
##     journal = {The Journal of Open Source Software},
##     volume = {3},
##     number = {22},
##     pages = {571},
##     year = {2018},
##     url = {https://joss.theoj.org/papers/10.21105/joss.00571},
##   }
```

```
## ─ Session info ────────────────────────────────────────────────────────────────────────────────────────────────────
##  setting  value
##  version  R version 4.3.1 (2023-06-16)
##  os       Ubuntu 22.04.3 LTS
##  system   x86_64, linux-gnu
##  ui       RStudio
##  language en_CA:en
##  collate  en_CA.UTF-8
##  ctype    en_CA.UTF-8
##  tz       America/Winnipeg
##  date     2023-09-20
##  rstudio  2023.06.0+421 Mountain Hydrangea (desktop)
##  pandoc   3.1.1 @ /usr/lib/rstudio/resources/app/bin/quarto/bin/tools/ (via rmarkdown)
## 
## ─ Packages ────────────────────────────────────────────────────────────────────────────────────────────────────────
##  ! package      * version    date (UTC) lib source
##    assertthat     0.2.1      2019-03-21 [1] CRAN (R 4.3.0)
##    base64enc      0.1-3      2015-07-28 [1] CRAN (R 4.3.0)
##    bit            4.0.5      2022-11-15 [1] CRAN (R 4.3.0)
##    bit64          4.0.5      2020-08-30 [1] CRAN (R 4.3.0)
##    brio           1.1.3      2021-11-30 [1] CRAN (R 4.3.0)
##    bslib          0.5.0      2023-06-09 [1] CRAN (R 4.3.0)
##    cachem         1.0.8      2023-05-01 [1] CRAN (R 4.3.0)
##    callr          3.7.3      2022-11-02 [1] CRAN (R 4.3.0)
##    class          7.3-22     2023-05-03 [4] CRAN (R 4.3.1)
##    classInt       0.4-9      2023-02-28 [1] CRAN (R 4.3.0)
##    cli            3.6.1      2023-03-23 [1] CRAN (R 4.3.0)
##    clisymbols     1.2.0      2017-05-21 [1] CRAN (R 4.3.0)
##    codemetar      0.3.5      2022-09-02 [1] CRAN (R 4.3.1)
##    colorspace     2.1-0      2023-01-23 [1] CRAN (R 4.3.0)
##    covr           3.6.2      2023-03-25 [1] CRAN (R 4.3.0)
##    crayon         1.5.2      2022-09-29 [1] CRAN (R 4.3.0)
##    crul           1.4.0      2023-09-20 [1] https://ropensci.r-universe.dev (R 4.3.1)
##    curl           5.0.0      2023-01-12 [1] CRAN (R 4.3.0)
##    cyclocomp      1.1.0      2016-09-10 [1] CRAN (R 4.3.0)
##    DBI            1.1.3      2022-06-18 [1] CRAN (R 4.3.0)
##    desc           1.4.2      2022-09-08 [1] CRAN (R 4.3.0)
##    devtools       2.4.5      2022-10-11 [1] CRAN (R 4.3.0)
##    diffviewer     0.1.1      2021-09-30 [1] CRAN (R 4.3.1)
##    digest         0.6.31     2022-12-11 [1] CRAN (R 4.3.0)
##    dplyr        * 1.1.2      2023-04-20 [1] CRAN (R 4.3.0)
##    e1071          1.7-13     2023-02-01 [1] CRAN (R 4.3.0)
##    ellipsis       0.3.2      2021-04-29 [1] CRAN (R 4.3.0)
##    evaluate       0.20       2023-01-17 [1] CRAN (R 4.3.0)
##    fansi          1.0.4      2023-01-22 [1] CRAN (R 4.3.0)
##    farver         2.1.1      2022-07-06 [1] CRAN (R 4.3.0)
##    fastmap        1.1.1      2023-02-24 [1] CRAN (R 4.3.0)
##    fauxpas        0.5.2      2023-05-03 [1] CRAN (R 4.3.1)
##    fs             1.6.2      2023-04-25 [1] CRAN (R 4.3.0)
##    generics       0.1.3      2022-07-05 [1] CRAN (R 4.3.0)
##    ggplot2      * 3.4.2      2023-04-03 [1] CRAN (R 4.3.0)
##    glue         * 1.6.2      2022-02-24 [1] CRAN (R 4.3.0)
##    goodpractice   1.0.4      2022-08-30 [1] CRAN (R 4.3.0)
##    gtable         0.3.3      2023-03-21 [1] CRAN (R 4.3.0)
##    highr          0.10       2022-12-22 [1] CRAN (R 4.3.0)
##    hms            1.1.3      2023-03-21 [1] CRAN (R 4.3.0)
##    htmltools      0.5.5      2023-03-23 [1] CRAN (R 4.3.0)
##    htmlwidgets    1.6.2      2023-03-17 [1] CRAN (R 4.3.0)
##    httpcode       0.3.0      2020-04-10 [1] CRAN (R 4.3.0)
##    httpuv         1.6.9      2023-02-14 [1] CRAN (R 4.3.0)
##    httr           1.4.5      2023-02-24 [1] CRAN (R 4.3.0)
##    hunspell       3.0.2      2022-09-04 [1] CRAN (R 4.3.0)
##    jquerylib      0.1.4      2021-04-26 [1] CRAN (R 4.3.0)
##    jsonlite       1.8.4      2022-12-06 [1] CRAN (R 4.3.0)
##    KernSmooth     2.23-22    2023-07-10 [4] CRAN (R 4.3.1)
##    knitr        * 1.42       2023-01-25 [1] CRAN (R 4.3.0)
##    labeling       0.4.2      2020-10-20 [1] CRAN (R 4.3.0)
##    later          1.3.0      2021-08-18 [1] CRAN (R 4.3.0)
##    lazyeval       0.2.2      2019-03-15 [1] CRAN (R 4.3.0)
##    lifecycle      1.0.3      2022-10-07 [1] CRAN (R 4.3.0)
##    lintr          3.0.2      2022-10-19 [1] CRAN (R 4.3.0)
##    lubridate    * 1.9.2.9000 2023-09-20 [1] https://ropensci.r-universe.dev (R 4.3.1)
##    lutz           0.3.1      2019-07-19 [1] CRAN (R 4.3.0)
##    magrittr       2.0.3      2022-03-30 [1] CRAN (R 4.3.0)
##    memoise        2.0.1      2021-11-26 [1] CRAN (R 4.3.0)
##    mime           0.12       2021-09-28 [1] CRAN (R 4.3.0)
##    miniUI         0.1.1.1    2018-05-18 [1] CRAN (R 4.3.0)
##    munsell        0.5.0      2018-06-12 [1] CRAN (R 4.3.0)
##    pak            0.5.1      2023-04-27 [1] CRAN (R 4.3.0)
##    parsedate      1.3.1      2022-10-27 [1] CRAN (R 4.3.0)
##    pillar         1.9.0      2023-03-22 [1] CRAN (R 4.3.0)
##    pingr          2.0.2      2022-10-26 [1] CRAN (R 4.3.1)
##    pkgbuild       1.4.0      2022-11-27 [1] CRAN (R 4.3.0)
##    pkgconfig      2.0.3      2019-09-22 [1] CRAN (R 4.3.0)
##    pkgdown        2.0.7      2022-12-14 [1] CRAN (R 4.3.0)
##    pkgload        1.3.2      2022-11-16 [1] CRAN (R 4.3.0)
##    praise         1.0.0      2015-08-11 [1] CRAN (R 4.3.0)
##    prettyunits    1.1.1      2020-01-24 [1] CRAN (R 4.3.0)
##    processx       3.8.1      2023-04-18 [1] CRAN (R 4.3.0)
##    profvis        0.3.7      2020-11-02 [1] CRAN (R 4.3.0)
##    promises       1.2.0.1    2021-02-11 [1] CRAN (R 4.3.0)
##    proxy          0.4-27     2022-06-09 [1] CRAN (R 4.3.0)
##    ps             1.7.5      2023-04-18 [1] CRAN (R 4.3.0)
##    purrr          1.0.1      2023-01-10 [1] CRAN (R 4.3.0)
##    R6             2.5.1      2021-08-19 [1] CRAN (R 4.3.0)
##    rappdirs       0.3.3      2021-01-31 [1] CRAN (R 4.3.0)
##    rcmdcheck      1.4.0      2021-09-27 [1] CRAN (R 4.3.0)
##    Rcpp           1.0.10     2023-01-22 [1] CRAN (R 4.3.0)
##    readr        * 2.1.4      2023-02-10 [1] CRAN (R 4.3.0)
##    rematch        1.0.1      2016-04-21 [1] CRAN (R 4.3.0)
##    remotes        2.4.2      2021-11-30 [1] CRAN (R 4.3.0)
##    rex            1.2.1      2021-11-26 [1] CRAN (R 4.3.0)
##    rhub           1.1.2      2022-08-31 [1] CRAN (R 4.3.0)
##    rlang          1.1.1      2023-04-28 [1] CRAN (R 4.3.0)
##    rmarkdown      2.21       2023-03-26 [1] CRAN (R 4.3.0)
##    rprojroot      2.0.3      2022-04-02 [1] CRAN (R 4.3.0)
##    rstudioapi     0.14       2022-08-22 [1] CRAN (R 4.3.0)
##    rvest        * 1.0.3      2022-08-19 [1] CRAN (R 4.3.0)
##    s2             1.1.3      2023-04-27 [1] CRAN (R 4.3.0)
##    sass           0.4.5      2023-01-24 [1] CRAN (R 4.3.0)
##    scales         1.2.1      2022-08-20 [1] CRAN (R 4.3.0)
##    selectr        0.4-2      2019-11-20 [1] CRAN (R 4.3.0)
##    sessioninfo    1.2.2      2021-12-06 [1] CRAN (R 4.3.0)
##    sf             1.0-12     2023-03-19 [1] CRAN (R 4.3.0)
##    shiny        * 1.7.4      2022-12-15 [1] CRAN (R 4.3.0)
##    spelling       2.2.1      2023-03-22 [1] CRAN (R 4.3.0)
##    stringi        1.7.12     2023-01-11 [1] CRAN (R 4.3.0)
##    stringr      * 1.5.0      2022-12-02 [1] CRAN (R 4.3.0)
##    testthat     * 3.1.7      2023-03-12 [1] CRAN (R 4.3.0)
##    tibble         3.2.1      2023-03-20 [1] CRAN (R 4.3.0)
##    tidyr        * 1.3.0      2023-01-24 [1] CRAN (R 4.3.0)
##    tidyselect     1.2.0      2022-10-10 [1] CRAN (R 4.3.0)
##    timechange     0.2.0      2023-01-11 [1] CRAN (R 4.3.0)
##    triebeard      0.4.1      2023-03-04 [1] CRAN (R 4.3.0)
##    tzdb           0.3.0      2022-03-28 [1] CRAN (R 4.3.0)
##    units          0.8-2      2023-04-27 [1] CRAN (R 4.3.0)
##    urlchecker     1.0.1      2021-11-30 [1] CRAN (R 4.3.0)
##    urltools       1.7.3      2019-04-14 [1] CRAN (R 4.3.0)
##    usethis        2.2.0      2023-06-06 [1] CRAN (R 4.3.0)
##    utf8           1.2.3      2023-01-31 [1] CRAN (R 4.3.0)
##    uuid           1.1-0      2022-04-19 [1] CRAN (R 4.3.0)
##    vcr          * 1.2.2.91   2023-09-20 [1] https://ropensci.r-universe.dev (R 4.3.1)
##    vctrs          0.6.2      2023-04-19 [1] CRAN (R 4.3.0)
##    vroom          1.6.3      2023-04-28 [1] CRAN (R 4.3.0)
##  P weathercan   * 0.7.0.9000 2023-09-20 [?] load_all()
##    webmockr       0.9.0      2023-02-28 [1] CRAN (R 4.3.1)
##    whisker        0.4.1      2022-12-05 [1] CRAN (R 4.3.0)
##    whoami         1.3.0      2019-03-19 [1] CRAN (R 4.3.0)
##    withr          2.5.0      2022-03-03 [1] CRAN (R 4.3.0)
##    wk             0.7.3.9000 2023-07-26 [1] Github (paleolimbot/wk@2e38352)
##    xfun           0.39       2023-04-20 [1] CRAN (R 4.3.0)
##    xml2           1.3.4      2023-04-27 [1] CRAN (R 4.3.0)
##    xmlparsedata   1.0.5      2021-03-06 [1] CRAN (R 4.3.0)
##    xopen          1.0.0      2018-09-17 [1] CRAN (R 4.3.0)
##    xtable         1.8-4      2019-04-21 [1] CRAN (R 4.3.0)
##    yaml           2.3.7      2023-01-23 [1] CRAN (R 4.3.0)
## 
##  [1] /home/steffi/R/x86_64-pc-linux-gnu-library/4.3
##  [2] /usr/local/lib/R/site-library
##  [3] /usr/lib/R/site-library
##  [4] /usr/lib/R/library
## 
##  P ── Loaded and on-disk path mismatch.
## 
## ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────
```
