1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
\name{starPie}
\alias{starPie}
\title{A pie-like graphic object}
\usage{
starPie(x,y,radext,values,maxval=NA,border=par("fg"),col=NA,prop.area=FALSE,
label="",labelpos=1)
}
\description{
Display a polygon with each sector proportional to a vector of numeric values.
}
\arguments{
\item{x,y}{The coordinate position for the center of the starPie.}
\item{radext}{The maximum distance from the center of the starPie to one vertex of
the polygon.}
\item{values}{A vector of numeric values.}
\item{maxval}{A maximum value for scaling the values to the radius. If NA, the
maximum value in \samp{values} will be used.}
\item{border}{The color to use for the borders of the polygon sectors.}
\item{col}{The color(s) to use for the fills of the polygon.}
\item{prop.area}{Whether to scale the values to the area (TRUE) or the
radial extent (FALSE) of the polygon sectors.}
\item{label}{Optional text labels for the starPies.}
\item{labelpos}{Positions of the labels relative to the starPies.}
}
\value{nil}
\details{
\samp{starPie} displays a polygon centered on the \samp{x,y} position having
sectors of equal angular extent. The radial extent of each sector
is proportional to the values in the numeric vector \samp{lengths}. If the
\samp{prop.area} argument is TRUE, the proportion is based on the area of the
sector, and if \samp{prop.area} is FALSE, the proportion is on the radial extent.
As the function is intended to exaggerate the differences between different
starPies, the default produces sectors proportional to the squares of the
\samp{lengths}.
\samp{starPie} is intended to display a visual analog of the relative value of
matched attributes of a number of similar objects or groups. Thus objects having
similar attributes will produce similar looking starPies. When constructing such
a matrix, it is necessary for \samp{maxval} to be specified, usually as the
overall maximum value in any of the attribute value vectors. If \samp{maxval} is
not specified in such a situation, only the relative values within each vector
will determine the radial extents of each starPie. There appears to be no reason
to have different sector colors for different objects, but the user can display
more than one set of starPies on a plot with different sector colors if
necessary.
\samp{starPie} calls \samp{getYmult} to automatically adjust for both the aspect
and coordinate ratio of the plot.
}
\author{Jim Lemon}
\examples{
date_mat<-data.frame(sex=rep(c("M","F"),each=10),
names=c("Abe","Bob","Col","Dave","Eddie","Frank","Geoff","Harry","Igor","Jack",
"Alice","Betty","Clare","Dora","Eva","Fran","Grace","Hilda","Iris","Joan"),
eating=sample(0:100,20),dancing=sample(0:100,20),movies=sample(0:100,20),
reading=sample(0:100,20),travel=sample(0:100,20))
plot(0,xlim=c(0.5,10.5),ylim=c(0,3),type="n",axes=FALSE,xlab="",ylab="Sex",
main="Date matching matrix")
par(xpd=TRUE)
legend(0.7,-0.3,c("Eat out","Dance","Movies","Read","Travel"),fill=rainbow(5),
ncol=5)
par(xpd=FALSE)
box()
axis(2,at=c(0.9,2.4),labels=c("Male","Female"))
starPie(x=rep(1:10,2),y=rep(c(0.9,2.4),each=10),radext=0.5,
values=as.matrix(date_mat[,3:7]),label=as.character(date_mat[["names"]]))
}
\keyword{misc}
|
