Plotly分类热图注释对角线分布的原因及优化方案

问题原因 #

你遇到的注释错位问题，核心是一维向量的填充逻辑不匹配：

• 当你给z传入一维向量c(1:4)时，Plotly会默认按列优先的规则把它转换成矩阵，也就是先填满第一列的所有行，再填第二列。对应到你的x/y分类，生成的热图数值分布是：

  	Blue	Red
  One	1	3
  Two	2	4

• 但add_annotations在没有明确指定x和y的情况下，会按行优先的顺序去分配注释文本，也就是先遍历第一行的所有列，再遍历第二行。这就导致注释和单元格的数值完全错位，出现1、3挤在左下角，2、4在右上角的情况。

调整方案 #

有两种简单的方式可以让注释按直观的水平/垂直顺序排列：

方案1：用矩阵明确对应关系

把z和注释文本都转换成行优先的矩阵，让每个单元格的数值和注释一一对应，Plotly会自动识别这种结构：

library(plotly)
x <- c("Blue", "Red")
y <- c("One", "Two")

# 按行优先创建数值矩阵和注释矩阵
z_matrix <- matrix(c(1:4), nrow = length(y), ncol = length(x), byrow = TRUE)
text_matrix <- matrix(as.character(c(1:4)), nrow = length(y), ncol = length(x), byrow = TRUE)

plot_ly(x = x, y = y, z = z_matrix) %>% 
  add_heatmap(opacity = 0.9) %>% 
  add_annotations(text = text_matrix, showarrow = FALSE)

这样生成的热图里，注释会按One行的Blue→Red（1→2）、Two行的Blue→Red（3→4）的水平顺序排列。

方案2：明确指定注释的x/y坐标

如果不想用矩阵，也可以手动给每个注释指定对应的x和y分类，确保文本精准匹配到目标单元格：

library(plotly)
x <- c("Blue", "Red")
y <- c("One", "Two")

plot_ly(x = x, y = y, z = c(1:4)) %>% 
  add_heatmap(opacity = 0.9) %>% 
  add_annotations(
    x = rep(x, each = length(y)),  # 每个x分类对应所有y分类
    y = rep(y, length(x)),         # 重复y分类匹配每个x
    text = c(1:4), 
    showarrow = FALSE
  )

这种方式也能让注释准确对应到每个单元格，实现直观的排列效果。

内容的提问来源于stack exchange，提问作者Justin Sleep