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
|
\name{weighted.hist}
\alias{weighted.hist}
\title{
Display a weighted histogram
}
\description{
Calculate the counts of the weighted values in specified bins and
optionally display either a frequency or density histogram.
}
\usage{
weighted.hist(x,w,breaks="Sturges",col=NULL,plot=TRUE,
freq=TRUE,ylim,ylab=NULL,...)
}
\arguments{
\item{x}{A vector of numeric values}
\item{w}{A vector of weights at least as long as x.}
\item{breaks}{The endpoints of the ranges into which to count the weighted
values.}
\item{col}{An optional vector of colors for the bars of the histogram.}
\item{plot}{Whether to plot a histogram.}
\item{freq}{Whether to plot counts or densities.}
\item{ylim}{The limits of the plot ordinate.}
\item{ylab}{Label for the ordinate.}
\item{...}{Additional arguments passed to \link{barplot}.}
}
\details{
\samp{weighted.hist} calculates the weighted counts of values falling
into the ranges specified by \samp{breaks}. Instead of counting each
value as 1, it counts the corresponding value in \samp{w} (the weight).
\samp{breaks} may be specified by a monotonically increasing vector
of numbers that are interpreted as the endpoints of the ranges, a
single number representing the number of ranges desired or the name
of the function to calculate the ranges (see \link{hist}).
If a vector of numbers is passed that does not include all values in
\samp{x}, the user is warned. If the ranges are not equal, a warning
will be displayed if \samp{freq} is TRUE or the heights of the bars
will be adjusted to display areas approximately equal to the counts
if \samp{freq} is FALSE.
}
\value{A list containing:
breaks - The endpoints of the intervals
counts - The weighted counts
density - The weighted counts divided by their sum.
mids - The midpoints of the intervals and the bars displayed.
xname - the name of \samp{x}.
equidist - Whether the intervals differ by less than the total range/1000.
}
\author{Jim Lemon and Hadley Wickham}
\seealso{\link{hist}}
\examples{
testx<-sample(1:10,300,TRUE)
testw<-seq(1,4,by=0.01)
weighted.hist(testx,testw,breaks=1:10,main="Test weighted histogram")
}
\keyword{misc}
|
