Kaip sklandžiai dokumentuoti savo R analizę naudojant R Markdown

Kaip Sklandziai Dokumentuoti Savo R Analize Naudojant R Markdown



Naudodami universalų R Markdown formatą galite lengvai įtraukti tekstą, vykdomąjį R kodą ir jo rezultatus į vieną failą. Iš šių failų galima lengvai transformuoti kelis statinius ir dinaminius išvesties formatus, pvz., PDF (.pdf), Word (.docx) ir HTML (.html). Gerai parašytas R Markdown failas turi pranašumą, nes jį galima atkurti. Tai taip pat reiškia, kad galite atkurti dokumentą nekeisdami tikrojo failo, jei pastebėsite duomenų perrašymo problemą arba turėsite galimybę į tyrimą įtraukti naujos informacijos. Kadangi RStudio jau turi integruotą R markdown paketą, jo diegimui nereikia jokių išankstinių veiksmų.

Bandymo kodas

Prieš pradėdami naudoti R Markdown, įsitikinkite, kad jūsų sistemoje yra R. Be to, šiuo metu turėtų būti paleista RStudio. Pirmiausia sukuriame scenarijų duomenų rinkiniui, kurį naudojame R Markdown faile.

Mes importuojame „duomenų rinkinių“ biblioteką iš R šaltinio kodo srityje. Integruotus duomenų rinkinius galima gauti naudojant šią biblioteką. Taigi duomenų rinkinys, pavadintas „AirPassengers“, gaunamas naudojant „duomenų“ funkciją ir apibendrinamas naudojant „santraukos“ funkciją.







Galų gale šiam duomenų rinkiniui pritaikoma funkcija plot(), kad būtų gautas konkretaus duomenų rinkinio grafiko / diagramos vaizdas. Paleidę šį kodą, gauname šio duomenų rinkinio santrauką, kuri rodoma konsolėje.



biblioteka ( duomenų rinkinius )

duomenis ( „Oro keleiviai“ )

santrauka ( Oro keleiviai )

sklypas ( Oro keleiviai )



Dešinėje RStudio srityje taip pat galite matyti rodomą AirPassengers duomenų rinkinio schemą. Dabar šį kodą naudojame R Markdown dokumente.





Darbo su R MarkDown pradžia RStudio

Norėdami inicijuoti R Markdown failą, turite naudoti meniu „Failas“, esantį viršutiniame kairiajame „RStudio“ lange. Bakstelėkite jį ir išplėskite galimą parinktį „Naujas failas“. Parinktyje „Naujas failas“ galite rasti parinktį „R Markdown“. Bakstelėkite jį, kad sukurtumėte.



RStudio ekrane pasirodys naujas langas „New R Markdown“. Kadangi norime sukurti R Markdown dokumentą, kairėje srityje turime pasirinkti „Dokumentas“. Dabar galite pavadinti savo dokumentą naudodami lauką „Pavadinimas“; pavadinome „Test“.

Taip pat galite nurodyti savo, kaip šio dokumento autoriaus, vardą, t. y. „Jonas“. Paskutiniame lauke turite nurodyti datą, kada sukūrėte R Markdown dokumentą. Taip pat galite naudoti žymimąjį laukelį, norėdami pateikti dokumento datą kiekvieną kartą, kai jį atnaujinate.

Dabar turite pasirinkti numatytąjį failo išvesties formatą, ty html, pdf arba Word. Mūsų atveju mes pasirenkame „HTML“ kaip numatytąjį failo išvesties formatą. Bakstelėkite mygtuką „Gerai“, kad toliau kurtumėte R Markdown failo pavyzdį. Taip pat galite naudoti mygtuką „Sukurti tuščią dokumentą“, kad sukurtumėte tuščią Markdown failą.

Norėdami redaguoti, perjunkite į vaizdinį režimą

Pavyzdinis R Markdown failas atidaromas RStudio šaltinio srityje. Dabar galite redaguoti šį Markdown failo pavyzdį pagal savo poreikius. Šis Markdown pavyzdinis failas yra padalintas į tris dalis. Dalis, kuri prasideda ir baigiasi „-“, vadinama „Markdown“ failo „antrašte“. Ji apima informaciją, kurią pateikėte pradėdami kurti žymėjimo failo pavyzdį, pvz., pavadinimą, autorių, datą ir išvesties formatą.

Dalis „## R Markdown“, įskaitant teksto eilutes, yra šio žymėjimo failo „teksto“ blokas. Taip pat galite jį atnaujinti ir įdėti tekstą. „## R Markdown“ yra antraštė, kurią taip pat galima atnaujinti. Kita dalis, prasidedanti trimis „`“ simboliais, žymi dalį „Kodo dalis“, kuri yra skirta kodo fragmentams pridėti. Kodavimo dalį taip pat gali papildyti dalis „plotai“, kuri yra būdinga grafikų generavimui naudojant kodus.

Atidaryto RStudio lango užduočių juostoje esantį mygtuką „Visual“ perjungiame į „R Markdown“ failo režimą „Visual“. Naujai atidarytame lange pateikiama keletas nurodymų, kaip judėti vizualiniame režime. Norėdami atidaryti vaizdo režimą, bakstelėkite mygtuką „Naudoti vaizdo režimą“.

Redaguokite pavyzdinį failą

Dabar paleistas „R Markdown“ pavyzdinio failo redagavimo „vaizdinis“ režimas. Galite formatuoti, įterpti ir redaguoti visą failą naudodami pateiktus užduočių juostos meniu. Pavyzdžiui, neatnaujinome antraštės dalies, bet pakeitėme blokų „Tekstas“ ir „Siužetai“ antraštės pavadinimus. Pakeiskite teksto pavyzdį nauju tekstu ir kodo srityje pateikite naują kodą. Taip pat atnaujinome šio failo bloką „Plot“ į šoną.

Išsaugokite failą

Dabar naudokite mygtuką „Mezti“, esantį „RStudio“ užduočių juostoje, kad sukurtumėte dokumentą.

Dabar RStudio paprašys jūsų naujo Markdown failo, kurį ketinate išsaugoti, vietos ir pavadinimo. Pagal numatytuosius nustatymus R Markdown failo tipas yra „.Rmd“. Pavadiname jį „testu“, kaip nurodyta toliau pateiktame paveikslėlyje, ir išsaugome jį „D“ diske naudodami mygtuką „Išsaugoti“:

Išsaugojus naujai sugeneruotą R Markdown failą, RStudio gali šiek tiek apdoroti, kad būtų rodomas dokumentas. Prieš tai jis gali paprašyti pradėti naują seansą atidarant šį langą. Norėdami tęsti, bakstelėkite „Pradėti naują sesiją“:

Peržiūrėkite žymėjimo dokumentą

Po kurio laiko RStudio pradeda savo naują seansą kartu su naujai sukurto R Markdown dokumento atidarymu atskirame lange per RStudio. Faile yra blokas „Antraštė“, kurio pavadinimas yra „Test“, po kurio nurodomas autoriaus vardas ir sukūrimo data. Kodo ir diagramos blokas rodo 100 procentų tą pačią išvestį, kuri rodoma „Test“ kodo išvestyje.

Išvada

Šiame vadove geriausiai parodyta, kaip naudoti R kalbą kuriant dokumentą naudojant R žymėjimą. Pradėdami nuo dokumento nustatymo, paaiškinome, kaip redaguoti, išsaugoti ir atidaryti naujai sugeneruotą R Markdown failą ir pažvelgti į jo antraštės bloką, teksto bloką, kodo gabalų bloką ir brėžinio bloką.