Virata manual

graph pie

Shares of a whole, when there are only a few of them. Six slices at most here; beyond that people cannot compare angles and a bar chart is simply better. donut leaves a hole and puts the total in it.

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 pie [(stat)] [varname] [if] [weight], over(catvar) [donut]

Slices are the total of varname (or a row count if you give no variable). Six slices at most: the smallest are folded into "Other". donut leaves a hole and shows the total.

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 slice for each state
mpcea numberoptional: each slice is the total of this; leave it out to count rows

Three rows of it would look like this:

Bihar  2410.55
Kerala  4102.8
Bihar  2988.1

The example

. sysuse vira.sample01, clear
. graph pie, over(state) donut

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.