# Plot Methods for Surveillance Time-Series Objects

`stsplot.Rd`

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

.

## Usage

```
# S4 method for 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.`observed ~ 1 | unit`

old version of the map plot, via the deprecated

`stsplot_spacetime`

function. Use`type = observed ~ unit`

instead.`observed ~ 1 | unit * time`

old version for animated maps via the deprecated

`stsplot_spacetime`

function. Use the`animate`

method instead.

## See also

the documentation of the individual plot types
`stsplot_time`

, `stsplot_space`

,
as well as the `animate`

method.