Gestió de Projectes en R (1) amb git i renv | |
|
Curs R Avançat Equips - Sessió 2 | |
Avui | |
| |
1. Apunts Feina reproduïble amb R i renv | |
|
| |
2. Introduction - the problems (i) | ||||||
|
| ||||||
2.1. The problems (ii) | ||||||
|
| ||||||
2.2. The problems (iii) | ||||||
|
| ||||||
2.3. The problems (iv) | ||||||
|
| ||||||
2.4. The problem (v) | |||
|
| |||
2.5. The problem (vi) | ||||||
|
| ||||||
3. Enemies of reproducibility & adaptability | |
|
Enemies of reproducibility and adaptability (in levels): Changes / Evolution / Versions!
| |
4. Reproducibility & Adaptability | ||||||||||||||
|
How to avoid reproducibility & adaptability enemies (in R & Python for Data Science):
| ||||||||||||||
5. Reproducibility & Adaptability - Example in Posit Cloud | |
|
Example in https://posit.cloud (former RStudio Server Pro) :
| |
5.1. Level 1: Virtual Machines or Containers | |
5.2. Level 2: RStudio-Posit Workbench | |
|
| |
5.3. Level 3: renv - for packages | |||
|
Version control in work "environments"
| |||
5.3.1. Virtual environments in R with renv | |
|
| |
5.3.2. From utils: : sessionInfo() to renv: : snapshot() + renv.lockalso fails | ||
|
| ||
5.3.3. "Happy path" | |
|
For a reproducible environment Commands in terminal - Computer 1
xxxxxxxxxx9 1 cd project_folder2 git init3 R4 [obrir projecte de RStudio]5 renv::init() # to initialize renv in your code project6 renv::snapshot() # to make a snapshot "picture" of the list of R packages used within the whole R project and their respective package versions7 q()8 git commit ...9 git pushCommands in terminal - Computer 2
xxxxxxxxxx11 1 cd project_folder2 git clone/git pull ...3 R4 [open same RStudio project]5 renv::status() # for a report on which steps are suggested for you to follow6 renv::restore() # to restore the package library (with the required pacckage versions) for this project7 [continue working in/developing your code]8 renv::snapshot() # to make a new snapshot "picture" (in case there are new packages and/or versions or R packages neweer or older in use in your project ;-) )9 q()10 git commit ...11 git push
| |
5.3.4. Infraestructure | ||||||||||||||||||||||||||||||
|
Projects with
| ||||||||||||||||||||||||||||||
5.3.5. Advanced use | |
xxxxxxxxxx7 1 renv::install("packagename", version="0.1") # to install old versions from a package (useful also for discontinued packages in CRAN!). See possible package-version numbers at https://cran.r-project.org/src/contrib/Archive/yourpackage/2 renv::record("packagename", version="0.1") # to save at renv.lock the specific version you need for this package3 renv::deactivate() # to temporarily deactivate renv in your project4 renv::activate() # to reactivate renv in your project5 renv::equip() # for special installations in MS Windows6 vignette("docker", package = "renv") # for a commbined use with Docker7 vignette("collaborating", package = "renv") # to improve collaborative use in work teams
| |
5.4. Level 4: git - for code | |
|
See: https://gitlab.com/radup/curs-r-introduccio/ > Folder "codi" > 10.compartir.via.git.Rmd (or .pdf)
| |
6. More information | ||
| ||
7. Hands-on (guided) practical exercise | |
|
| |
7.1. Register a free account at Posit Cloud | |
|
You can do so at:
Once done, you'll see something like:
| |
7.2. Create a Project from git repository | |
|
| |
7.2.1. Visit gitlab to get clone url | |
|
Visit this code project in gitlab to get the project clone url:
| |
7.2.2. Create project from git repo | |
|
| |
7.3. Choose R 3.6.x & Run Rmd | |
|
| |
7.3.1. Install dependencies also | |
|
| |
7.3.2. Running Rmd will perform GNU/Linux system commands also | |
|
GNU/Linux system commands will usually be much more efficient in memory & cpu
(while csv file from reduced meteorological dataset is already 0.5 Gb).
| |
7.3.3. Display raw data | |
|
Variables are in numeric codes (not easily readable by humans in a semantic way). We lack some varaible names (or acronyms at least) for readability.
| |
7.3.4. Transform in tidy way (i) | |
|
| |
7.3.5. Transform in tidy way (ii) - result | |
|
| |
7.3.6. Last code chunks | |
|
| |
7.4. Choose R 4.2.x & Run Rmd again | |
|
Repeat the previous steps but in a R 4.2.x environment: install dependent R packages again... (new environment, but still installing from CRAN repos). renv not needed in this case still (lucky you!). So far, so good.
| |
7.5. Choose R 3.4.x & Run Rmd | ||
|
Now let's touch some issues with R package versions in a R 3.4.x environment
| ||
7.5.1. Use renv.lock recipe (i) | |
|
Let's get I did this already, and I uploaded the produced renv.lock file to the manually created ./recipes/ folder in this project as a backup for you (as renv_R344.lock). You can then copy now the ./recipes/renv_R344.lock file provided in the project as ./renv.lock in the project root folder, for
| |
7.5.2. Use renv.lock recipe (ii) | |
|
Run Choose restore the renv.lock package versions:
| |
7.5.3. Use renv.lock recipe (iii) | |
|
You will be ready to go with minimum human intervention. All R packages will be installed in the backgound to their required package versions, following the recipe that someone created for R 3.4.4. already. The key file is the renv.lock file.
| |
7.5.4. Use renv.lock recipe (iv) - finished | |
|
| |
7.6. Additional info | |
|
Project (Container) goes to sleep on inactivity
| |
8. Exercici (no guiat) amb renv | |
SORT! ;-)
| |
Gestió de Projectes en R (1) amb git i renv
Curs R Avançat Equips - Sessió 2