.-
help for ^turnip^                                                  (STB-58: gr45)      
.-

Turnip Graph Engine
--------------------

        ^turnip^  varlist [^if^ exp] [^, res^olution^(^#^)^ ^tru^ev^(^#^)^ graph_options ]


Description
-----------

Creates a turnip-style graph.   Turnip graphs display distributions 
like a boxplot but in a much more intuitive way.  Plus, they look 
really cool. 


Options
-------

^resolution(^#^)^ specifies the resolution of the graph, that is, the
width of the intervals to be used.  The default value is 0.4 times the
standard deviation of the variable.  Since ^resolution^ rounds the
data, the graph in essence displays the frequency of observations
falling within each resolution unit.  The user can avoid any such
rounding (that is, display a frequency of each value in the data) by
specifying a negative number in ^resolution^.

^truev(^#^)^ specifies a value that can be used to divide a variable
into three parts: one exactly equal to ^truev^, one that is greater
than ^truev^, and one that is less than ^truev^.  For example, suppose
you are trying to display change scores and want to show which
observations are above or below zero.  Using ^truev(0)^ ensures that
only zero values are graphed at zero; other values which would round
to zero are set at the next appropriate category of the variable being
displayed.

All standard graphics options except for ^by^ are allowed.

In addition to the usual function of ^yline^, ^turnip^
allows user to specify special values;  specifically, mean or
median.  If either mean or median is specified, the corresponding
value is added to ^ylabel^ so the value is displayed on the y-axis.


Examples
--------

 . ^turnip mpg^
 . ^turnip mpg, res(1.5) yline(median)^


Author
------

    Steven Woloshin
    VA Medical Center 
    White River Junction, VT
    steven.woloshin@@dartmouth.edu


Also see
---------

   STB: STB-58 gr45