Learn R Programming

⚠️There's a newer version (1.25.0) of this package.Take me there.

surveillance (version 1.5-1)

Temporal and Spatio-Temporal Modeling and Monitoring of Epidemic Phenomena

Description

A package implementing statistical methods for the modeling and change-point detection in time series of counts, proportions and categorical data, as well as for the modeling of continuous-time epidemic phenomena, e.g. discrete-space setups such as the spatially enriched Susceptible-Exposed-Infectious-Recovered (SEIR) models for surveillance data, or continuous-space point process data such as the occurrence of disease or earthquakes. Main focus is on outbreak detection in count data time series originating from public health surveillance of infectious diseases, but applications could just as well originate from environmetrics, reliability engineering, econometrics or social sciences. Currently the package contains implementations of typical outbreak detection procedures such as Stroup et. al (1989), Farrington et al (1996), Rossi et al (1999), Rogerson and Yamada (2001), a Bayesian approach, negative binomial CUSUM methods and a detector based on generalized likelihood ratios. Furthermore, inference methods for the retrospective infectious disease model in Held et al (2005), Held et al (2006), Paul et al (2008) and Paul and Held (2011) are provided. A novel CUSUM approach combining logistic and multinomial logistic modelling is also included. Continuous self-exciting spatio-temporal point processes are modeled through additive-multiplicative conditional intensities as described in H�hle (2009) ("twinSIR", discrete space) and Meyer et al (2012) ("twinstim", continuous space). The package contains several real-world datasets, the ability to simulate outbreak data, visualize the results of the monitoring in temporal, spatial or spatio-temporal fashion.

Copy Link

Version

Install

install.packages('surveillance')

Monthly Downloads

1,063

Version

1.5-1

License

GPL-2

Maintainer

Michael Hhle

Last Published

December 14th, 2012

Functions in surveillance (1.5-1)

algo.hmm

Hidden Markov Model (HMM) method
discpoly

Generate a Polygon Representing a Disc/Circle (in Planar Coordinates)
hepatitisA

Hepatitis A in Germany
intensityplot

Plot Paths of Point Process Intensities
testSim

Print xtable for a Simulated Disease and the Summary
residualsCT

Extract Cox-Snell-like Residuals of a Fitted Point Process
twinSIR

Spatio-Temporal Epidemic Modelling Using Additive-Multiplicative Intensity Models
twinstim

Fit a Two-Component Spatio-Temporal Conditional Intensity Model
algo.cdc

The CDC Algorithm
isoWeekYear

Find ISO week and ISO year of a vector of Date objects
hhh4

Random effects HHH model fit as described in Paul and Held (2011)
multiplicity

Count Number of Instances of Points
twinSIR_cox

Identify Endemic Components in an Intensity Model
twinstim_epidataCS_plot

Plotting the Events of an Epidemic over Time and Space
twinstim_intensityplot

Plotting Intensities of Infection over Time or Space
m1

RKI SurvStat Data
momo

Danish 1994-2008 all cause mortality data for six age groups
disProg2sts

Convert disProg object to sts and vice versa
twinstim_update

update-method for "twinstim"
anscombe.residuals

Compute Anscombe residuals
algo.cusum

CUSUM method
algo.farrington

Surveillance for a count data time series using the Farrington method.
find.kh

Determine the k and h values in a standard normal setting
estimateGLRPoisHook

Hook function for in-control mean estimation
meanResponse

Calculate mean response needed in algo.hhh
plot.atwins

Plot results of a twins model fit
findH

Find decision interval for given in-control ARL and reference value
makePlot

Plot Generation
arlCusum

Calculation of Average Run Length for discrete CUSUM schemes
predict.ah

Predictions from a HHH model
qlomax

Quantile Function of the Lomax Distribution
shadar

Salmonella Hadar cases in Germany 2001-2006
zetaweights

Derive Power-Law Weights from Neighbourhood Order
untie

Randomly Break Ties in Data
twinstim_iaf

Temporal and Spatial Interaction Functions for twinstim
twinstim_methods

Print, Summary and Extraction Methods for "twinstim" Objects
salmonella.agona

Salmonella Agona cases in the UK 1990-1995
algo.farrington.assign.weights

Assign weights to base counts
compMatrix.writeTable

Latex Table Generation
twinSIR_intensityplot

Plotting Paths of Infection Intensities for twinSIR Models
checkResidualProcess

Check the residual process of a fitted twinSIR or twinstim
R0

Computes basic reproduction numbers from fitted models
readData

Reading of Disease Data
primeFactors

Prime number factorization
algo.rogerson

Modified CUSUM method as proposed by Rogerson and Yamada (2004)
inside.gpc.poly

Test Whether Points are Inside a "gpc.poly" Polygon
aggregate.disProg

Aggregate the observed counts
hhh4_methods

Print, Summary and Extraction Methods for "ah4" Objects
nowcast

Adjust observed epidemic curve for reporting delay of cases
twinstim_epidataCS_update

Update method for "epidataCS"
sts-class

Class "sts" -- surveillance time series
addSeason2formula

Function that adds a sine-/cosine formula to an existing formula.
algo.outbreakP

Semiparametric surveillance of outbreaks
influMen

Influenza and meningococcal infections in Germany, 2001-2006
polyCub

Two-Dimensional Numerical Integration over a Polygonal Domain
deleval

Surgical failures data
display-methods

Display Methods for Surveillance Time-Series Objects
plot.survRes

Plot a survRes object
twinstim_profile

Profile Likelihood Computation and Confidence Intervals for twinstim objects
stcd

Spatio-temporal cluster detection
algo.hhh

Model fit based on the Held, Hoehle, Hofman paper
algo.glrnb

Cound data regression charts
loglikelihood

Calculation of the loglikelihood needed in algo.hhh
sim.seasonalNoise

Generation of Background Noise for Simulated Timeseries
twinSIR_simulation

Simulation of Epidemic Data
twinSIR_exData

Artificial data and data from the German Federal State Baden-Wuerttemberg
simHHH

Simulates data based on the model proposed by Held et. al (2005)
measles.weser

Measles epidemics in Lower Saxony in 2001-2002
isScalar

Checks if the Argument is Scalar
algo.twins

Model fit based on a two-component epidemic model
scale.gpc.poly

Centering and Scaling a "gpc.poly" Polygon
correct53to52

Data Correction from 53 to 52 weeks
surveillance.options

Options of the surveillance Package
imdepi

Occurrence of Invasive Meningococcal Disease in Germany
simulate.ah4

Simulates data based on the model proposed by Paul and Held (2011)
twinstim_iafplot

Plot the spatial or temporal interaction function of a twimstim
aggregate-methods

Aggregate the the series of an sts object
LRCUSUM.runlength

Run length computation of a CUSUM detector
backprojNP

Non-parametric back-projection of incidence cases to exposure cases using a known incubation time as in Becker et al (1991).
ha

Hepatitis A in Berlin
MMRcoverageDE

MMR coverage levels in the 16 states of Germany
create.disProg

Creating an object of class disProg
create.grid

Computes a matrix of initial values
make.design

Create the design matrices
hhh4_formula

Specify Formulae in a Random Effects HHH Model
nbOrder

Determine Neighbourhood Order Matrix from Binary Adjacency Matrix
wrap.algo

Multivariate Surveillance through independent univariate algorithms
linelist2sts

Convert individual case information based on dates into an aggregated time series
xtable.algoQV

Xtable quality value object
stsBP-class

Class "stsBP" -- a class inheriting from class sts which allows the user to store the results of back-projecting or nowcasting surveillance time series
refvalIdxByDate

Compute indices of reference value using Date class
algo.farrington.threshold

Compute prediction interval for a new observation
bestCombination

Partition of a number into two factors
algo.farrington.fitGLM

Fit the Poisson GLM of the Farrington procedure for a single time point
algo.call

Query Transmission to Specified Surveillance Systems
hhh4_validation

Predictive model assessment for a HHH4 model
pairedbinCUSUM

Paired binary CUSUM and its run-length computation
algo.rki

The system used at the RKI
abattoir

Abattoir Data
sumNeighbours

Calculates the sum of counts of adjacent areas
print.algoQV

Print quality value object
toFileDisProg

Writing of Disease Data
twinstim_epidataCS_animate

Spatio-Temporal Animation of a Continuous-Time Continuous-Space Epidemic
twinSIR_epidata_intersperse

Impute Blocks for Extra Stops in "epidata" Objects
surveillance-package

Temporal and Spatio-Temporal Modeling and Monitoring of Epidemic Phenomena
animate

Generic animation of spatio-temporal objects
hagelloch

1861 measles epidemic in the city of Hagelloch, Germany
ks.plot.unif

Plot the ECDF of a uniform sample with Kolmogorov-Smirnov bounds
residuals.ah

Residuals from a HHH model
sim.pointSource

Generation of Simulated Point Source Epidemy
test

Print xtable for several diseases and the summary
twinSIR_epidata_plot

Plotting the Evolution of an Epidemic
algo.hhh.grid

Function to try multiple starting values
algo.quality

Computation of Quality Values for a Surveillance System Result
algo.summary

Summary Table Generation for Several Disease Chains
measlesDE

Measles in the 16 states of Germany
powerlaw

Power-Law Neighbourhood Weight Structure for hhh4 Models
runifdisc

Sample Points Uniformly on a Disc
twinSIR_epidata

Class for Epidemic Data Discrete in Space and Continuous in Time
estimateGLRNbHook

Hook function for in-control mean estimation
[,sts-methods

Extraction and Subsetting of sts objects
twinstim_epidataCS

Class for Representing Continuous Space-Time Point Process Data
twinstim_simulation

Simulation of a Self-Exciting Spatio-Temporal Point Process
algo.compare

Comparison of Specified Surveillance Systems using Quality Values
gpc.poly,coerce-methods

Some Additional Converters Between gpclib, sp, and spatstat
fluBYBW

Influenza in Southern Germany
findK

Find reference value
twinSIR_profile

Profile Likelihood Computation and Confidence Intervals
twinSIR_epidata_summary

Summarizing an Epidemic
algo.glrpois

Poisson regression charts
categoricalCUSUM

CUSUM detector for time-varying categorical time series
enlargeData

Data Enlargement
plot.disProg

Plot Generation of the Observed and the defined Outbreak States of a (multivariate) time series
magic.dim

Returns a suitable k1 x k2 for plotting the disProgObj
twinSIR_methods

Print, Summary and Extraction Methods for "twinSIR" Objects
twinSIR_epidata_animate

Spatio-Temporal Animation of an Epidemic
algo.bayes

The Bayes System
twinstim_plot

Plot methods for fitted twinstim's
stsSlot-generics

Generic functions to access "sts" slots