Complete Guide to Editing Legend Text Labels in ggplot2: From Data Reshaping to Customization

Data Reshaping: The Key Step to Solving Legend Display Issues

In ggplot2 data visualization, incorrect display of legend text labels is a common technical challenge. The root cause often lies in the adaptability of data structure. Original data is typically stored in wide format, where different variables reside in separate columns. While this structure facilitates data management, it can lead to abnormal legend display in ggplot2's plotting system.

Consider the following typical data structure example:

T999 <- runif(10, 100, 200)
T888 <- runif(10, 200, 300)
TY <- runif(10, 20, 30)
df <- data.frame(T999, T888, TY)

This wide-format data contains three independent numerical vectors, each representing different temperature measurements. When attempting to create scatter plots directly with this data structure, ggplot2 cannot automatically recognize the relationships between these variables, resulting in incorrect legend label display.

Data Transformation: From Wide Format to Long Format

The core solution to legend display issues lies in data reshaping. By using the melt function from the reshape2 package, wide-format data can be converted to long format, which is a more manageable data structure for ggplot2. The data transformation process is as follows:

library(reshape2)
dfm <- melt(df, id = "TY")

The transformed dataframe dfm will contain three key columns: TY (identifier variable), variable (grouping variable), and value (numerical variable). This long-format data structure enables ggplot2 to correctly identify different data series and generate corresponding legend entries for each series.

Correct Plot Implementation

Using the transformed long-format data, correct scatter plots can be constructed with precise control over legend labels:

ggplot(data = dfm, aes(x = TY, y = value, color = variable)) + 
  geom_point(size = 5) +
  labs(title = "Temperature Distribution", x = "TY [°C]", y = "Txxx", color = "Temperature Type") +
  scale_color_manual(labels = c("T999", "T888"), values = c("blue", "red")) +
  theme_bw() +
  theme(axis.text.x = element_text(size = 14), 
        axis.title.x = element_text(size = 16),
        axis.text.y = element_text(size = 14), 
        axis.title.y = element_text(size = 16),
        plot.title = element_text(size = 20, face = "bold", color = "darkgreen"))

In this implementation, the color parameter in the aes function is mapped to the variable column, allowing ggplot2 to automatically generate legends based on data grouping. The scale_color_manual function provides precise control over legend labels and colors.

Advanced Legend Customization Techniques

Beyond basic label modification, ggplot2 offers rich legend customization options. The guides function can further adjust legend display characteristics:

ggplot(data = dfm, aes(x = TY, y = value, color = variable)) + 
  geom_point(size = 5) +
  labs(title = "Temperature Distribution", x = "TY [°C]", y = "Txxx") +
  scale_color_manual(labels = c("T999", "T888"), values = c("blue", "red")) +
  theme_bw() +
  guides(color = guide_legend("Custom Legend Title"))

For cases where only label modification is needed without changing colors, the scale_color_hue function can be used:

ggplot(data = dfm, aes(x = TY, y = value, color = variable)) + 
  geom_point(size = 5) +
  scale_color_hue(labels = c("T999", "T888"))

Legend Position and Theme Optimization

Legend position adjustment is crucial for the overall effectiveness of data visualization. ggplot2 provides flexible legend positioning options:

# Position legend at top
theme(legend.position = "top")

# Precise positioning using coordinates
theme(legend.position = c(0.8, 0.2),
      legend.direction = "horizontal")

The visual style of legends can also be detailed customized through the theme function, including font size, color, background, and other properties:

theme(legend.title = element_text(color = "blue", size = 12),
      legend.text = element_text(color = "darkgray"),
      legend.background = element_rect(fill = "lightgray"),
      legend.key = element_rect(fill = "white"))

Managing Multiple Legends

In complex data visualizations, multiple legends may coexist. The guides function is essential for coordinating the display of various legends:

# Adjust display order of multiple legends
guides(color = guide_legend(order = 1),
       size = guide_legend(order = 2),
       shape = guide_legend(order = 3))

# Hide specific legends
guides(color = FALSE, size = FALSE)

Best Practices Summary

Successful ggplot2 legend customization requires adherence to several key principles. First, ensure the data structure suits plotting needs, performing wide-to-long format conversion when necessary. Second, understand the relationship between aesthetic mapping and legend generation, correctly using color, fill, and other parameters. Finally, master the use of functions like scale_*_manual and guides to achieve precise legend control.

By systematically applying these techniques, users can create both aesthetically pleasing and informative visualizations that effectively communicate the stories behind the data. The strength of ggplot2 lies in its consistency and extensibility—once the basic principles of legend customization are mastered, various complex data visualization requirements can be easily addressed.