Code d'essai
Avant de commencer avec R Markdown, assurez-vous que R est monté sur votre système. Parallèlement à cela, RStudio devrait être lancé en ce moment. Tout d'abord, nous créons un script pour l'ensemble de données que nous utilisons dans le fichier R Markdown.
Nous importons la bibliothèque « datasets » de R dans la zone du code source. Les ensembles de données intégrés peuvent être récupérés à l'aide de cette bibliothèque. Ainsi, l'ensemble de données nommé « AirPassengers » est récupéré à l'aide de la fonction « données » et est résumé à l'aide de la fonction « résumé ».
En fin de compte, la fonction plot() est appliquée à cet ensemble de données pour obtenir une vue graphique/tracé de l'ensemble de données particulier. Après avoir exécuté ce code, nous obtenons le résumé de cet ensemble de données qui s'affiche sur la console.
bibliothèque ( ensembles de données )
données ( 'Passagers aériens' )
résumé ( Passagers aériens )
parcelle ( Passagers aériens )
Dans le volet droit de RStudio, vous pouvez également voir apparaître le tracé de l'ensemble de données AirPassengers. Maintenant, nous utilisons ce code dans notre document R Markdown.
Premiers pas avec R MarkDown dans RStudio
Pour lancer un fichier R Markdown, vous devez utiliser le menu « Fichier » dans la fenêtre supérieure gauche de RStudio. Appuyez dessus et développez l'option « Nouveau fichier » disponible. Dans l'option « Nouveau fichier », vous pouvez trouver l'option « R Markdown » répertoriée. Appuyez dessus pour en créer un.
Une nouvelle fenêtre « New R Markdown » apparaîtra sur votre écran RStudio. Comme nous voulons créer un document R Markdown, nous devons sélectionner « Document » dans le volet de gauche. Maintenant, vous pouvez nommer votre document en utilisant le champ « Titre » ; nous l'avons nommé « Test ».
Vous pouvez également indiquer votre nom en tant qu'auteur de ce document, c'est-à-dire « John ». Dans le dernier champ, vous devez fournir la date à laquelle vous avez créé le document R Markdown. Vous pouvez également utiliser la case à cocher pour afficher la date d'un document chaque fois que vous le mettez à jour.
Maintenant, vous devez sélectionner le format de sortie par défaut de votre fichier, c'est-à-dire HTML, PDF ou Word. Dans notre cas, nous sélectionnons « HTML » comme format de sortie par défaut du fichier. Appuyez sur le bouton « OK » pour continuer à créer un exemple de fichier R Markdown. Vous pouvez également utiliser le bouton « Créer un document vide » pour créer un fichier Markdown vide.
Passer en mode visuel pour l'édition
L'exemple de fichier R Markdown est ouvert dans la zone RStudio Source. Vous pouvez désormais modifier cet exemple de fichier Markdown en fonction de vos besoins. Cet exemple de fichier Markdown est divisé en trois parties. La partie qui commence et se termine par le « - » est appelée « En-tête » du fichier Markdown. Il comprend les informations que vous avez fournies lorsque vous commencez à créer un exemple de fichier de démarque, c'est-à-dire le titre, l'auteur, la date et le format de sortie.
La partie « ## R Markdown », y compris les lignes de texte, est le bloc « texte » de ce fichier markdown. Vous pouvez également le mettre à jour et y placer votre texte. Le « ## R Markdown » est une rubrique qui peut également être mise à jour. La partie suivante commençant par trois symboles « « ` » désigne la partie « Code Chunk » spécifique à l'ajout d'extraits de code. La partie codage peut également être accompagnée de la partie « plots » spécifique à la génération de graphiques à travers des codes.
On passe au mode « Visuel » du fichier R Markdown à l'aide du bouton « Visuel » de la barre des tâches de la fenêtre RStudio ouverte. La fenêtre nouvellement ouverte vous fournit des instructions sur la façon de vous déplacer en mode visuel. Appuyez sur le bouton « Utiliser le mode visuel » pour ouvrir le mode visuel.
Modifier le fichier exemple
Maintenant, le mode d'édition « Visuel » pour l'exemple de fichier R Markdown est lancé. Vous pouvez formater, insérer et modifier l'intégralité du fichier à l'aide des menus fournis dans la barre des tâches. Par exemple, nous n'avons pas mis à jour la partie En-tête mais nous avons remplacé les titres d'En-tête pour les blocs « Texte » et « Parcelles ». Remplacez l'exemple de texte par un nouveau texte et fournissez un nouveau code dans la zone de code. Nous avons également mis à jour latéralement le bloc « Plot » de ce fichier.
Enregistrez le fichier
Maintenant, utilisez le bouton « Tricoter » fourni dans la barre des tâches de RStudio pour générer un document.
Maintenant, RStudio vous demandera l'emplacement et le nom d'un nouveau fichier Markdown que vous allez enregistrer. Le type du fichier R Markdown est « .Rmd » par défaut. Nous le nommons « test » selon l'image suivante et l'enregistrons sur le lecteur « D » via le bouton « Enregistrer » :
Après avoir enregistré votre fichier R Markdown nouvellement généré, RStudio peut être impliqué dans un petit traitement pour afficher le document. Avant cela, il peut vous demander de démarrer une nouvelle session en faisant apparaître la fenêtre suivante. Appuyez sur « Démarrer une nouvelle session » pour continuer :
Consultez le document Markdown
Après un certain temps, RStudio démarre sa nouvelle session avec l'ouverture du document R Markdown nouvellement créé dans une fenêtre séparée via RStudio. Le fichier contient son bloc « En-tête » avec le titre d’un fichier comme « Test » suivi du nom de l’auteur et de la date de création. Le bloc de code et de tracé affiche la même sortie à 100 % que celle affichée dans la sortie de code « Test ».
Conclusion
Ce guide fournit la meilleure démonstration de l'utilisation du langage R pour créer un document via le R Markdown. En commençant par la configuration du document, nous avons expliqué comment modifier, enregistrer et ouvrir le fichier R Markdown nouvellement généré et jeter un œil à son bloc d'en-tête, son bloc de texte, son bloc de fragments de code et son bloc de tracé.