← All chart types

correlation family

matrix-nxn

Square correlation/relationship grid.

Same set of variables on both axes (n × n), with each cell encoding the relationship — Pearson r, co-occurrence count, or a small chart per cell. Reads diagonally for self-correlations.

When to use

Showing relationships between every pair of variables in a set.

When NOT to use

The two axes are different sets (use heatmap or marimekko).

Rhetorical roles

  • correlate

Variants & related

Required primitives

  • has_legend
  • has_axis_titles

Optional primitives

  • has_data_labels

Common anti-patterns

  • rainbow-palette
  • unreadable-small-cells

Disambiguation rules

  • Square matrix with same labels on both axes.
  • If each cell is a small chart, it is small-multiples; if cells are coloured by value, it is heatmap-shaped n×n.