Com documentar la vostra anàlisi R perfectament amb R Markdown

Com Documentar La Vostra Analisi R Perfectament Amb R Markdown



Amb el versàtil format R Markdown, podeu incloure fàcilment el text, el codi R executable i els seus resultats en un sol fitxer. A partir d'aquests fitxers, es poden transformar fàcilment diversos formats de sortida estàtics i dinàmics, com ara PDF (.pdf), Word (.docx) i HTML (.html). Un fitxer R Markdown ben escrit té l'avantatge de ser reproduïble. Això també implica que podeu reconstruir el document sense canviar el fitxer real si trobeu un problema de transcripció de dades o teniu la possibilitat d'afegir nova informació a la recerca. Com que RStudio ja té el paquet R Markdown integrat, no calen passos previs per a la seva instal·lació.

Codi de prova

Abans de començar amb R Markdown, assegureu-vos que teniu R muntat al vostre sistema. Juntament amb això, RStudio s'hauria de llançar en aquest moment. Primer, creem un script per al conjunt de dades que fem servir al fitxer R Markdown.

Importem la biblioteca 'conjunts de dades' de R dins de l'àrea del codi font. Els conjunts de dades integrats es poden obtenir mitjançant aquesta biblioteca. Per tant, el conjunt de dades anomenat 'AirPassengers' s'obté mitjançant la funció 'dades' i es resumeix mitjançant la funció 'resum'.







Al final, la funció plot() s'aplica a aquest conjunt de dades per obtenir una vista gràfica/gràfica del conjunt de dades particular. Després d'executar aquest codi, obtenim el resum d'aquest conjunt de dades que es mostra a la consola.



biblioteca ( conjunts de dades )

dades ( 'AirPassengers' )

resum ( AirPassengers )

parcel · la ( AirPassengers )



Al panell dret de RStudio, també podeu veure la trama del conjunt de dades d'AirPassengers. Ara, utilitzem aquest codi al nostre document R Markdown.





Com començar amb R MarkDown a RStudio

Per iniciar un fitxer R Markdown, heu d'utilitzar el menú 'Fitxer' de la finestra superior esquerra de RStudio. Toqueu-lo i amplieu l'opció 'Fitxer nou' disponible. Dins de l'opció 'Fitxer nou', podeu trobar l'opció 'R Markdown' a la llista. Toqueu-lo per crear-ne un.



Apareixerà una nova finestra 'New R Markdown' a la pantalla de RStudio. Com que volem crear un document R Markdown, hem de seleccionar 'Document' al panell esquerre. Ara, podeu anomenar el vostre document mitjançant el camp 'Títol'; el vam anomenar 'Prova'.

A més, podeu proporcionar el vostre nom com a autor d'aquest document, és a dir, 'Joan'. A l'últim camp, heu de proporcionar la data en què vau crear el document R Markdown. També podeu utilitzar la casella de selecció per representar la data d'un document cada vegada que l'actualitzeu.

Ara, heu de seleccionar el format de sortida predeterminat del vostre fitxer, és a dir, html, pdf o Word. En el nostre cas, seleccionem 'HTML' com a format de sortida predeterminat per al fitxer. Toqueu el botó 'D'acord' per continuar creant un fitxer R Markdown de mostra. També podeu utilitzar el botó 'Crea un document buit' per crear un fitxer Markdown buit.

Canvia al mode visual per editar

El fitxer R Markdown de mostra s'obre a l'àrea Font de RStudio. Ara, podeu editar aquest fitxer de mostra Markdown segons les vostres necessitats. Aquest fitxer de mostra Markdown es divideix en tres parts. La part que comença i acaba amb el '—' s'anomena 'Capçalera' del fitxer Markdown. Inclou la informació que heu proporcionat mentre començava a crear un fitxer de reducció de mostra, és a dir, títol, autor, data i format de sortida.

La part '## R Markdown', incloses les línies de text, és el bloc 'text' d'aquest fitxer de reducció. També podeu actualitzar-lo i col·locar-hi el vostre text. El '## R Markdown' és un encapçalament que també es pot actualitzar. La següent part que comença amb tres símbols ''`' indica la part 'Code Chunk' que és específica per afegir els fragments de codi. La part de codificació també pot anar acompanyada de la part 'trama' específica per generar gràfics a través de codis.

Canviem al mode 'Visual' del fitxer R Markdown mitjançant el botó 'Visual' de la barra de tasques de la finestra oberta de RStudio. La finestra que s'obre recentment us proporciona algunes instruccions sobre com moureu-vos dins del mode visual. Toqueu el botó 'Utilitza el mode visual' per obrir el mode visual.

Editeu el fitxer de mostra

Ara, s'inicia el mode d'edició 'Visual' per al fitxer de mostra R Markdown. Podeu formatar, inserir i editar tot el fitxer mitjançant els menús proporcionats a la barra de tasques. Per exemple, no hem actualitzat la part de la capçalera, però hem substituït els títols de la capçalera pels blocs 'Text' i 'Plots'. Substituïu el text de mostra per un text nou i proporcioneu un codi nou a l'àrea de codi. També hem actualitzat el bloc 'Traça' d'aquest fitxer de costat.

Desa el fitxer

Ara, utilitzeu el botó 'Teixit' que es proporciona a la barra de tasques de RStudio per generar un document.

Ara, RStudio us demanarà la ubicació i el nom d'un nou fitxer Markdown que deseu. El tipus de fitxer R Markdown és '.Rmd' per defecte. L'anomenem 'prova' segons la imatge següent i el desem a la unitat 'D' mitjançant el botó 'Desa':

Després de desar el fitxer R Markdown recentment generat, RStudio podria participar en un petit processament per mostrar el document. Abans d'això, pot ser que us demani que inicieu una sessió nova amb la finestra següent. Toqueu 'Iniciar una nova sessió' per continuar:

Reviseu el document Markdown

Després d'un temps, RStudio comença la seva nova sessió juntament amb l'obertura del document R Markdown acabat de crear en una finestra separada a través de RStudio. El fitxer conté el seu bloc 'Capçalera' amb el títol d'un fitxer com a 'Prova' seguit del nom de l'autor i la data de creació. El bloc de codi i trama mostra la mateixa sortida al 100% que es mostra a la sortida del codi 'Prova'.

Conclusió

Aquesta guia ofereix la millor demostració de l'ús del llenguatge R per crear un document mitjançant el R Markdown. Començant amb la configuració del document, vam explicar com editar, desar i obrir el fitxer R Markdown recentment generat i fer una ullada al seu bloc de capçalera, bloc de text, bloc de fragments de codi i bloc de traçat.