Kuidas oma R-analüüsi R Markdowniga sujuvalt dokumenteerida

Kuidas Oma R Analuusi R Markdowniga Sujuvalt Dokumenteerida



Mitmekülgse R Markdowni vorminguga saate hõlpsasti lisada teksti, käivitatava R-koodi ja selle tulemused ühte faili. Nendest failidest saab hõlpsasti teisendada mitut staatilist ja dünaamilist väljundvormingut, nagu PDF (.pdf), Word (.docx) ja HTML (.html). Hästi kirjutatud R Markdowni faili eeliseks on see, et see on reprodutseeritav. See tähendab ka seda, et kui avastate andmete transkribeerimisega probleeme või kui teil on võimalus uuringusse uut teavet lisada, võite paberi ümber ehitada ilma tegelikku faili muutmata. Kuna RStudiol on juba sisseehitatud R-markdowni pakett, ei ole selle installimiseks vaja eeltoiminguid teha.

Testi kood

Enne R Markdowniga alustamist veenduge, et R oleks teie süsteemi paigaldatud. Koos sellega peaks hetkel käima RStudio. Esiteks loome skripti andmestiku jaoks, mida kasutame failis R Markdown.

Impordime lähtekoodialasse R-st 'andmekogumite' teegi. Sisseehitatud andmekogumeid saab tuua selle teegi abil. Seega tuuakse andmestik nimega 'AirPassengers' funktsiooni 'andmed' abil ja tehakse kokkuvõte funktsiooni 'kokkuvõte' abil.







Lõpuks rakendatakse sellele andmekogumile funktsioon plot(), et saada konkreetsest andmekogumist graafiku/graafiku vaade. Pärast selle koodi käivitamist saame selle andmestiku kokkuvõtte, mis kuvatakse konsoolil.



raamatukogu ( andmestikud )

andmeid ( 'Lennureisijad' )

kokkuvõte ( Lennukireisijad )

süžee ( Lennukireisijad )



RStudio paremal paanil näete ka AirPassengersi andmestiku graafikut. Nüüd kasutame seda koodi oma R Markdowni dokumendis.





R MarkDowniga alustamine RStudios

R Markdowni faili käivitamiseks peate kasutama RStudio vasakpoolses ülanurgas olevat menüüd Fail. Puudutage seda ja laiendage saadaolevat valikut „Uus fail”. Suvandi „Uus fail” alt leiate valiku „R Markdown”. Selle loomiseks puudutage seda.



Teie RStudio ekraanile ilmub uus aken 'New R Markdown'. Kuna tahame luua R Markdowni dokumendi, peame vasakpoolselt paanilt valima 'Dokument'. Nüüd saate oma dokumendile nime anda, kasutades välja 'Pealkiri'; andsime sellele nimeks 'Test'.

Samuti võite esitada oma nime selle dokumendi autorina, st 'John'. Viimasel väljal peate sisestama R Markdowni dokumendi loomise kuupäeva. Saate kasutada ka märkeruutu, et renderdada dokumendi kuupäev iga kord, kui seda värskendate.

Nüüd peate valima faili vaikeväljundvormingu, st html, pdf või Word. Meie puhul valime faili vaikeväljundvorminguks 'HTML'. R Markdowni näidisfaili loomise jätkamiseks puudutage nuppu „OK”. Tühja Markdowni faili loomiseks võite kasutada ka nuppu Loo tühi dokument.

Redigeerimiseks lülitage visuaalrežiimi

R Markdowni näidisfail avatakse RStudio Source piirkonnas. Nüüd saate seda Markdowni näidisfaili vastavalt oma vajadustele muuta. See Markdowni näidisfail on jagatud kolmeks osaks. Osa, mis algab ja lõpeb tähega '-', nimetatakse Markdowni faili 'päiseks'. See sisaldab teavet, mille esitasite allahindluse näidisfaili loomise alustamisel, st pealkiri, autor, kuupäev ja väljundvorming.

Osa '## R Markdown', sealhulgas tekstiread, on selle märgistusfaili 'teksti' plokk. Samuti saate seda värskendada ja sellele oma teksti paigutada. „## R Markdown” on pealkiri, mida saab samuti värskendada. Järgmine osa, mis algab kolme sümboliga '`', tähistab koodilõikude lisamiseks spetsiifilist osa 'Kooditükk'. Kodeerimisosaga võib kaasneda ka osa “plots”, mis on spetsiifiline koodide kaudu graafikute genereerimiseks.

Avatud RStudio akna tegumiriba nupu „Visuaalne” abil lülitame R Markdown faili visuaalsesse režiimi. Äsja avatud aken pakub juhiseid visuaalses režiimis liikumise kohta. Visuaalse režiimi avamiseks puudutage nuppu 'Kasuta visuaalset režiimi'.

Redigeerige näidisfaili

Nüüd käivitatakse R Markdowni näidisfaili redigeerimisrežiim 'Visuaalne'. Tegumiriba menüüde abil saate vormindada, sisestada ja redigeerida kogu faili. Näiteks me ei värskendanud päise osa, vaid asendasime päise pealkirjad plokkide 'Tekst' ja 'Süžeed' jaoks. Asendage näidistekst uue tekstiga ja sisestage koodialale uus kood. Värskendasime ka selle faili plokki Plot külgsuunas.

Salvestage fail

Nüüd kasutage dokumendi loomiseks RStudio tegumiribal olevat nuppu 'Kududa'.

Nüüd küsib RStudio teilt uue salvestatava Markdown-faili asukohta ja nime. R Markdowni faili tüüp on vaikimisi '.Rmd'. Nimetame selle 'test' vastavalt järgmisele pildile ja salvestame selle 'D' draivi nupu 'Salvesta' kaudu:

Pärast äsja loodud R Markdowni faili salvestamist võib RStudio dokumendi kuvamiseks veidi töödelda. Enne seda võib see paluda teil alustada uut seanssi, avades järgmise akna. Jätkamiseks puudutage nuppu 'Alusta uut seanssi'.

Vaadake üle Markdowni dokument

Mõne aja pärast alustab RStudio oma uut seanssi koos vastloodud R Markdowni dokumendi avamisega eraldi aknas RStudio kaudu. Fail sisaldab plokki 'Päis', mille faili pealkiri on 'Test', millele järgneb autori nimi ja loomise kuupäev. Koodi ja graafiku plokk näitab 100 protsenti sama väljundit, mis kuvatakse koodiväljundis 'Test'.

Järeldus

See juhend annab parima ülevaate R-keele kasutamisest dokumendi loomiseks R Markdowni kaudu. Alustades dokumendi seadistamisest, selgitasime, kuidas redigeerida, salvestada ja avada äsja loodud R Markdowni faili ning vaadata selle päiseplokki, tekstiplokki, kooditükiplokki ja jooniseplokki.