Az R-elemzés zökkenőmentes dokumentálása az R Markdown segítségével

Az R Elemzes Zokkenomentes Dokumentalasa Az R Markdown Segitsegevel



A sokoldalú R Markdown formátummal egyszerűen egyetlen fájlba foglalhatja a szöveget, a végrehajtható R kódot és annak eredményeit. Több statikus és dinamikus kimeneti formátum, például PDF (.pdf), Word (.docx) és HTML (.html) könnyen átalakítható ezekből a fájlokból. A jól megírt R Markdown fájlnak megvan az az előnye, hogy reprodukálható. Ez azt is jelenti, hogy újraépítheti a papírt a valódi fájl megváltoztatása nélkül, ha adatátírási problémát talál, vagy új információkat tud hozzáadni a kutatáshoz. Mivel az RStudio már rendelkezik a beépített R markdown csomaggal, a telepítéséhez nincs szükség előzetes lépésekre.

Teszt kód

Mielőtt elkezdené az R Markdown alkalmazást, győződjön meg arról, hogy az R fel van szerelve a rendszerbe. Ezzel együtt az RStudio-t jelenleg el kell indítani. Először létrehozunk egy szkriptet az adatkészlethez, amelyet az R Markdown fájlban használunk.

Az „adatkészletek” könyvtárat az R-ből importáljuk a forráskód területén belül. A beépített adatkészletek lekérhetők ezzel a könyvtárral. Tehát az „AirPassengers” nevű adatkészletet a „data” függvény lekéri, és az „összefoglaló” függvény segítségével összegzi.







Végül a plot() függvényt alkalmazzuk erre az adatkészletre, hogy grafikon/diagram nézetet kapjunk az adott adatkészletről. A kód futtatása után megkapjuk az adatkészlet összefoglalóját, amely megjelenik a konzolon.



könyvtár ( adatkészletek )

adat ( 'Légi utasok' )

összefoglaló ( Air Passengers )

cselekmény ( Air Passengers )



Az RStudio jobb oldali ablaktáblájában az AirPassengers adatkészlet diagramja is megjelenik. Most ezt a kódot használjuk az R Markdown dokumentumunkban.





Az R MarkDown használatának megkezdése az RStudióban

Az R Markdown fájl elindításához használja a „Fájl” menüt az RStudio bal felső ablakában. Koppintson rá, és bontsa ki az elérhető „Új fájl” lehetőséget. Az „Új fájl” opción belül megtalálja az „R Markdown” opciót. Érintse meg, hogy létrehozzon egyet.



Egy új „New R Markdown” ablak jelenik meg az RStudio képernyőjén. Mivel R Markdown dokumentumot szeretnénk létrehozni, a bal oldali ablaktáblában ki kell választanunk a „Dokumentum” elemet. Most elnevezheti dokumentumát a „Cím” mező használatával; „Teszt”-nek neveztük el.

Megadhatja továbbá a nevét a dokumentum szerzőjeként, azaz „János”. Az utolsó mezőben meg kell adnia az R Markdown dokumentum létrehozásának dátumát. A jelölőnégyzet használatával a dokumentum dátumát is megjelenítheti minden alkalommal, amikor frissíti.

Most ki kell választania a fájl alapértelmezett kimeneti formátumát, azaz html, pdf vagy Word. Esetünkben a „HTML”-t választjuk a fájl alapértelmezett kimeneti formátumaként. Érintse meg az „OK” gombot a minta R Markdown fájl létrehozásának folytatásához. Üres Markdown fájl létrehozásához használhatja az „Üres dokumentum létrehozása” gombot is.

Váltson vizuális módra a szerkesztéshez

Az R Markdown mintafájl az RStudio Source területen nyílik meg. Most szerkesztheti ezt a Markdown mintafájlt igényei szerint. Ez a Markdown mintafájl három részre oszlik. A „-” karakterrel kezdődő és végződő részt a Markdown fájl „fejlécének” nevezzük. Tartalmazza azokat az információkat, amelyeket akkor adott meg, amikor elkezdett létrehozni egy mintaleíró fájlt, azaz a címet, a szerzőt, a dátumot és a kimeneti formátumot.

A „## R Markdown” rész, beleértve a szöveges sorokat is, ennek a lejelölő fájlnak a „szöveg” blokkja. Azt is frissítheti, és elhelyezheti rajta a szövegét. A „## R Markdown” egy címsor, amely szintén frissíthető. A következő három „`” szimbólummal kezdődő rész a „Kóddarab” részt jelöli, amely kifejezetten a kódrészletek hozzáadására szolgál. A kódolási részhez társulhat a „plots” rész is, amely kifejezetten a grafikonok kódokon keresztül történő előállítására szolgál.

A megnyílt RStudio ablak tálcájáról a „Visual” gombbal váltunk át az R Markdown fájl „Visual” üzemmódjába. Az újonnan megnyíló ablak néhány utasítást ad a vizuális módban való mozgáshoz. Érintse meg a „Vizuális mód használata” gombot a vizuális mód megnyitásához.

Szerkessze a mintafájlt

Most elindul az R Markdown mintafájl „Visual” szerkesztési módja. A teljes fájlt formázhatja, beillesztheti és szerkesztheti a tálcán található menük segítségével. Például nem frissítettük a Fejléc részt, de lecseréltük a fejléc címét a „Szöveg” és a „Cselekmények” blokkoknál. Cserélje ki a minta szövegét egy új szövegre, és adjon meg egy új kódot a kódterületen. A fájl „Plot” blokkját oldalirányban is frissítettük.

Mentse el a fájlt

Most használja az RStudio tálcáján található „Knit” gombot a dokumentum létrehozásához.

Most az RStudio kérni fogja a menteni kívánt új Markdown fájl helyét és nevét. Az R Markdown fájl típusa alapértelmezés szerint „.Rmd”. A következő kép szerint „teszt”-nek nevezzük el, és a „Mentés” gombbal mentsük a „D” meghajtóra:

Az újonnan létrehozott R Markdown fájl mentése után az RStudio részt vehet egy kis feldolgozásban a dokumentum megjelenítéséhez. Előtte a következő ablak felbukkanásával kérheti, hogy indítson új munkamenetet. A folytatáshoz érintse meg az „Új munkamenet indítása” gombot:

Tekintse át a Markdown dokumentumot

Egy idő után az RStudio elindítja új munkamenetét az újonnan létrehozott R Markdown dokumentum megnyitásával egy külön ablakban az RStudio-n keresztül. A fájl tartalmazza a „Fejléc” blokkot, a fájl címe „Test”, majd a szerző neve és a létrehozás dátuma. A kód és a diagram blokk 100 százalékban ugyanazt a kimenetet mutatja, mint a „Teszt” kódkimenetben.

Következtetés

Ez az útmutató bemutatja a legjobban az R nyelv használatát egy dokumentum létrehozásához az R Markdown segítségével. A dokumentum beállításától kezdve elmagyaráztuk, hogyan kell szerkeszteni, elmenteni és megnyitni az újonnan létrehozott R Markdown fájlt, és megnézni a fejléc blokkját, szövegblokkját, kóddarab blokkját és plot blokkját.