Testovací kód
Než začnete s R Markdown, ujistěte se, že máte R nainstalovaný ve vašem systému. Spolu s tím by mělo být v tuto chvíli spuštěno RStudio. Nejprve vytvoříme skript pro datovou sadu, kterou použijeme v souboru R Markdown.
Knihovnu „datových sad“ importujeme z R v oblasti zdrojového kódu. Vestavěné datové sady lze načíst pomocí této knihovny. Takže datová sada s názvem „AirPassengers“ je načtena pomocí funkce „data“ a je shrnuta pomocí funkce „summary“.
Nakonec se na tuto datovou sadu použije funkce plot(), aby se získal graf/graf zobrazení konkrétní datové sady. Po spuštění tohoto kódu získáme souhrn tohoto datového souboru, který se zobrazí na konzole.
knihovna ( datové sady )
data ( 'AirPassengers' )
souhrn ( AirPassengers )
spiknutí ( AirPassengers )
V pravém podokně RStudia můžete také vidět, jak se objevuje graf pro datovou sadu AirPassengers. Nyní tento kód používáme v našem dokumentu R Markdown.
Začínáme s R MarkDown v RStudio
Chcete-li spustit soubor R Markdown, musíte použít nabídku „Soubor“ v levém horním okně RStudia. Klepněte na něj a rozbalte dostupnou možnost „Nový soubor“. V rámci možnosti „Nový soubor“ můžete najít uvedenou možnost „R Markdown“. Klepnutím na něj vytvoříte.
Na obrazovce vašeho RStudia se objeví nové okno „New R Markdown“. Protože chceme vytvořit dokument R Markdown, musíme v levém podokně vybrat „Dokument“. Nyní můžete svůj dokument pojmenovat pomocí pole „Název“; pojmenovali jsme to „Test“.
Můžete také uvést své jméno jako autora tohoto dokumentu, tedy „Jan“. V posledním poli musíte zadat datum, kdy jste vytvořili dokument R Markdown. Můžete také použít zaškrtávací políčko k vykreslení data dokumentu při každé aktualizaci.
Nyní musíte vybrat výchozí výstupní formát souboru, tj. html, pdf nebo Word. V našem případě vybereme „HTML“ jako výchozí výstupní formát souboru. Klepnutím na tlačítko „OK“ pokračujte ve vytváření ukázkového souboru R Markdown. Můžete také použít tlačítko „Vytvořit prázdný dokument“ k vytvoření prázdného souboru Markdown.
Přepněte do vizuálního režimu pro úpravy
Ukázkový soubor R Markdown se otevře v oblasti Zdroj RStudio. Nyní můžete tento ukázkový soubor Markdown upravit podle svých potřeb. Tento ukázkový soubor Markdown je rozdělen do tří částí. Část, která začíná a končí „-“, se nazývá „Záhlaví“ souboru Markdown. Zahrnuje informace, které jste poskytli, když jste začali vytvářet vzorový soubor markdown, tj. název, autor, datum a výstupní formát.
Část „## R Markdown“ včetně textových řádků je „textový“ blok tohoto souboru markdown. Můžete jej také aktualizovat a umístit na něj svůj text. „## R Markdown“ je nadpis, který lze také aktualizovat. Další část začínající třemi symboly „`“ označuje část „Chunk kódu“, která je specifická pro přidávání úryvků kódu. Součástí kódování může být také část „plots“, která je specifická pro generování grafů pomocí kódů.
Přepneme do režimu „Visual“ souboru R Markdown pomocí tlačítka „Visual“ z hlavního panelu otevřeného okna RStudio. Nově otevřené okno vám poskytuje některé pokyny pro pohyb ve vizuálním režimu. Klepnutím na tlačítko „Použít vizuální režim“ otevřete vizuální režim.
Upravte ukázkový soubor
Nyní je spuštěn režim úprav „Visual“ pro ukázkový soubor R Markdown. Celý soubor můžete formátovat, vkládat a upravovat pomocí nabízených nabídek na hlavním panelu. Například jsme neaktualizovali část Header, ale nahradili jsme nadpisy Header pro bloky „Text“ a „Plots“. Nahraďte ukázkový text novým textem a zadejte nový kód do oblasti kódu. Také jsme bokem aktualizovali blok „Plot“ tohoto souboru.
Uložte soubor
Nyní použijte tlačítko „Knit“, které je k dispozici na hlavním panelu RStudia, k vygenerování dokumentu.
Nyní se vás RStudio zeptá na umístění a název nového souboru Markdown, který se chystáte uložit. Typ souboru R Markdown je ve výchozím nastavení „.Rmd“. Pojmenujeme jej „test“ podle následujícího obrázku a uložíme jej na jednotku „D“ pomocí tlačítka „Uložit“:
Po uložení vašeho nově vygenerovaného souboru R Markdown se může RStudio zapojit do malého zpracování dokumentu. Předtím vás může požádat o zahájení nové relace vyskakováním následujícího okna. Klepnutím na „Zahájit novou relaci“ pokračujte:
Přečtěte si dokument Markdown
Po chvíli RStudio zahájí svou novou relaci spolu s otevřením nově vytvořeného dokumentu R Markdown v samostatném okně prostřednictvím RStudio. Soubor obsahuje blok „Header“ s názvem souboru jako „Test“, za kterým následuje jméno autora a datum vytvoření. Kód a blok grafu zobrazují 100 procent stejný výstup, který je zobrazen ve výstupu kódu „Test“.
Závěr
Tato příručka poskytuje nejlepší ukázku použití jazyka R k vytvoření dokumentu pomocí R Markdown. Počínaje nastavením dokumentu jsme vysvětlili, jak upravit, uložit a otevřít nově vygenerovaný soubor R Markdown a podívat se na jeho blok záhlaví, textový blok, blok bloku kódu a blok plotru.