.-
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@