tis (version 1.38)

lines.tis: Plotting Time Indexed Series

Description

Plotting methods for tis objects

Usage

# S3 method for tis
lines(x, offset = 0.5, dropNA = FALSE, ...)
# S3 method for tis
points(x, offset = 0.5, dropNA = FALSE, ...)

Arguments

x

a tis (time indexed series) object

offset

a number in the range [0,1] telling where in each period of x to plot the point. 0 means the first second of each period, 1 the last second of the period, and the default 0.5 plots each point in the middle of the time period in which it falls.

dropNA

if TRUE, observations with NA values are dropped before calling lines.default or points.default. See the details for why you might or might not want to do this. The default is FALSE, to match the behavior of lines.default and points.default.

other arguments to be passed on to lines.default or points.default.

Details

These are fairly simple wrappers around the lines.default and points.default. For example, lines.tis basically does this:

lines.default(x = time(x, offset = offset), y = x, ...)

and points.tis is similar. If dropNA is TRUE, the observations in x that are NA are dropped from the x and y vectors sent to the .default functions. For points, this shouldn't matter, since points.tis omits points with NA values from the plot.

For lines the dropNA parameter does make a difference. The help document for lines says:

"The coordinates can contain NA values. If a point contains NA in either its x or y value, it is omitted from the plot, and lines are not drawn to or from such points. Thus missing values can be used to achieve breaks in lines."

Note that if the type is one of c("p", "b", "o"), the non-NA points are still drawn, but line segments from those points to adjacent NA points are not drawn. If dropNA = TRUE, the NA points are dropped before calling lines.default, and all of the remaining points will be connected with line segments (unless suppressed by the type argument).

See Also

lines, points