Johdanto R -merkinnästä (2024)

R -merkintä

R Markdown on tiedostomuoto dynaamisten asiakirjojen tekemiseksi R. R: n kanssa R-merkinnän asiakirja on kirjoitettu Markdown-muodossa (helppo kirjoittaa tavallinen tekstimuoto) ja se sisältää sulautetun R-koodin paloja, kuten alla oleva asiakirja.

--- Lähtö: HTML_DOCUMENT --- Tämä on R-merkinnän asiakirja.Markdown on yksinkertainen muotoilun syntaksi HTML-, PDF- ja MS Word -asiakirjojen kirjoittamiseen.Lisätietoja R Markdownin käytöstä on.Kun napsautat ** neuloa ** -painiketta luodaan asiakirja, joka sisältää sekä sisällön että kaikkien upotettujen R -koodin palojen tulosteen.Voit upottaa R -koodin palan, kuten näin: `` `{r} yhteenveto (autot)` `` `voit myös upottaa kuvaajia, esimerkiksi` `` {r, echo = false} tontti (auto) `` `Huomaaettä koodipalaan lisättiin `echo = false` -parametri, joka estää tontin luoman R -koodin tulostamisen.

R Markdown -tiedostot on suunniteltu käytettäväksirimarkkinointipaketti.rimarkkinointitulee asennettuna RStudio IDE: n kanssa, mutta voit hankkia oman kopionrimarkkinointiCranilta komennolla

asenna.Packages ("rmarkdown")

R Markdown -tiedostot ovat lähdekoodi rikkaille, toistettaville asiakirjoille.Voit muuttaa R -merkinnän tiedoston kahdella tavalla.

1. neuloa- Voitneuloatiedosto.Serimarkkinointipaketti soittaaknitrpaketti.knitrSuorittaa jokaisen R -koodin palat asiakirjassa ja liittää koodin tulokset koodin vieressä olevaan asiakirjaan.Tämä työnkulku säästää aikaa ja helpottaa toistettavia raportteja.

   Mieti, kuinka kirjoittajat sisältävät tyypillisesti kuvaajat (tai taulukot tai numerot) raporttiin.Kirjailija tekee kaavion, tallentaa sen tiedostona ja kopioi ja liittää sen loppuraporttiin.Tämä prosessi perustuu käsityöhön.Jos tiedot muuttuvat, tekijän on toistettava koko prosessi kaavion päivittämiseksi.

   R-merkinnän paradigmassa kukin raportti sisältää tarvitsemansa koodin omien kaavioidensa, taulukoiden, numeroiden jne. Valottamiseksi jne. Kirjailija voi päivittää raportin automaattisesti uudelleensijoittamalla uudelleen.

2. muuntaa- Voitmuuntaatiedosto.Serimarkkinointipaketti käyttääpandocOhjelma tiedoston muuttamiseksi uudeksi muotoksi.Voit esimerkiksi muuntaa .rmd -tiedostosi HTML-, PDF- tai Microsoft Word -tiedostoksi.Voit jopa muuttaa tiedoston HTML5- tai PDF -diaesityksenä.rimarkkinointiSäilyttää alkuperäisen .RMD -tiedoston sisältämän tekstin, koodin tulokset ja muotoilun.

   Muutoksen avulla voit tehdä alkuperäisen työn Markdownissa, jota on erittäin helppo käyttää.Voit sisällyttää RODE -koodin neulottuun, ja voit jakaa asiakirjan moniin muodoihin.

Käytännössä kirjoittajat neulottiin melkein aina ja muuntavat asiakirjat samanaikaisesti.Tässä artikkelissa käytän termiätehdäViitata kaksivaiheiseen neulomisprosessiin ja R -merkintätiedoston muuntamiseen.

Voit tehdä manuaalisesti R -merkinnän tiedostonrmarkdown :: render ().Tätä yllä oleva asiakirja näyttää, kun se tehdään HTML -tiedostona.

Käytännössä sinun ei tarvitse soittaarmarkdown :: render ().Voit käyttää painiketta RStudio IDE: ssä tehdäksesi uusintasi.R Markdown on voimakkaastiintegroitu RStudio IDE: hen.

Aloittaminen

Luo R -merkinnän raportti avaa tavallinen tekstitiedosto ja tallenna se laajennuksella.Rmd.Voit avata Scripts Editor -sovelluksen tavallisen tekstitiedoston napsauttamalla tiedosto> Uusi tiedosto> Tekstitiedosto RStudio -työkalurivillä.

Tallenna tiedosto laajennuksella.Rmd.RStudio IDE mahdollistaa useita hyödyllisiä painikkeita, kun tallennat tiedoston .rmd -laajennuksella.Voit tallentaa tiedostosi napsauttamalla tiedosto> Tallenna RStudio -työkalurivillä.

R Markdown -raportit luottavat kolmeen kehykseen

1. Merkintä muotoiltulle tekstille
2. knitrSulautetulle R -koodille
3. Yaml render -parametreihin

Alla olevat kohdat kuvaavat jokaista kehystä.

Merkintä muotoiltulle tekstille

.Rmd -tiedostojen on tarkoitus sisältää tekstiä kirjoitettumerkintä.Markdown on joukko yleissopimuksia tavallisen tekstin muotoiluun.Voit ilmaista Markdown

• rohkea ja kursivoitu teksti
• luettelot
• Otsikot (esim. Leikkausnimikkeet)
• hyperlinkit
• Ja paljon muuta

Markdown -yleissopimukset ovat erittäin häiritsemättömiä, jotka tekevät merkinnän tiedostoista helppo lukea.Seuraava tiedosto käyttää useita hyödyllisimpiä Markdown -yleissopimuksia.

# Sano hei Markdownmarkdown on ** helppo käyttää ** -muotoa raporttien kirjoittamiseen.Se muistuttaa sitä, mitä kirjoitat luonnollisesti joka kerta, kun kirjoitat sähköpostia.Itse asiassa olet jo käyttänyt Markdownia *ymmärtämättä sitä *.Nämä verkkosivustot luottavat kaikki Markdown -muotoiluun* [github] (www.github.com)* [StackOverFlow] (www.stackoverflow.com)* [reddit] (www.reddit.com)

Tiedosto osoittaa, kuinka Markdown osoittaa:

1. otsikot- Aseta yksi tai useampi hashtagi linjan alussa, joka on otsikko (tai alaotsikko).Esimerkiksi,# Tervehdi Markdownia.Yksi hashtag luo ensimmäisen tason otsikon.Kaksi hashtagia,##, luo toisen tason otsikon ja niin edelleen.

2. kursivoitu ja rohkea teksti- Surround italikoitunut teksti tähdellä, kuten tämä*ymmärtämättä sitä*.Ympäröi rohkea teksti kahdella tähdellä, kuten tämä** Helppo käyttää **.

3. luettelot- Ryhmä linjat luodinpisteisiin, jotka alkavat tähdellä.Jätä tyhjä rivi ennen ensimmäistä luodia, kuten tämä

   Tämä on luettelo * Kohta 1 * Kohta 2 * Kohta 3

4. hyperlinkit- Sulje -yhteydet suluihin ja tarjoa sitten linkkikohde suluihin, kuten tämä[Github] (www.github.com).

Voit oppia lisää Markdownin yleissopimuksistaMarkdown PikaviiteOpas, joka tulee RStudio IDE: n mukana.

Päästäksesi oppaan avaa a.Mdtai.RmdTiedosto RStudiossa.Napsauta sitten kysymysmerkkiä, joka näkyy skriptit -ruudun yläosassa.Valitse seuraavaksi ”Markdown Quick Reference”.Rstudio avaaMarkdown PikaviiteOpas ohjeikkunassa.

Knitr sulautetulle R -koodille

SeknitrPaketti laajentaa perusmerkinnän syntaksia sisällyttämään suoritettavan R -koodin palat.

Kun teet raportin,knitrSuorittaa koodin ja lisää tulokset tulostetiedostoon.Sinulla voi olla lähtöäyttö vain koodin, vain tulokset tai molemmat.

Upottaaksesi R -koodin kappaleen raporttiin, ympäröi koodi kahdella rivillä, jotka kumpikin sisältävät kolme backickia.Ensimmäisen backicks -sarjan jälkeen sisällytä{r}, mikä hälyttääknitrettä olet sisällyttänyt R -koodin.Tulos näyttää tältä

Tässä on joitain koodia "`rdim (Iris) `` `` `` ## [1] 150 5```

Kun teet asiakirjan,knitrSuorittaa koodin ja liittää tulokset Code Chunkiin.knitrtarjoaa muotoilun ja syntaksin korostamisen sekä koodille että sen tuloksille (tarvittaessa).

Seurauksena on, että yllä oleva Markdown -katkelma näyttää tältä, kun se on tehty (HTML).

Jättää poistuloksetLopullisesta raportistasi (eikä koodia suorita) lisää argumenttiEvio = vääräkiinnikkeiden sisällä ja sen jälkeenr -.Tämä asettaa koodin koodista raporttiin.

Jättää poiskoodiLopullisesta raportista (lisäämällä tuloksia) lisää argumenttikaiku = väärä.Tämä asettaa kopion tuloksista raporttiin.

kaiku = vääräon erittäin kätevä tonttien lisäämisessä raporttiin, koska et yleensä halua nähdä koodia, joka tuottaa kuvaajan.

kaikujaarvioidaeivät ole ainoat argumentit, joiden avulla voit mukauttaa koodin paloja.Voit oppia lisää koodipalkkien tulosteen muotoilustarimarkkinointijaknitrverkkosivustot.

Kaksi plus kaksi vastaa 4.

Yaml render -parametreihin

Voit hallita YAML -otsikkoa mitenrimarkkinointitekee .rmd -tiedostosi.Yaml -otsikko on osaAvain: arvoparit ympäröimänä---Merkit, kuten alla

--- Otsikko: "Nimetön" kirjoittaja: "Garrett" Päivämäärä: "10. heinäkuuta 2014" Lähtö: HTML_DOCUMENT --- Jotkut inline r -koodit, 4.

Selähtö:Arvo määrittää, minkä tyyppinen tulos on muuntaa tiedoston, kun soitatrmarkdown :: render ().Huomaa: Sinun ei tarvitse määrittäälähtö:Jos teet tiedostosi RStudio IDE Knit -painikkeella.

lähtö:tunnistaa seuraavat arvot:

• html_document, joka luo HTML -lähtöä (oletus)
• pdf_document, joka luo PDF -lähtöä
• Word_document, joka luo sanan ulostulosta

Jos käytät RSTUDIO IDE Knit -painiketta tiedoston tekemiseen, GUI: n tekemäsi valinta ohittaalähtö:asetus.

Kertaus

R Markdown -asiakirjat tarjoavat nopean, toistettavan raportoinnin.knitrsyntaksi.

Voit päivittää asiakirjan milloin tahansa liittämällä koodin palat uudelleen.

Voit sitten muuntaa asiakirjan useiksi yleisiin muotoihin.

R Markdown -asiakirjat toteuttavat Donaldin Knuthin idean lukutaitoisesta ohjelmoinnista ja ottamaan käsityöt pois kirjoittamisesta ja ylläpidosta raporttien.Lisäksi he oppivat nopeasti.Tiedät jo Ecnoughin Markdownista, Knitristä ja Yamlista aloittaaksesi oman R -merkinnän raporttiesi kirjoittamisen.

Seuraavassa artikkelissaJohdanto vuorovaikutteisiin asiakirjoihin, Opit kuinka lisätä interaktiivisia kiiltäviä komponentteja R -merkinnän raporttiin.Tämä luo nopean työnkulun kevyiden kiiltävien sovellusten kirjoittamiseen.

Lisätietoja R Markdownista ja interaktiivisista asiakirjoista on käymällärmarkdown.rstudio.com.