So how do we create a basic knitr document?

So I'm going to talk about this in the context of R

studio, because I think it's the easiest way to do it.

There are other ways to do this, so this is not really exclusive to R studio

but it's going to, I'll just, the example that I'll show you will be in R studio.

So if you click on the New Document button on the

upper left, you'll see that there are a variety of options.

And you can click the R Markdown option to to

create a new markdown file that'll have your text and codes.

Here's your basic mark, R markdown document.

So R markdown is basically markdown with R code embedded in it.

You can see that what I have here is a

basic symbol that indicates that I'm going to start a code chunk.

So when I have the three back ticks, then the curly braces, and

an r, and then a close curly brace, that indicates that I'm starting

a code chunk.

So as you can see I have three lines of R code here.

Got set seed, that generates a random normal var variables.

And then I just take the mean.

And then I close this code chunk with three back ticks.

And so that and so that's, and so you can see above this shaded area

with the code, I've got text, so it's, the title is my first knitr document.

And then I said, just a line of text that says, this is some text.

And I say, here's a code chunk, and then I start the code chunk.

So in R studio you'll have this document open.

And you'll have the the code chunk and the text chunk there together.

And and the idea is that if you want to

process the knitr document, and create some human-readable output.

So, you want to, the idea is that you want to run the R

code, so that it, so you execute these three lines of R code.

And then you want to put the output from that R code.

In, in, embedded in your document.

And what's the output of this R code? Well there's only one

thing that happens when you calculate the mean.

So it's going to generate the mean, and it'll be whatever

the mean happens to be for that simulated data set.

So it's very easy in R Studio, you can just push

the Knit HTML button, and it will automatically run everything for you.

There's if you're not using our studio the way you

can do this is you can load the knitr package

with a library function you can make sure your working

director is set to wherever the aardvark down document is located

typically aardvark down documents will have a capital RMD extension.

It's not necessary but it's just a good way to identify these types of files.

You can use the knit2html function if you want to create a webpage as your output.

And you will automatically process the r markdown file and run

the r code and put the r code within the file.

And then, within r, if you want to open this

in your web browser, you can use the browseURL function.

It will create a new file.

Sorry, the knit2html function will take your r markdown document, create a html

file with the same name then, then you can open in your web browser.

So here's the output that you would get, this

is the HTML format output that you would get.

You can see there's a title in bold, in large text, there's some regular text.

The code is kind of in the shaded box, and then the output from

that code is directly below, here you can see here the mean is 0.1089.

So that's the output

that came from the mean function.

So in your MarkR, so that happens here is that neither

takes your original RMarkdown document, we can see on the left here.

And it processes it into a regular Markdown document.

As you can see that the, one thing that happens is that, it takes your code.

And then it, it reproduces the code in the regular markdown document.

But you can see that the in the

markdown document there's one extra piece, which is that

the result of the code which is down here at the bottom.

And so the result of evaluating the r code is

added to the markdown document after evaluating the r code.

So so when you create, first couple of

things, first of all when you generate, when you

create the new knitr document in RStudio, it will

populate that document with some kind of generic filler text.

So the first thing you probably want to do just delete it, because

that's not going to be relevant to whatever you want to do, most likely.

Code chunks begin, again, with the three back ticks the curly braces with an r.

And you end a code chunk with three back ticks.

All of your R code will go between these markers.

Now you can have more than one code chunk.

You can have as many code chunks as you want.

So you don't have put all of the R code in within the code chunk.

But any R code that you do have goes in a code chunk indicated by three back ticks.

You can have names for your code chunks so you

can name them after so immediately after the curly brace the

r you can put a name it can be anything you

want and then you can close it with a curly brace.

And then by default

the code in a code chunk will be echoed in the output document so just like in the in

the HTML document you saw that it echoed the code

and then it gave you the result of that code.

By default, you will, all the code chunks you'll be

able to see in the document, the code that was produced.

knitr (part 3)

Reproducible Research

与讲师见面