Cum să vă documentați analiza R fără probleme cu R Markdown

Cum Sa Va Documentati Analiza R Fara Probleme Cu R Markdown



Cu formatul versatil R Markdown, puteți include cu ușurință textul, codul R executabil și rezultatele acestuia într-un singur fișier. Mai multe formate de ieșire statice și dinamice, cum ar fi PDF (.pdf), Word (.docx) și HTML (.html), pot fi ușor transformate din aceste fișiere. Un fișier R Markdown bine scris are avantajul de a fi reproductibil. Acest lucru implică, de asemenea, că puteți reconstrui lucrarea fără a modifica fișierul real dacă găsiți o problemă de transcriere a datelor sau aveți posibilitatea de a adăuga informații noi la cercetare. Deoarece RStudio are deja pachetul R markdown încorporat, nu sunt necesari pași preliminari pentru instalarea acestuia.

Cod de testare

Înainte de a începe cu R Markdown, asigurați-vă că aveți R montat în sistem. Odată cu asta, RStudio ar trebui să fie lansat în acest moment. Mai întâi, creăm un script pentru setul de date pe care îl folosim în fișierul R Markdown.

Importăm biblioteca „seturi de date” din R în zona codului sursă. Seturile de date încorporate pot fi preluate folosind această bibliotecă. Deci, setul de date numit „AirPassengers” este preluat folosind funcția „date” și este rezumat folosind funcția „rezumat”.







În cele din urmă, funcția plot() este aplicată acestui set de date pentru a obține o vizualizare grafică/grafică a setului de date particular. După rularea acestui cod, obținem rezumatul acestui set de date care este afișat pe consolă.



bibliotecă ( seturi de date )

date ( „Pasageri ai aerului” )

rezumat ( Pasagerii aerian )

complot ( Pasagerii aerian )



În panoul din dreapta al RStudio, puteți vedea și graficul pentru setul de date AirPassengers. Acum, folosim acest cod în documentul nostru R Markdown.





Noțiuni introductive cu R MarkDown în RStudio

Pentru a iniția un fișier R Markdown, trebuie să utilizați meniul „Fișier” din fereastra din stânga sus a RStudio. Atingeți-l și extindeți opțiunea „Fișier nou” disponibilă. În opțiunea „Fișier nou”, puteți găsi opțiunea „R Markdown” listată. Atingeți-l pentru a crea unul.



O nouă fereastră „New R Markdown” va apărea pe ecranul RStudio. Deoarece dorim să creăm un document R Markdown, trebuie să selectăm „Document” din panoul din stânga. Acum, puteți denumi documentul folosind câmpul „Titlu”; l-am numit „Test”.

De asemenea, puteți furniza numele dvs. ca autor al acestui document, adică „Ioan”. În ultimul câmp, trebuie să furnizați data când ați creat documentul R Markdown. De asemenea, puteți utiliza caseta de selectare pentru a reda data unui document de fiecare dată când îl actualizați.

Acum, trebuie să selectați formatul implicit de ieșire al fișierului, adică html, pdf sau Word. În cazul nostru, selectăm „HTML” ca format implicit de ieșire pentru fișier. Atingeți butonul „OK” pentru a continua crearea unui exemplu de fișier R Markdown. De asemenea, puteți utiliza butonul „Creați document gol” pentru a crea un fișier Markdown gol.

Comutați la modul vizual pentru editare

Exemplul de fișier R Markdown este deschis în zona Sursă RStudio. Acum, puteți edita acest exemplu de fișier Markdown în funcție de nevoile dvs. Acest fișier eșantion Markdown este împărțit în trei părți. Partea care începe și se termină cu „—” se numește „Header” al fișierului Markdown. Include informațiile pe care le-ați furnizat în timp ce începeți să creați un exemplu de fișier de reducere, adică titlul, autorul, data și formatul de ieșire.

Partea „## R Markdown”, inclusiv liniile de text, este blocul „text” al acestui fișier de markdown. De asemenea, îl puteți actualiza și pune textul pe el. „## R Markdown” este un titlu care poate fi, de asemenea, actualizat. Următoarea parte care începe cu trei simboluri „“`” denotă partea „Code Chunk” care este specifică pentru adăugarea fragmentelor de cod. Partea de codificare poate fi însoțită și de partea „ploturi” care este specifică pentru generarea de grafice prin coduri.

Trecem la modul „Vizual” al fișierului R Markdown folosind butonul „Vizual” din bara de activități a ferestrei RStudio deschise. Fereastra recent deschisă vă oferă câteva instrucțiuni despre deplasarea în modul vizual. Atingeți butonul „Utilizați modul vizual” pentru a deschide modul vizual.

Editați fișierul de probă

Acum, este lansat modul de editare „Vizual” pentru fișierul exemplu R Markdown. Puteți formata, insera și edita întregul fișier folosind meniurile furnizate din bara de activități. De exemplu, nu am actualizat partea Header, dar am înlocuit titlurile antetului pentru blocurile „Text” și „Plots”. Înlocuiți textul eșantion cu un text nou și furnizați un cod nou în zona de cod. Am actualizat și blocul „Plot” al acestui fișier în lateral.

Salvați fișierul

Acum, utilizați butonul „Knit” care este furnizat în bara de activități a RStudio pentru a genera un document.

Acum, RStudio vă va cere locația și numele unui nou fișier Markdown pe care urmează să-l salvați. Tipul fișierului R Markdown este „.Rmd” în mod implicit. Îl denumim „test” conform imaginii următoare și îl salvăm pe unitatea „D” prin butonul „Salvare”:

După salvarea fișierului R Markdown nou generat, RStudio s-ar putea implica într-o mică procesare pentru a afișa documentul. Înainte de aceasta, s-ar putea să vă solicite să începeți o nouă sesiune afișând următoarea fereastră. Atingeți „Începe o nouă sesiune” pentru a continua:

Examinați documentul Markdown

După un timp, RStudio începe noua sa sesiune împreună cu deschiderea documentului R Markdown nou creat într-o fereastră separată prin RStudio. Fișierul conține blocul „Header” cu titlul unui fișier ca „Test”, urmat de numele autorului și data creării. Blocul de cod și diagramă arată 100% aceeași ieșire care este afișată în ieșirea codului „Test”.

Concluzie

Acest ghid oferă cea mai bună demonstrație a utilizării limbajului R pentru a crea un document prin intermediul R Markdown. Începând cu configurarea documentului, am explicat cum să editați, să salvați și să deschideți fișierul R Markdown nou generat și să aruncăm o privire la blocul de antet, blocul de text, blocul de fragmente de cod și blocul de diagramă.