R: Plot Methods for Surveillance Time-Series Objects

stsplot {surveillance}

R Documentation

Plot Methods for Surveillance Time-Series Objects

Description

This page gives an overview of plot types for objects of class "sts".

Usage

  ## S4 method for signature 'sts,missing'
plot(x, type = observed ~ time | unit, ...)

Arguments

`x`	an object of class `"sts"`.
`type`	see Details.
`...`	arguments passed to the `type`-specific plot function.

Details

There are various types of plots which can be produced from an "sts" object. The type argument specifies the desired plot as a formula, which defaults to observed ~ time | unit, i.e., plot the time series of each unit separately. Arguments to specific plot functions can be passed as further arguments (...). The following list describes the plot variants:

observed ~ time | unit: The default type shows ncol(x) plots, each containing the time series of one observational unit. The actual plotting per unit is done by the function stsplot_time1, called sequentially from stsplot_time.
A ggplot2-based alternative for this type of plot is provided through an autoplot-method for "sts" objects.
observed ~ time: The observations in x are first aggregated over units and the resulting univariate time-series is plotted via the function stsplot_time.
alarm ~ time: Generates a so called alarmplot for a multivariate sts object. For each time point and each series it is shown whether there is an alarm. In case of hierarchical surveillance the user can pass an additional argument lvl, which is a vector of the same length as rows in x specifying for each time series its level.
observed ~ unit: produces a map of counts (or incidence) per region aggregated over time. See stsplot_space for optional arguments, details and examples.

Value