Comment utiliser la fonction mtext dans R (avec exemples)

Vous pouvez utiliser la fonction mtext() dans R pour écrire du texte dans les marges d’un tracé.

Cette fonction utilise la syntaxe de base suivante :

mtext(texte, côté=3, ligne=0, …)

où:

• text : Le texte à écrire
• side : Le côté du tracé sur lequel écrire le texte (1=bas, 2=gauche, 3=haut, 4=droite)
• line : La ligne de marge à utiliser (les valeurs négatives pousseront le texte à l’intérieur du tracé)

Les exemples suivants montrent comment utiliser la fonction mtext() en pratique avec le bloc de données suivant dans R :

#create data frame
df <- data.frame(x=c(1, 2, 3, 4, 5, 6, 7),
                 y=c(3, 4, 4, 8, 6, 10, 14))

#view data frame
df

  x  y
1 1  3
2 2  4
3 3  4
4 4  8
5 5  6
6 6 10
7 7 14

Exemple 1 : ajouter un élément de texte en dehors du tracé

Le code suivant montre comment utiliser mtext() pour ajouter un élément de texte au-dessus du tracé :

#create scatterplot
plot(df$x, df$y)

#add text above plot
mtext("Here is some text")

Notez que le texte « Voici du texte » a été ajouté au-dessus de l’intrigue.

Exemple 2 : ajouter plusieurs éléments de texte en dehors du tracé

Le code suivant montre comment utiliser la fonction mtext() plusieurs fois pour ajouter des éléments de texte de chaque côté du tracé :

#create scatterplot
plot(df$x, df$y)

#add text on each side of plot
mtext("Text on the bottom", side=1)
mtext("Text on the left", side=2)
mtext("Text on the top", side=3)
mtext("Text on the right", side=4)

En utilisant la fonction mtext() plusieurs fois, nous pouvons ajouter plusieurs éléments de texte en dehors du tracé.

Exemple 3 : ajouter un élément de texte personnalisé en dehors du tracé

Nous pouvons également utiliser les arguments line , cex et col dans mtext() pour modifier respectivement l’emplacement, la taille et la couleur de l’élément de texte.

Par exemple, le code suivant montre comment ajouter du texte juste en haut du tracé avec une taille de police augmentée et une couleur bleue :

#create scatterplot
plot(df$x, df$y)

#add customized text inside top of plot
mtext("Text on the top", side=3, line=-3, cex=3, col='blue')

N’hésitez pas à jouer avec les différents arguments de la fonction mtext() pour générer le texte exact que vous souhaitez dans votre intrigue.

Ressources additionnelles

Les didacticiels suivants expliquent comment utiliser d’autres fonctions courantes dans R :

Comment dessiner une légende en dehors d’un tracé dans R
Comment changer la position de la légende dans les tracés de base R
Comment imprimer une chaîne et une variable sur la même ligne dans R