Kuinka käyttää R Markdown -koodipalstoja (2024)

Seuraavaksi opit koodilohkoistaR Markdowntiedostot.

Olet jo oppinut, että an.Rmdasiakirja sisältää kolme osaa

1. AYAMLotsikko.
2. Markdown-syntaksin tekstipalat, jotka kuvaavat käsittelyn työnkulkua tai ovat raportin tekstiä.
3. Koodipalat, jotka käsittelevät, visualisoivat ja/tai analysoivat tietojasi.

Puretaan koodipaloja.Rmdtiedostot.

Vinkkejä Data: Voit lisätä kooditulosteen tai anRobjektin nimi RMD:n merkintäsegmenteille. Katso lisää tästäR Markdownin dokumentaatio.

Koodipalat

Koodipalat anR Markdownasiakirja sisältää sinunRkoodi. Kaikki koodikappaleet alkavat ja päättyvät```– kolme selkäpuikkoa tai hautaa. Näppäimistössäsi takakuviot löytyvät samasta näppäimestä kuin aaltoviiva (~). Haudat eivät ole sama asia kuin heittomerkki!

Koodipala näyttää tältä:

``` {r chunk-name-with-no-spaces}# koodi menee tähän ```

Ensimmäinen rivi:``` {r osan-nimi-ei-välilyöntejä}sisältää kielen (r) tässä tapauksessa ja osan nimi. Kielen määrittäminen on pakollista. Vieressä{r}, on palan nimi. Palan nimeä ei kuitenkaan välttämättä vaadita, mutta on hyvä käytäntö antaa jokaiselle palalle yksilöllinen nimi, jotta ne tukevat kehittyneempiä neulontamenetelmiä.

```{r suorita matematiikka }# suorita lisäys <- 1+2b <- 234# vähennä a:sta blopullinen_vastaus <- b - a# kirjoita lopullinen vastaus muuttujalopullinen_vastaus```

```{r matematiikka-toinen osa } # Lisää matematiikkaa! a * b a * b / lopullinen_ vastaus ```

Huomaa, että olet ottanut käyttöön jokaisessa koodilohkossasikommentteja. Kommentit ovat koodimme rivejä, joita ei suoritaR. Niiden avulla voimme kuitenkin kuvata koodimme tarkoitusta. Ota tavaksi lisätä kommentteja koodaaessasi. Saat lisätietoja tästä, kun purat tieteellisen ohjelmoinninRmyöhemmässä opetusohjelmassa.

Koodilohkon asetukset

Voit lisätä vaihtoehtoja jokaiseen koodipalaan. Näiden asetusten avulla voit mukauttaa, kuinka tai haluatko koodin käsiteltävän tai näkyvän renderoidussa tulosteessa (pdf-dokumentti, html-dokumentti jne.). Koodipalavaihtoehdot lisätään koodikappaleen ensimmäiselle riville nimen jälkeen, kiharahakasulkeisiin.

Alla oleva esimerkki on koodikappale, jota R ei "ajoa" tai arvioi. Osassa oleva koodi näkyy tulosdokumentissa, mutta koodista ei kuitenkaan tule ulostuloja.

```{r intro-option, eval = FALSE}# tämä on kommentti. teksti kommentin vieressä, jota R# ei käsittele Kommentit näkyvät renderoidussa r-merkintäasiakirjassa1+2 ```

Yksi esimerkki käytöstäeval = EPÄTOSIon tarkoitettu koodikappaleelle, joka vie tiedoston, kuten kuvagrafiikka- tai tekstitiedoston. Haluat ehkä näyttää tai dokumentoida koodin, jota käytit kuvan viemiseenhtmltaipdfasiakirjaa, mutta sinun ei tarvitse viedä kyseistä tiedostoa aina, kun luot tarkistetunhtmltaipdfasiakirja.

3 yleistä lohkovaihtoehtoa: Eval, Echo & Results

Kolme yleistä koodilohkovaihtoehtoa ovat:

• eval = EPÄTOSI: Äläevaluate (tai suorita) tämä koodikappale, kun neuloat RMD-asiakirjaa. Tämän osan koodi hahmonnetaan edelleen neuloksessammehtmltulos, mutta sitä ei arvioida tai suorittaaR.
• echo=FALSE: Piilota koodi tulosteessa. Koodi arvioidaan, kunRmdtiedosto neulotaan, mutta vain tulos renderöidään tulosteen asiakirjassa.
• tulokset=piilota: Koodipala arvioidaan, mutta tuloksia tai koodia ei hahmonneta tulosteen asiakirjassa. Tämä on hyödyllistä, jos tarkastelet suuren objektin rakennetta (esim. suuren kohteen lähtöjädatakehysjoka vastaa laskentataulukkoaR).

Samalle osalle voidaan käyttää useita koodilohkovaihtoehtoja.

```{r testing-arguments, eval = EPÄTOSI } # Lisää matematiikkaa! a * b a * b / lopullinen_ vastaus ```

```{r testing-arguments, echo=FALSE } # Lisää matematiikkaa! a * b a * b / lopullinen_ vastaus ```

```{r testing-arguments, results="hide" } # Lisää matematiikkaa! a * b a * b / lopullinen_ vastaus ```

Neulot omasiR Markdowndokumentoida.htmlseuraavalla oppitunnilla.