.- help for ^onewplot^ .-One-way plots -------------

^onewplot^ varlist [^if^ exp] [^in^ range] [ ^, st^ack ^f^rac^(^#^)^ graph_options ] ^onewplot^ varname [^if^ exp] [^in^ range] [ ^, by(^byvar^) st^ack ^f^rac^(^#^)^ graph_options ]

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

^onewplot^ plots data as a series of marks against a single magnitude axis.

The vertical scale is (implicitly) 1, ... , number of variables shown or, if ^by( )^ is specified, minimum value of byvar, ... , maximum value of byvar.

Remarks -------

^onewplot^ differs from ^graph, oneway^:

^graph, oneway^ puts descriptive text under each line of marks. ^onewplot^ puts descriptive text on the axes.

^graph, oneway^ always shows data marks as short vertical bars, unless ^jitter( )^ is specified. ^onewplot^ allows any symbol to be used for the data marks. The default is a short vertical bar, shorter than that in ^graph, oneway^.

^graph, oneway^ interprets ^jitter( )^ as replacing short vertical bars by sets of dots. ^onewplot^ interprets ^jitter( )^ in the same way as does ^graph,^ ^twoway^.

^graph, oneway^ does not allow tuning of ^xlabel( )^ -- the minimum and maximum are always shown -- nor of whether a border or axes are shown. ^onewplot^ allows such tuning as with ^graph, twoway^.

^onewplot^ uses only one colour in the body of the graph. ^graph, oneway^ uses several colours with several variables.

^onewplot^ allows the use of ^xline( )^ and ^yline( )^.

^graph, oneway^ allows up to 20 variables or 52 groups to be shown. ^onewplot^ allows up to 25 variables or groups to be shown.

^graph, oneway rescale^ stretches each set of data marks to extend over the whole horizontal range of the graph. ^onewplot^ allows the ^rescale^ option of ^graph, twoway^, but it has no effect, because internally the graph is of a single y-variable versus a single x-variable, and ^rescale^ only affects graphs with two or more y-variables. ^graph^ myvar^, oneway by(^byvar^)^ requires data to be sorted by byvar. ^onewplot^ myvar^, by(^byvar^)^ does not require this.

^graph^ myvar^, oneway by(^byvar^)^ does not take the values of byvar literally: displays for values 1, 2 and 4 will appear equally spaced. ^onewplot^ myvar^, by(^byvar^)^ does take the values of byvar literally. (To tidy up an ordering, use ^egen^ with ^lgroup^ from ^egenodd^ from STB-50.)

^onewplot^ with the ^stack^ option produces a variant on ^dotplot^ in which the magnitude axis is horizontal. There is no binning of data, unlike that in ^dotplot^.

Stata 6.0 will only use at most 8 characters from value labels in ^xlabel^s or ^ylabel^s. Options -------

^by(^byvar^)^ specifies that values of varname are to be shown separately by groups defined by byvar. This option may only be specified with a single variable. If ^stack^ is also specified, then note that distinct values of any numeric byvar are assumed to differ by at least 1. ^frac( )^ or the prior use of ^egen^ with ^lgroup^ from ^egenodd^ from STB-50 will fix any problems.

^stack^ specifies that data points with identical values are to be stacked, as in ^dotplot^, except that the magnitude axis is horizontal and there is no binning of data.

^frac(^#^)^ controls the fraction of vertical space taken up by stacked data points under the ^stack^ option above. Default 0.8. This option will not by itself change the appearance of a plot for a single variable or group of data.

graph_options are options allowed with ^graph, twoway^, other than ^xlabel^ by itself and ^ylabel^ by itself. ^yreverse^ may be useful.

The vertical scale may be extended by using ^yscale( )^.

^connect( )^ is allowed but not obviously useful. (For plots with connecting lines, see @parcoord@ from STB-29.)

Examples --------

. ^onewplot length width height^ . ^onewplot length, by(grade)^ . ^onewplot length, by(grade) border xla(0(200)2000)^

. ^onewplot mpg, by(foreign) stack f(0.4)^

Author ------

Nicholas J. Cox, University of Durham, U.K. n.j.cox@@durham.ac.uk

Also see --------

On-line: help for @groneway@, @parcoord@ (if installed), @egenodd@ (if installed), @dotplot@