From 4ef8e24ae4e1fcf055ee01a9fe3df04a414bc16f Mon Sep 17 00:00:00 2001
From: hpolvech <helene.polveche@ens-lyon.fr>
Date: Tue, 24 Mar 2020 11:46:06 +0100
Subject: [PATCH] HTML_tuto: simplification function part

---
 session_1/HTML_tuto.Rmd     | 163 ++++++++++++++++--------------------
 session_1/img/intro_img.png | Bin 0 -> 32056 bytes
 2 files changed, 72 insertions(+), 91 deletions(-)
 create mode 100644 session_1/img/intro_img.png

diff --git a/session_1/HTML_tuto.Rmd b/session_1/HTML_tuto.Rmd
index 2404bd0..121eebe 100644
--- a/session_1/HTML_tuto.Rmd
+++ b/session_1/HTML_tuto.Rmd
@@ -56,6 +56,11 @@ The objectives of this session will be to:
 - Manage a workspace in R
 - Call functions
 - Manage packages
+- Be ready to write graphics !
+
+<center>
+![](./img/intro_img.png){width=400px}
+</center>
 
 ### Acknowledgments
 
@@ -74,6 +79,10 @@ The objectives of this session will be to:
   http://swcarpentry.github.io/r-novice-gapminder/
 </div> 
 
+ \ 
+ 
+- **Margot** and **Alexandre** for assistance!
+
 
 # Some R background
 
@@ -170,7 +179,6 @@ It is waiting for the next command. Write just `100` :
 
 ```{r calculatorstep5, include=TRUE}
 (3 + (5 * (2 ^ 2))) # hard to read
-3 + 5 * 2 ^ 2       # clear, if you remember the rules
 3 + 5 * (2 ^ 2)     # if you forget some rules, this might help
 ```
  \ 
@@ -218,7 +226,7 @@ factorial(9)
 
 ### Comparing things
 
-Comparisons can be made with R. The result will return a `TRUE` or `FALSE` value.
+Comparisons can be made with R. The result will return a `TRUE` or `FALSE` value (`boolean` type).
 
 
 equality (note two equal signs read as "is equal to")
@@ -323,6 +331,17 @@ a
  \ 
 ```R
 x + z
+```
+ \ 
+ 
+How to test the type of the variable?
+```{r VandAstep20, include=TRUE}
+
+is.character(z)
+
+b <- 1/40
+b
+typeof(b)
 ```
 
 ### Variables names
@@ -348,11 +367,11 @@ What you use is up to you, but be consistent.
 ```
 min_height
 max.height
-_age
+_age            # no
 .mass
 MaxLength
-min-length
-2widths
+min-length      # no
+2widths         # no
 celsius2kelvin
 ```
  \ 
@@ -396,107 +415,82 @@ This block allows you to view the different outputs (?help, graphs, etc.).
 
  \ 
  
-Test that your `logarithm` function can work in base 10
 
+### A code editor
 
-```{r VandAstep10, include=TRUE}
-10^logarithm(12, base = 10)
-```
+![](./img/RStudio_editor.png)
 
+ \ 
+ 
+RStudio offers you great flexibility in running code from within the editor window. There are buttons, menu choices, and keyboard shortcuts. To run the current line, you can
 
-We can also define our own function with
-```
-function_name <- function(a, b){
-  result_1 <- operation1(a, b)
-  result_2 <- operation2(result_1, b)
-  return(result_2)
-}
-```
+- click on the `Run button` above the editor panel, or
+- select “Run Lines” from the “Code” menu, or
+- hit `Ctrl`+`Return` in Windows or Linux or `Cmd`+`Return` on OS X. To run a block of code, select it and then Run. 
 
- \ 
-<div id="pquestion">Write a function to test the base of the logarithm function</div>
+If you have modified a line of code within a block of code you have just run, there is no need to reselect the section and Run, you can use the next button along, Rerun the previous region. This will run the previous code block including the modifications you have made.
+
+
+Copy your `function` into a `tp_1.R` file
 
  \ 
- 
- 
- A function can write in several forms : 
- 
-```{r VandAstep11, include=TRUE}
-base_test <- function(x, base){
-  log_result <- logarithm(x, base=base)
-  exp_result <- base^log_result
-  test_result <- x == exp_result
-  return(test_result)
-}
 
-base_test(12, 2)
+We can  define our own function with :
+
+- function name,
+- declaration of function type,
+- arguments,
+- `{` and `}` top open and close function,
+
 ```
+function_name <- function(a, b){
 
- or
 
-```{r VandAstep12, include=TRUE}
-base_test <- function(x, base){
-  print(x)
-  log_result <- logarithm(x, base=base)
-  print(log_result)
-  exp_result <- base^log_result
-  print(exp_result)
-  print(x)
-  test_result <- x == exp_result
-  return(test_result)
 }
-
-base_test(12, 2)
 ```
+- a series of operations,
 
-or
+```
+function_name <- function(a, b){
+  result_1 <- operation1(a, b)
+  result_2 <- operation2(result_1, b)
 
-```{r VandAstep13, include=TRUE}
-base_test <- function(x, base){
-  print(x)
-  log_result <- logarithm(x, base=base)
-  print(log_result)
-  exp_result <- base^log_result
-  print(exp_result)
-  print(x)
-  test_result <- isTRUE(all.equal(x, exp_result))
-  return(test_result)
 }
-
-base_test(12, 2)
 ```
 
-or
+- `return` operation
 
-```{r VandAstep14, include=TRUE}
-base_test <- function(x, base){
-  return(isTRUE(all.equal(x, base^logarithm(x, base=base))))
+```
+function_name <- function(a, b){
+  result_1 <- operation1(a, b)
+  result_2 <- operation2(result_1, b)
+  return(result_2)
 }
-
-base_test(12, 2)
 ```
 
  \ 
-
-### A code editor
-
-![](./img/RStudio_editor.png)
+<div id="pquestion">How to write a function to test if a number is even?</div>
 
  \ 
  
-RStudio offers you great flexibility in running code from within the editor window. There are buttons, menu choices, and keyboard shortcuts. To run the current line, you can
-
-- click on the `Run button` above the editor panel, or
-- select “Run Lines” from the “Code” menu, or
-- hit `Ctrl`+`Return` in Windows or Linux or `Cmd`+`Return` on OS X. To run a block of code, select it and then Run. 
+ 
+```{r VandAstep11, include=TRUE}
+even_test <- function(x){
+  modulo_result <- x %% 2         # %% is modulo operator
+  is_even <- modulo_result == 0
+  return(is_even)
+}
 
-If you have modified a line of code within a block of code you have just run, there is no need to reselect the section and Run, you can use the next button along, Rerun the previous region. This will run the previous code block including the modifications you have made.
+even_test(4)
 
+even_test(3)
+```
 
-Copy your `logarithm` and `base_test` into a `tp_1.R` file
+ **Note :** A function can write in several forms.
 
+ \ 
 
-We can now clean your environment
+No We can now clean your environment
 
 ```{r VandAstep15, include=TRUE}
 rm(x)
@@ -555,12 +549,12 @@ c(1:5)
 A mathematical calculation can be performed on the elements of the vector:
 
 ```{r Vecstep3, include=TRUE}
-2^(1:5)
+2^c(1:5)
 ```
 
 
 ```{r Vecstep4, include=TRUE}
-x <- 1:5
+x <- c(1:5)
 2^x
 ```
 
@@ -590,13 +584,9 @@ is.vector(x)
 
 ```{r Vecstep8, include=TRUE}
 y <- c(a = 1, b = 2, c = 3, d = 4, e = 5)
-typeof(y)
-is.vector(y)
 ```
 
  \ 
- 
- \ 
 We can compare the elements of two vectors:
 
 ```{r Vecstep9, include=TRUE}
@@ -606,21 +596,12 @@ x == y
 ```
 
  \ 
- 
- \ 
- 
-If you use `all.equal` :
 
-```{r Vecstep10, include=TRUE}
-all.equal(x, y)
-isTRUE(all.equal(x, y))
-isTRUE(all.equal(x, y, check.attributes = FALSE))
-```
  \ 
 
 <fieldset id='pencadre' style='text-align: left'>
   <legend style='border: 0px;'>Summary box</legend>
-  <li> A variable can be of different types : `numeric`, `character`, `vector`, etc.</li>
+  <li> A variable can be of different types : `numeric`, `character`, `vector`, `function`, etc.</li>
   <li> Calculations and comparisons apply to vectors.</li>
   <li> Do not hesitate to use the help box to understand functions!  </li>
 </fieldset>
diff --git a/session_1/img/intro_img.png b/session_1/img/intro_img.png
new file mode 100644
index 0000000000000000000000000000000000000000..2bc5c70194b9b25ad19f6442411089670935d342
GIT binary patch
literal 32056
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

literal 0
HcmV?d00001

-- 
GitLab