.-
help for ^univar^                                  [STB-36: sg67; STB-51: sg67.1]
.-
.
univariate summary with box-and-whiskers plot
---------------------------------------------
.
   ^univar^ varlist [weight] [^if^ exp] [^in^ range] [ ^,^ ^by^var^(^bylist^)^ ^ones^cal ^oneh^dr
                  ^box^plot ^d^ec^(^#^)^ ^fmt(^[f|g]^) l^stwise ^se^ ^vl^abel ]
.
^aweights^ and ^fweights^ are allowed; see help @weights@.
.
.
Description
-----------
.
^univar^ displays a univariate summary of each variable in varlist, using a hori-
zontal format resembling that of @summarize@ without the ^detail^ option.  However,
the output includes a five-number summary (minimum, 25th, 50th, 75th percent-
iles, and maximum) normally available only with the ^detail^ option of @summarize@.
.
.
Options
-------
.
^byvar(^bylist^)^ displays a summary of the varlist variables for the subset of ob-
    servations at each unique set of values of the bylist variables.  The data
    need not be sorted by the bylist variables, and the current sort order of
    the data is not disturbed.
.
^onehdr^ writes the header describing the summary quantities to be displayed just
    once; by default, the header is written for each ^bylist^ combination.  The
    result is that ^byvar^ creates one table with sub-tables when ^onehdr^ is pres-
    ent, and otherwise a distinct table for each ^bylist^ combination.
.
^boxplot^ adds a simplified box-and-whiskers plot to the output for each variable
    in varlist. The plot is drawn using typewriter characters immediately above
    the variable's summary statistics.  By default, all plots span the same
    screen width and use this scheme to represent the five-number summary:
.
         -----------------:::::::::::|:::::::::::::::-------------------------
         ^^                ^^          ^^              ^^                        ^^
        Min              P25        P50            P75                      Max
.
^onescal^ forces a common scale for all the boxplots of a given variable when the
    ^byvar()^ option is also given. The scale is chosen so that the overall range
    of the variable fits the available screen width, and individual boxplots
    contract as necessary.
.
^dec(^#^)^ controls the number of decimal places used in printing the summary val-
    ues; the default value of # is 2. (The sample size is always shown in %7.0f
    format.)
.
^fmt(^[f|g]^)^ chooses between %8.#f and %8.#g format for printing the summary val-
    ues; the default format is %8.#f.
.
^lstwise^ requests list-wise treatment of missing values (observations are ignor-
    ed if any of the varlist variables has a missing value).  By default, mis-
    sing values are handled in variable-wise fashion.
.
^se^ requests that the standard error of the mean (s/sqrt(n)) be displayed in the
    place otherwise used for the sample standard deviation (s).
.
^vlabel^ displays the variable label (if present) for each varlist variable.
.
.
Examples
--------
.
 . ^univar xa xb^
   (Mean, SD, and 5-number summary of all non-missing values of variable xa,
   and all non-missing values of variable xb)
.
 . ^univar xa xb, lst se box^
   (Mean, SE, and 5-number summary for all observations where both variables xa
   and xb are non-missing; include a box-and-whiskers plot for each variable)
.
 . ^univar xa xb, lst se box by(city) ones^
   (As before, but with boxplots on a common scale across values of city)
.
 . ^univar ht wt bp if time > 0 in 1/100, by(treat center) d(0) fmt(g) vl oneh^
   (Mean, SD, and 5-number summary of all non-missing values of variables ht,
   wt, and bp, using only cases where time>0 among the first 100 observations.
   Display results as a single table, with a sub-table for each combination of
   the variables treat and center, and show results in %8.0g format. Print each
   variable's label on the line above its summary statistics.
.
.
Author
------
   John R. Gleason, Syracuse University, Syracuse NY, USA
   (loesljrg@@accucom.net)    [This is Version 1.1.3 (10Aug1999).]
.
.
Also see
--------
.
 Manual:  [R] oneway; [R] summarize; [R] table
On-line:  help for @oneway@, @summarize@, @table@, @tabsum@, @tabulate@
