rcPlots a run chart, the values of the variable ordered according to their order in the data frame. Usually this ordering would be an ordering according to time. The default run chart provides the index, that is, sequential position, of each value of the variable from 1 to the last value. Optionally dates can be provided so that a time-series plotis produced. Also does an anlaysis of the runs in the data.
For data of one variable exhibiting little trend, the center line is provided for the generation of a run chart, plotting the values of a variable in order of occurrence over time. When the center line, the median by default, is plotted, the analyses of the number and composition of the individual runs, number of consecutive values above or below the center line, is also displayed. Also, the defaults change for each of the types of plots. The intent is to rely on the default values for a relatively sophisticated plot, particularly when compared to the default values of the standard R plot function called with a single variable.
RunChart(y, dframe=mydata, type=NULL, col.line=NULL, col.area=NULL, col.box="black",
col.pts=NULL, col.fill=NULL, trans.pts=NULL,
pch=NULL, col.grid=NULL, col.bg=NULL,
colors=c("blue", "gray", "rose", "green", "gold", "red"),
cex.axis=.85, col.axis="gray30",
col.ticks="gray30", xy.ticks=TRUE,
xlab=NULL, ylab=NULL, main=NULL, cex=NULL,
x.start=NULL, x.end=NULL, y.start=NULL, y.end=NULL,
time.start=NULL, time.by=NULL, time.reverse=FALSE,
center.line=NULL,
text.out=TRUE, ...)
rc(...)
mydata."p" for
points, "l" for line, or "b" for both. If x and y are provided and
x is sorted so that a function is plotted, the default is ""darkblue"."transparent". If the values exhibit a trend and dates
"black".col.pts.col.pts and col.fill. For a scatterplot, col.fill"grey90".xlab not
specified, then the label becomes the name of the corresponding variable. If
xy.ticks is FALSE, then no label is displayed. If no y vxy.ticks is FALSE, then no label displayed.mylabels, then the title is set by default from the corresponding
variable labels.x.reverse, the first date is after
the data are reverse sorted. Not needed if data are a time series with time.start specification, the interval to increment the
date for each sequential data value. A character string, containing one of "day",
"week", "month" or "year"TRUE, reverse the ordering of the dates, particularly when the
data are listed such that first row of data is the newest. Accompanies the time.start
specification."mean" and "median". Provides a centerline for the
"median" by default when the values randomly vary about the mean.TRUE, then display text output in console.par.plot when called with only a single variable.The values on the horizontal axis of the run chart are automatically generated. The default is the index variable, the ordinal position of each data value. Or, dates on the horizontal axis can be specified from the specified starting date given by x.start and the accompanying increment as given by x.by. If the data values randomly vary about the mean, the default is to plot the mean as the center line of the graph, otherwise the default is to ignore the center line. The default plot type for the run chart is type="b", for both points and the corresponding connected line segments. The size of the points is automatically reduced according to the number of points of points plotted, and the cex option can override the computed default. If the area below the plotted values is specified to be filled in with color, then the default line type changes to type="l".
The input data frame has the assumed name of mydata. If this data frame is named something different, then specify the name with the dframe option. Regardless of its name, the data frame need not be attached to reference the variable directly by its name without having to invoke the mydata$name notation. Any missing data values are removed and the effective sample size and number of missing values reported.
A labels data frame named mylabels, obtained from the Read function, can list the label for some or all of the variables in the data frame that contains the data for the analysis. If this labels data frame exists, then the corresponding variable label is listed as the title of the resulting plot, unless a specific label is listed with the main option.
The default background color of col.bg=ghostwhite provides a very mild cool tone with a slight emphasis on blue. The entire color theme can be specified at the system level with the lessR function set using the colors option. Or, use the same option for Plot to set the color theme just for one run chart. The default color theme is blue, but a gray scale is available with "gray", and other themes are available as explained in the help function for set.
plot, set.# generate 25 random normal data values
y <- rnorm(25)
# default run chart
RunChart(y)
# short name
rc(y)
# compare to standard R plot
plot(y, type="l")
# RunChart in gray scale
RunChart(y, colors="gray")
# customize run chart, pch=24: filled triangle point-up,
RunChart(y, lwd=2, col.pts="sienna3", pch=24,
col.bg="mintcream", ylim=c(-3.5,3.5), center.line="median")
# generate steadily increasing values
y <- sort(rexp(50))
# default line chart
RunChart(y)
# line chart with border around plotted values
RunChart(y, col.area="transparent")
# time series chart, i.e., with dates, and filled area
# with option label for the x-axis
RunChart(y, time.start="2005/09/01", time.by="month")
# time series chart from a time series object
y.ts <- ts(y, start=c(2005, 9), frequency=12)
RunChart(y.ts)
# RunChart with built-in data set
RunChart(breaks, dframe=warpbreaks)Run the code above in your browser using DataLab