Kā nemanāmi dokumentēt savu R analīzi, izmantojot R Markdown

Ka Nemanami Dokumentet Savu R Analizi Izmantojot R Markdown



Izmantojot daudzpusīgo R Markdown formātu, varat viegli iekļaut tekstu, izpildāmo R kodu un tā rezultātus vienā failā. No šiem failiem var viegli pārveidot vairākus statiskus un dinamiskus izvades formātus, piemēram, PDF (.pdf), Word (.docx) un HTML (.html). Labi uzrakstīta R Markdown faila priekšrocība ir tā, ka to var reproducēt. Tas nozīmē arī to, ka varat atjaunot darbu, nemainot reālo failu, ja konstatējat datu pārrakstīšanas problēmu vai varat pētījumam pievienot jaunu informāciju. Tā kā RStudio jau ir iebūvēta R markdown pakotne, tās instalēšanai nav nepieciešamas nekādas iepriekšējas darbības.

Pārbaudes kods

Pirms sākat lietot R Markdown, pārliecinieties, vai jūsu sistēmā ir uzstādīts R. Līdz ar to šobrīd vajadzētu palaist RStudio. Vispirms mēs izveidojam skriptu datu kopai, ko izmantojam failā R Markdown.

Mēs importējam “datu kopu” bibliotēku no R avota koda apgabalā. Iebūvētās datu kopas var iegūt, izmantojot šo bibliotēku. Tātad datu kopa ar nosaukumu “AirPassengers” tiek iegūta, izmantojot funkciju “data”, un tiek apkopota, izmantojot funkciju “kopsavilkums”.







Galu galā šai datu kopai tiek lietota funkcija plot(), lai iegūtu konkrētās datu kopas diagrammu/diagrammu. Pēc šī koda palaišanas mēs iegūstam šīs datu kopas kopsavilkumu, kas tiek parādīts konsolē.



bibliotēka ( datu kopas )

datus ( 'Avio pasažieri' )

kopsavilkums ( Gaisa pasažieri )

sižetu ( Gaisa pasažieri )



RStudio labajā rūtī varat redzēt arī AirPassengers datu kopas diagrammu. Tagad mēs izmantojam šo kodu savā R Markdown dokumentā.





Darba sākšana ar R MarkDown programmā RStudio

Lai sāktu R Markdown failu, RStudio augšējā kreisajā logā ir jāizmanto izvēlne “Fails”. Pieskarieties tam un izvērsiet pieejamo opciju “Jauns fails”. Opcijā “Jauns fails” varat atrast opciju “R Markdown”. Pieskarieties tam, lai to izveidotu.



Jūsu RStudio ekrānā parādīsies jauns logs “New R Markdown”. Tā kā mēs vēlamies izveidot R Markdown dokumentu, mums kreisajā rūtī ir jāizvēlas “Dokuments”. Tagad varat nosaukt dokumentu, izmantojot lauku “Nosaukums”; mēs to nosaucām par 'pārbaudi'.

Varat arī norādīt savu kā šī dokumenta autora vārdu, t.i., “Jānis”. Pēdējā laukā jānorāda datums, kad izveidojāt R Markdown dokumentu. Varat arī izmantot izvēles rūtiņu, lai atveidotu dokumenta datumu katru reizi, kad to atjaunina.

Tagad jums ir jāizvēlas faila noklusējuma izvades formāts, t.i., html, pdf vai Word. Mūsu gadījumā mēs izvēlamies “HTML” kā noklusējuma izvades formātu failam. Pieskarieties pogai “OK”, lai turpinātu R Markdown faila parauga izveidi. Varat arī izmantot pogu “Izveidot tukšu dokumentu”, lai izveidotu tukšu Markdown failu.

Rediģēšanai pārslēdzieties uz vizuālo režīmu

R Markdown faila paraugs tiek atvērts apgabalā RStudio Source. Tagad varat rediģēt šo Markdown faila paraugu atbilstoši savām vajadzībām. Šis Markdown parauga fails ir sadalīts trīs daļās. Daļa, kas sākas un beidzas ar “—”, tiek saukta par Markdown faila “galveni”. Tajā ir iekļauta informācija, ko norādījāt, kad sākat veidot atzīmes faila paraugu, t.i., nosaukums, autors, datums un izvades formāts.

Daļa “## R Markdown”, ieskaitot teksta rindiņas, ir šī atzīmes faila “teksta” bloks. Varat arī to atjaunināt un ievietot tajā savu tekstu. “## R Markdown” ir virsraksts, kuru var arī atjaunināt. Nākamā daļa, kas sākas ar trim “`” simboliem, apzīmē daļu “Koda fragments”, kas ir specifiska koda fragmentu pievienošanai. Kodēšanas daļai var pievienot arī daļu “sižeti”, kas ir specifiska grafiku ģenerēšanai, izmantojot kodus.

Mēs pārslēdzamies uz R Markdown faila režīmu “Visual”, izmantojot pogu “Visual” no atvērtā RStudio loga uzdevumjoslas. Tikko atvērtajā logā ir sniegti daži norādījumi par pārvietošanos vizuālajā režīmā. Pieskarieties pogai “Izmantot vizuālo režīmu”, lai atvērtu vizuālo režīmu.

Rediģējiet parauga failu

Tagad tiek palaists R Markdown parauga faila rediģēšanas režīms “Vizuālais”. Varat formatēt, ievietot un rediģēt visu failu, izmantojot uzdevumjoslas piedāvātās izvēlnes. Piemēram, mēs neatjauninājām galvenes daļu, bet nomainījām galvenes nosaukumus blokiem “Teksts” un “Zīmes”. Aizstājiet parauga tekstu ar jaunu tekstu un koda apgabalā norādiet jaunu kodu. Mēs arī atjauninājām šī faila bloku “Plot” sāniski.

Saglabājiet failu

Tagad izmantojiet pogu “Adīt”, kas atrodas RStudio uzdevumjoslā, lai ģenerētu dokumentu.

Tagad RStudio jautās jauna Markdown faila atrašanās vietu un nosaukumu, kuru plānojat saglabāt. R Markdown faila veids pēc noklusējuma ir “.Rmd”. Mēs to nosaucam par “pārbaudi”, kā norādīts nākamajā attēlā, un saglabājam to “D” diskdzinī, izmantojot pogu “Saglabāt”.

Pēc jaunizveidotā R Markdown faila saglabāšanas RStudio var iesaistīties nelielā apstrādē, lai parādītu dokumentu. Pirms tam tas var lūgt sākt jaunu sesiju, atverot šādu logu. Pieskarieties “Sākt jaunu sesiju”, lai turpinātu:

Pārskatiet Markdown dokumentu

Pēc kāda laika RStudio sāk savu jauno sesiju kopā ar jaunizveidotā R Markdown dokumenta atvēršanu atsevišķā logā, izmantojot RStudio. Failā ir bloks “Galvene” ar faila nosaukumu “Pārbaude”, kam seko autora vārds un izveides datums. Koda un diagrammas bloks parāda 100% tādu pašu izvadi, kas tiek parādīta koda izvadē “Pārbaude”.

Secinājums

Šī rokasgrāmata sniedz vislabāko R valodas lietošanas demonstrāciju, lai izveidotu dokumentu, izmantojot R Markdown. Sākot ar dokumenta iestatīšanu, mēs paskaidrojām, kā rediģēt, saglabāt un atvērt tikko ģenerēto R Markdown failu, kā arī apskatīt tā galvenes bloku, teksta bloku, koda daļu bloku un diagrammas bloku.