Comment utiliser la fonction text() dans R pour ajouter du texte au tracé

Vous pouvez utiliser la fonction text() pour ajouter du texte à un tracé en base R.

Cette fonction utilise la syntaxe de base suivante :

texte(x, y, « mon texte »)

où:

• x, y : Les coordonnées (x, y) où le texte doit être placé.

Les exemples suivants montrent comment utiliser cette fonction dans la pratique.

Exemple 1 : ajouter un élément de texte au tracé

Le code suivant montre comment utiliser text() pour ajouter un élément de texte à un tracé aux coordonnées (x, y) de (5, 18) :

#create data frame with values to plot
df <- data.frame(x=c(1, 4, 7, 8, 8, 10),
                 y=c(4, 9, 16, 14, 12, 20))

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

#add text element at (5, 18)
text(x=5, y=18, "this is my text")

Notez que notre élément de texte a été ajouté aux coordonnées (x, y) de (5, 18) dans le tracé.

Exemple 2 : ajouter plusieurs éléments de texte au tracé

Pour ajouter plusieurs éléments de texte à un tracé, nous pouvons simplement utiliser plusieurs fonctions text() :

#create data frame with values to plot
df <- data.frame(x=c(1, 4, 7, 8, 8, 10),
                 y=c(4, 9, 16, 14, 12, 20))

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

#add text elements
text(x=5, y=18, "first text")
text(x=5, y=10, "second text") 
text(x=5, y=5, "third text") 

Notez que trois éléments de texte ont été ajoutés au tracé, chacun aux coordonnées (x, y) que nous avons spécifiées.

Exemple 3 : Personnaliser les éléments de texte dans le tracé

Nous pouvons utiliser les arguments cex , col et font pour personnaliser respectivement la taille, la couleur et le style de police des éléments de texte dans le tracé :

#create data frame with values to plot
df <- data.frame(x=c(1, 4, 7, 8, 8, 10),
                 y=c(4, 9, 16, 14, 12, 20))

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

#add text elements with custom appearance
text(x=5, y=18, "first text", col='red')
text(x=5, y=10, "second text", col='blue', cex=3) 
text(x=5, y=5, "third text", col='green', cex=5, font=3) 

Notez que chacun des trois éléments de texte a une apparence personnalisée.

Notez également que l’argument font prend quatre valeurs possibles :

• 1 : uni
• 2 : gras
• 3 : italique
• 4 : gras-italique

Puisque nous avons spécifié font=3 pour notre troisième élément de texte, la police est en italique.

Exemple 4 : ajouter des étiquettes de texte à chaque point du tracé

Nous pouvons utiliser les arguments labels pour ajouter une étiquette de texte à chaque point du tracé :

#create data frame with values to plot
df <- data.frame(teams=c('A', 'B', 'C', 'D', 'E', 'F'),
                 x=c(1, 4, 7, 8, 8, 10),
                 y=c(4, 9, 16, 14, 12, 20))

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

#add text label to each point in plot
text(df$x, df$y, labels=df$teams, pos=4)

Notez que chacun des points du tracé possède désormais une étiquette de texte.

Notez également que l’argument pos contrôle l’endroit où l’étiquette de texte est placée par rapport au point et prend quatre valeurs possibles :

• 1 : sous le texte
• 2 : à gauche du texte
• 3 : au-dessus du texte
• 4 : droit du texte

Puisque nous avons spécifié pos=4, chaque étiquette de texte est placée à droite des points du tracé.

Ressources additionnelles

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

Comment utiliser les fonctions coller et coller0 dans R
Comment utiliser la fonction replace() dans R
Comment utiliser la fonction View() dans R