.BG
.VE $Header: /usr/s/current/s/.help/RCS/stars,v 1.4 86/10/07 15:34:14 rab Exp $
.FN stars
.TL
stars: Star Plots of Multivariate Data
.CS
stars(x, full, scale, radius, type, labels, head,
      max, byrow, nrow, ncol)
.PP
.AG x
matrix of data.  One star symbol will be produced for
each row of the matrix.
Missing values (NAs) are allowed.
.AG full
logical, if TRUE, the symbols will occupy a full circle.
Otherwise, they occupy the (upper) semi-circle only.
Default TRUE.
.AG scale
logical, if TRUE, the columns of the data matrix are scaled
so that the maximum value in each column is 1 and the
minimum 0.  If FALSE, the presumption is that the data has
been scaled by some other algorithm to the range
0<=x[i,j]<=1.  Default TRUE.
.AG radius
logical, if TRUE (default), the radii corresponding to the variables
in the data will be drawn.
.AG type
optional character string, giving the type of star to draw.
Reasonable values are "l", "p", "b" for lines, points and
both.  Default is "l".
.AG labels
optional character vector for labelling the plots.  By
default, labels are "1", "2", etc.  If supplied, the label
vector must have length equal to `nrow(x)'.
.AG head
optional character string for a running head.  This is
plotted as a title at the top of each page.  By default, the
name of the data is used.  If there is more than one page,
the page number is included in the title.
.AG max
optional, suggested limit for the number of rows or columns
of plots on a single page.  Default forces all symbols to be on one page.
The algorithm tries
to choose an array of plots which efficiently uses the
available space on the display.
.AG byrow
logical flag, should the symbols be plotted row-by-row across the
page, or column-by-column?  Default FALSE.
.AG nrow
.AG ncol
optionally may be given to specify exactly the number of rows
and columns for the array of plots on each page.
.EX
# the example plot is produced by:
stars(votes.repub[state.region==1,]/100,radius=T,scale=F,
labels=encode(state.name[state.region==1]),
head="Republican Votes (Northeast) 1856 - 1976")
.PI
.KW multivariate
.KW plot*
.KW hplot*
.WR
