---
title: "Reproducibility"
author: "Steffi LaZerte"
date: "2025-03-03"
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] "2025-02-03 23:30:00 UTC"
## 
## $weathercan_modified
## [1] "2025-02-28"
```

```
## 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.4.3 (2025-02-28 ucrt)
##  os       Windows 10 x64 (build 19045)
##  system   x86_64, mingw32
##  ui       RTerm
##  language (EN)
##  collate  English_United States.utf8
##  ctype    English_United States.utf8
##  tz       America/Chicago
##  date     2025-03-03
##  pandoc   2.18 @ C:\\Users\\rrjal\\AppData\\Local\\Pandoc\\pandoc.exe
##  quarto   NA
## 
## ─ Packages ─────────────────────────────────────────────────────────────
##  package     * version date (UTC) lib source
##  cachem        1.1.0   2024-05-16 [1] CRAN (R 4.4.2)
##  cli           3.6.4   2025-02-13 [1] CRAN (R 4.4.2)
##  devtools      2.4.5   2022-10-11 [1] CRAN (R 4.4.2)
##  digest        0.6.37  2024-08-19 [1] CRAN (R 4.4.2)
##  dplyr         1.1.4   2023-11-17 [1] CRAN (R 4.4.2)
##  ellipsis      0.3.2   2021-04-29 [1] CRAN (R 4.4.2)
##  evaluate      1.0.3   2025-01-10 [1] CRAN (R 4.4.2)
##  fastmap       1.2.0   2024-05-15 [1] CRAN (R 4.4.2)
##  fs            1.6.5   2024-10-30 [1] CRAN (R 4.4.2)
##  generics      0.1.3   2022-07-05 [1] CRAN (R 4.4.2)
##  glue          1.8.0   2024-09-30 [1] CRAN (R 4.4.2)
##  hms           1.1.3   2023-03-21 [1] CRAN (R 4.4.2)
##  htmltools     0.5.8.1 2024-04-04 [1] CRAN (R 4.4.2)
##  htmlwidgets   1.6.4   2023-12-06 [1] CRAN (R 4.4.2)
##  httpuv        1.6.15  2024-03-26 [1] CRAN (R 4.4.2)
##  knitr         1.49    2024-11-08 [1] CRAN (R 4.4.2)
##  later         1.4.1   2024-11-27 [1] CRAN (R 4.4.2)
##  lifecycle     1.0.4   2023-11-07 [1] CRAN (R 4.4.2)
##  magrittr      2.0.3   2022-03-30 [1] CRAN (R 4.4.2)
##  memoise       2.0.1   2021-11-26 [1] CRAN (R 4.4.2)
##  mime          0.12    2021-09-28 [1] CRAN (R 4.4.0)
##  miniUI        0.1.1.1 2018-05-18 [1] CRAN (R 4.4.2)
##  pillar        1.10.1  2025-01-07 [1] CRAN (R 4.4.2)
##  pkgbuild      1.4.6   2025-01-16 [1] CRAN (R 4.4.2)
##  pkgconfig     2.0.3   2019-09-22 [1] CRAN (R 4.4.2)
##  pkgload       1.4.0   2024-06-28 [1] CRAN (R 4.4.2)
##  profvis       0.4.0   2024-09-20 [1] CRAN (R 4.4.2)
##  promises      1.3.2   2024-11-28 [1] CRAN (R 4.4.2)
##  purrr         1.0.4   2025-02-05 [1] CRAN (R 4.4.2)
##  R6            2.6.1   2025-02-15 [1] CRAN (R 4.4.2)
##  rappdirs      0.3.3   2021-01-31 [1] CRAN (R 4.4.2)
##  Rcpp          1.0.14  2025-01-12 [1] CRAN (R 4.4.2)
##  readr         2.1.5   2024-01-10 [1] CRAN (R 4.4.2)
##  remotes       2.5.0   2024-03-17 [1] CRAN (R 4.4.2)
##  rlang         1.1.5   2025-01-17 [1] CRAN (R 4.4.2)
##  sessioninfo   1.2.3   2025-02-05 [1] CRAN (R 4.4.2)
##  shiny         1.10.0  2024-12-14 [1] CRAN (R 4.4.2)
##  tibble        3.2.1   2023-03-20 [1] CRAN (R 4.4.2)
##  tidyselect    1.2.1   2024-03-11 [1] CRAN (R 4.4.2)
##  tzdb          0.4.0   2023-05-12 [1] CRAN (R 4.4.2)
##  urlchecker    1.0.1   2021-11-30 [1] CRAN (R 4.4.2)
##  usethis       3.1.0   2024-11-26 [1] CRAN (R 4.4.2)
##  vctrs         0.6.5   2023-12-01 [1] CRAN (R 4.4.2)
##  weathercan  * 0.7.3   2025-02-12 [1] https://ropensci.r-universe.dev (R 4.4.2)
##  xfun          0.51    2025-02-19 [1] CRAN (R 4.4.2)
##  xtable        1.8-4   2019-04-21 [1] CRAN (R 4.4.2)
## 
##  [1] C:/Users/rrjal/AppData/Local/R/win-library/4.4
##  [2] C:/Program Files/R/R-4.4.3/library
##  * ── Packages attached to the search path.
## 
## ────────────────────────────────────────────────────────────────────────
```
