Virata manual

graph heatmap

A grid coloured by value, for two categories at once. Reads well when there are too many combinations for bars — states by years, departments by months.

What we have

  • statistics: count, max, mean, median, min, sum
  • over() for the categories and by() for a second split
  • title(), ytitle() and saving()
  • one self-contained .html file: no server, no internet, nothing to install
  • a table view beside the chart, so the numbers can be read off

Coming later

  • saving as PNG or SVG — graph export does not exist yet
  • graph twoway and graph matrix, which are refused
  • 84 more of the 105 catalogue chart types

How you write it

graph heatmap [(stat)] varname [if] [weight], over(rowvar) by(colvar)

A grid coloured by the statistic.

What your data has to look like

One row per person or record, with these columns (named here as they are in vira.sample01):

ColumnHoldsWhat it does in the chart
statea categorythe rows of the grid (over)
yeara categorythe columns of the grid (by); a number with a few values works too
mpcea numberthe average that colours each cell

Three rows of it would look like this:

Bihar  2004  2410.55
Bihar  2006  2598.4
Kerala  2004  4102.8

The example

. sysuse vira.sample01, clear
. graph heatmap mpce, over(state) by(year)

That is the real file the command wrote — open it on its own. It is one self-contained page with no internet connection needed, so you can email it or drop it into a report.