Introduction to R and R-Studio Introduction to R Markdown and Knit

Transcription

1 Introduction to R and R-Studio Introduction to R Markdown and Knit Introduction R Markdown and Knit is a system for keeping a history of your R work and has some terrific advantages: - The R Markdown file (.Rmd ) is a record of your R commands that can be reloaded into R at a later date for re-execution; and - The knitted file (your choice:.html,.pdf, or.docx ) is a record of your entire R session that is wonderfully organized and clear. Before You Begin Please note I do a lot of comments! You will see many of my commands that begin with the pound sign (#). They re also in green. While recommended, you don t actually have to type these comments. Tip! Make it a habit to create R Markdown files and to knit them! Later, you ll discover that these neatly archived records of your work are timesavers! R handout 01 Fall 2016 R Markdown and Knit.docx Page 1 of 7

2 Upon Launching R Begin your session by opening a new R Markdown file How to Open a New R Markdown File. Step 1. Launch R Studio Step 2. From the top menu bar: FILE > NEW FILE > R Markdown You should see something like the following (it won t say Carol Bigelow of course): Provide a title Choose your output format o Dear class For now (since I don t know what software you have) we will choose WORD. This preserves the option to edit it later. And you can save from your WORD to a PDF as you like. Click OK R handout 01 Fall 2016 R Markdown and Knit.docx Page 2 of 7

3 Example Here is what I have at this point (Note you can see that I chose to title my R markdown as myfirstrmarkdown) A little explanation of the above. * R Markdown has provided you with a shell * The gray shaded areas hold chunks of R commands Each chunk begins with ```{r} or it begins with ```{r SOMETHING YOU CHOOSE HERE} IF you choose ```{r include=false} THEN messages and code will be NOT SHOWN (I do not recommend this) If you choose ```{r echo=false} THEN code will NOT BE SHOWN (I do not recommend this either) Personally, I recommend sticking with beginning each chunk using ```{r } Each chunk ends with ``` * You will be happily inserting chunks, editing chunks, running chunks, rerunning chunks. Eventually you ll be all done with your work and will then do a final execution of your final chunks. This final execution is what is meant by KNITR. R handout 01 Fall 2016 R Markdown and Knit.docx Page 3 of 7

4 Step 3. Place your cursor at line 7 of the shell R Markdown. Then drag and delete everything below. In this way, you are emptying the provided R Markdown so that you can then populate it with what you want. Here is what I get: Step 4. Now you will cycle: 1 st : Insert a blank chunk 2 nd : Edit this blank chunk with the commands you want to run 3 rd : Run/execute your chunk 4 th : Edit your chunk 5 th : Rerun your chunk to confirm that it executes without error and in the way you want. R handout 01 Fall 2016 R Markdown and Knit.docx Page 4 of 7

5 HOW TO INSERT A CHUNK Click on the little green insert a chunk icon at top (on the right) EDIT YOUR BLANK CHUNK WITH THE COMMANDS YOU WANT TO RUN R handout 01 Fall 2016 R Markdown and Knit.docx Page 5 of 7

6 HOW TO RUN/EXECUTE CHUNK Use your cursor to select the lines or chunk that you want to run/execute. From the Run drop down at top right, make your selection Your output/results will appear in the CONSOLE window below: Step 5. All done? Knit your work and create your Word R Markdown file! From the menu at top (left) click on the drop down menu for KNIT WORD and make your selection. Tip Take care to choose the destination folder (I always choose DESKTOP and then move it later) R handout 01 Fall 2016 R Markdown and Knit.docx Page 6 of 7

7 You will now have TWO files: - A R Markdown file (.Rmd ) - An MS Word file (.docx ) This is what my MS Word file looks like R handout 01 Fall 2016 R Markdown and Knit.docx Page 7 of 7