How to Create Heatmap with ggplot2 in R

To create a heatmap in ggplot2, use geom_tile() with aesthetics aes(x, y, fill) where fill represents the values to color. Prepare your data in a long format with x and y variables and a value to map colors.

Syntax

The basic syntax for creating a heatmap with ggplot2 is:

• ggplot(data, aes(x, y, fill = value)): sets the data and maps x, y, and fill color.
• geom_tile(): draws colored tiles for each x-y pair.
• scale_fill_gradient() or scale_fill_gradient2(): controls the color gradient.

r

ggplot(data, aes(x, y, fill = value)) +
  geom_tile() +
  scale_fill_gradient(low = "color1", high = "color2")

Example

This example shows how to create a heatmap of values for combinations of two variables using geom_tile() and a blue-to-red color gradient.

r

library(ggplot2)

# Sample data frame in long format
data <- data.frame(
  x = rep(1:5, each = 5),
  y = rep(1:5, times = 5),
  value = runif(25, min = 0, max = 10)
)

# Create heatmap
heatmap_plot <- ggplot(data, aes(x = factor(x), y = factor(y), fill = value)) +
  geom_tile() +
  scale_fill_gradient(low = "blue", high = "red") +
  labs(title = "Heatmap Example", x = "X Axis", y = "Y Axis", fill = "Value") +
  theme_minimal()

print(heatmap_plot)

Output

[A heatmap plot showing a 5x5 grid with tiles colored from blue (low) to red (high) based on random values]

Common Pitfalls

Common mistakes when creating heatmaps with ggplot2 include:

• Not converting x and y to factors, which can cause unexpected axis ordering.
• Using wide format data instead of long format, which ggplot2 does not handle directly for heatmaps.
• Not setting a color scale, resulting in default colors that may be hard to interpret.

Example of a common mistake and fix:

r

# Wrong: x and y as numeric without factor conversion
# This can cause axis labels to be continuous and not discrete tiles

# Wrong approach
# ggplot(data, aes(x = x, y = y, fill = value)) + geom_tile()

# Correct approach
# ggplot(data, aes(x = factor(x), y = factor(y), fill = value)) + geom_tile()

Quick Reference

Function	Purpose
ggplot(data, aes(x, y, fill = value))	Set data and map x, y, and fill color
geom_tile()	Draw colored tiles for heatmap cells
scale_fill_gradient(low, high)	Set color gradient from low to high values
factor()	Convert numeric variables to categorical for proper axis display
labs()	Add titles and axis labels

Key Takeaways

Use geom_tile() with aes(x, y, fill) to create heatmap tiles in ggplot2.

Convert x and y variables to factors to ensure correct axis labeling.

Prepare data in long format with columns for x, y, and value.

Use scale_fill_gradient() to customize the color scheme for better visualization.

Avoid using wide format data directly; reshape it to long format first.