Kod testowy
Przed rozpoczęciem korzystania z R Markdown upewnij się, że masz zainstalowany R w swoim systemie. Wraz z tym powinno zostać uruchomione RStudio. Najpierw tworzymy skrypt dla zbioru danych, którego używamy w pliku R Markdown.
Importujemy bibliotekę „datasets” z R w obszarze kodu źródłowego. Wbudowane zestawy danych można pobrać za pomocą tej biblioteki. Zatem zbiór danych o nazwie „AirPassengers” jest pobierany za pomocą funkcji „data” i podsumowywany za pomocą funkcji „summary”.
Na koniec do tego zbioru danych stosowana jest funkcja plot() w celu uzyskania widoku wykresu/wykresu konkretnego zbioru danych. Po uruchomieniu tego kodu otrzymamy podsumowanie tego zbioru danych, które wyświetli się na konsoli.
biblioteka ( zbiory danych )
dane ( „Pasażerowie lotniczy” )
streszczenie ( Pasażerowie lotniczy )
działka ( Pasażerowie lotniczy )
W prawym okienku RStudio możesz także zobaczyć wykres pojawiającego się zestawu danych AirPassengers. Teraz używamy tego kodu w naszym dokumencie R Markdown.
Pierwsze kroki z R MarkDown w RStudio
Aby zainicjować plik R Markdown, musisz skorzystać z menu „Plik” w lewym górnym oknie RStudio. Stuknij w niego i rozwiń dostępną opcję „Nowy plik”. W opcji „Nowy plik” znajduje się opcja „R Markdown”. Stuknij w niego, aby go utworzyć.
Na ekranie RStudio pojawi się nowe okno „Nowy R Markdown”. Ponieważ chcemy utworzyć dokument R Markdown, musimy wybrać „Dokument” z lewego panelu. Teraz możesz nazwać swój dokument za pomocą pola „Tytuł”; nazwaliśmy to „Testem”.
Możesz także podać swoje imię i nazwisko jako autora tego dokumentu, np. „John”. W ostatnim polu musisz podać datę utworzenia dokumentu R Markdown. Możesz także użyć tego pola wyboru, aby wyświetlić datę dokumentu przy każdej jego aktualizacji.
Teraz musisz wybrać domyślny format wyjściowy pliku, tj. HTML, PDF lub Word. W naszym przypadku wybieramy „HTML” jako domyślny format wyjściowy pliku. Naciśnij przycisk „OK”, aby kontynuować tworzenie przykładowego pliku R Markdown. Możesz także użyć przycisku „Utwórz pusty dokument”, aby utworzyć pusty plik Markdown.
Przejdź do trybu wizualnego w celu edycji
Przykładowy plik R Markdown zostanie otwarty w obszarze źródła RStudio. Teraz możesz edytować ten przykładowy plik Markdown zgodnie ze swoimi potrzebami. Ten przykładowy plik Markdown jest podzielony na trzy części. Część rozpoczynająca się i kończąca „-” nazywana jest „nagłówkiem” pliku Markdown. Zawiera informacje podane podczas tworzenia przykładowego pliku przecen, tj. tytuł, autor, datę i format wyjściowy.
Część „## R Markdown”, w tym linie tekstu, to blok „tekstowy” tego pliku przeceny. Możesz go także zaktualizować i umieścić na nim swój tekst. „## R Markdown” to nagłówek, który również można zaktualizować. Następna część rozpoczynająca się trzema symbolami „`” oznacza część „Kodu”, która jest specyficzna dla dodawania fragmentów kodu. Części kodującej może również towarzyszyć część „wykresy”, która jest specyficzna dla generowania wykresów za pomocą kodów.
Do trybu „Wizualny” pliku R Markdown przełączamy się za pomocą przycisku „Wizualny” z paska zadań otwartego okna RStudio. Nowo otwarte okno zawiera instrukcje dotyczące poruszania się w trybie wizualnym. Naciśnij przycisk „Użyj trybu wizualnego”, aby otworzyć tryb wizualny.
Edytuj przykładowy plik
Teraz zostaje uruchomiony tryb edycji „Wizualny” przykładowego pliku R Markdown. Możesz formatować, wstawiać i edytować cały plik, korzystając z menu dostępnych na pasku zadań. Na przykład nie zaktualizowaliśmy części nagłówka, ale zastąpiliśmy tytuły nagłówków dla bloków „Tekst” i „Wykresy”. Zastąp przykładowy tekst nowym tekstem i wprowadź nowy kod w obszarze kodu. Zaktualizowaliśmy również blok „Fabuła” tego pliku w bok.
Zapisz plik
Teraz użyj przycisku „Dziewnij” znajdującego się na pasku zadań RStudio, aby wygenerować dokument.
Teraz RStudio zapyta Cię o lokalizację i nazwę nowego pliku Markdown, który zamierzasz zapisać. Domyślnym typem pliku R Markdown jest „.Rmd”. Nazywamy go „testem” zgodnie z poniższym obrazkiem i zapisujemy go na dysku „D” za pomocą przycisku „Zapisz”:
Po zapisaniu nowo wygenerowanego pliku R Markdown RStudio może wziąć udział w niewielkim przetwarzaniu w celu wyświetlenia dokumentu. Wcześniej może poprosić Cię o rozpoczęcie nowej sesji, wyświetlając następujące okno. Kliknij „Rozpocznij nową sesję”, aby kontynuować:
Przejrzyj dokument Markdown
Po chwili RStudio rozpoczyna nową sesję wraz z otwarciem nowo utworzonego dokumentu R Markdown w osobnym oknie za pośrednictwem RStudio. Plik zawiera blok „Nagłówek” z tytułem pliku „Test”, po którym następuje nazwisko autora i data utworzenia. Kod i blok wykresu pokazują w 100% takie same dane wyjściowe, jakie są wyświetlane w wynikach kodu „Test”.
Wniosek
Ten przewodnik zapewnia najlepszą demonstrację używania języka R do tworzenia dokumentu za pomocą R Markdown. Zaczynając od skonfigurowania dokumentu, wyjaśniliśmy, jak edytować, zapisać i otworzyć nowo wygenerowany plik R Markdown oraz przyjrzeć się jego blokowi nagłówka, blokowi tekstu, blokowi fragmentów kodu i blokowi wydruku.