Virata manual

graph dumbbell

Two dots joined by a line, per category. The chart for a gap — men against women, before against after — because the length of the line is the gap.

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 dumbbell [(stat)] varname [if] [weight], over(catvar) by(groupvar)

Two dots per category joined by a line, so the gap shows. by() must have exactly two groups.

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 categoryone row for each state (over)
sexa categoryexactly two values: the two ends of each row (by)
mpcea numberwhere each end sits (the average)

Three rows of it would look like this:

Bihar  Male  2410.55
Bihar  Female  2298.2
Kerala  Male  4102.8

The example

. sysuse vira.sample01, clear
. graph dumbbell mpce, over(state) by(sex)

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.