Learn R Programming

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

surveillance (version 1.21.1)

Temporal and Spatio-Temporal Modeling and Monitoring of Epidemic Phenomena

Description

Statistical methods for the modeling and monitoring of time series of counts, proportions and categorical data, as well as for the modeling of continuous-time point processes of epidemic phenomena. The monitoring methods focus on aberration detection in count data time series from public health surveillance of communicable diseases, but applications could just as well originate from environmetrics, reliability engineering, econometrics, or social sciences. The package implements many typical outbreak detection procedures such as the (improved) Farrington algorithm, or the negative binomial GLR-CUSUM method of Hoehle and Paul (2008) . A novel CUSUM approach combining logistic and multinomial logistic modeling is also included. The package contains several real-world data sets, the ability to simulate outbreak data, and to visualize the results of the monitoring in a temporal, spatial or spatio-temporal fashion. A recent overview of the available monitoring procedures is given by Salmon et al. (2016) . For the retrospective analysis of epidemic spread, the package provides three endemic-epidemic modeling frameworks with tools for visualization, likelihood inference, and simulation. hhh4() estimates models for (multivariate) count time series following Paul and Held (2011) and Meyer and Held (2014) . twinSIR() models the susceptible-infectious-recovered (SIR) event history of a fixed population, e.g, epidemics across farms or networks, as a multivariate point process as proposed by Hoehle (2009) . twinstim() estimates self-exciting point process models for a spatio-temporal point pattern of infective events, e.g., time-stamped geo-referenced surveillance data, as proposed by Meyer et al. (2012) . A recent overview of the implemented space-time modeling frameworks for epidemic phenomena is given by Meyer et al. (2017) .

Copy Link

Version

Install

install.packages('surveillance')

Monthly Downloads

1,741

Version

1.21.1

License

GPL-2

Maintainer

Sebastian Meyer

Last Published

May 19th, 2023

Functions in surveillance (1.21.1)

addFormattedXAxis

Formatted Time Axis for "sts" Objects
R0

Computes reproduction numbers from fitted models
LRCUSUM.runlength

Run length computation of a CUSUM detector
algo.call

Query Transmission to Specified Surveillance Algorithm
addSeason2formula

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

Semiparametric surveillance of outbreaks
algo.cdc

The CDC Algorithm
aggregate.disProg

Aggregate a disProg Object
algo.quality

Computation of Quality Values for a Surveillance System Result
backprojNP

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

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

The system used at the RKI
abattoir

Abattoir Data
algo.farrington.threshold

Compute prediction interval for a new observation
algo.rogerson

Modified CUSUM method as proposed by Rogerson and Yamada (2004)
algo.glrnb

Count Data Regression Charts
anscombe.residuals

Compute Anscombe Residuals
algo.bayes

The Bayes System
checkResidualProcess

Check the residual process of a fitted twinSIR or twinstim
MMRcoverageDE

MMR coverage levels in the 16 states of Germany
algo.compare

Comparison of Specified Surveillance Systems using Quality Values
clapply

Conditional lapply
algo.farrington

Surveillance for Count Time Series Using the Classic Farrington Method
coeflist

List Coefficients by Model Component
arlCusum

Calculation of Average Run Length for discrete CUSUM schemes
calibrationTest

Calibration Tests for Poisson or Negative Binomial Predictions
animate

Generic animation of spatio-temporal objects
algo.farrington.assign.weights

Assign weights to base counts
algo.hmm

Hidden Markov Model (HMM) method
campyDE

Campylobacteriosis and Absolute Humidity in Germany 2002-2011
boda

Bayesian Outbreak Detection Algorithm (BODA)
formatPval

Pretty p-Value Formatting
epidataCS_animate

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

CUSUM detector for time-varying categorical time series
epidataCS_permute

Randomly Permute Time Points or Locations of "epidataCS"
bestCombination

Partition of a number into two factors
all.equal

Test if Two Model Fits are (Nearly) Equal
estimateGLRNbHook

Hook function for in-control mean estimation
fanplot

Fan Plot of Forecast Distributions
algo.summary

Summary Table Generation for Several Disease Chains
create.disProg

Creating an object of class disProg (DEPRECATED)
algo.cusum

CUSUM method
earsC

Surveillance for a count data time series using the EARS C1, C2 or C3 method and its extensions
findH

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

Continuous Space-Time Marked Point Patterns with Grid-Based Covariates
findK

Find Reference Value
fluBYBW

Influenza in Southern Germany
bodaDelay

Bayesian Outbreak Detection in the Presence of Reporting Delays
hhh4_W

Power-Law and Nonparametric Neighbourhood Weights for hhh4-Models
epidataCS_aggregate

Conversion (aggregation) of "epidataCS" to "epidata" or "sts"
hhh4

Fitting HHH Models with Random Effects and Neighbourhood Structure
ha

Hepatitis A in Berlin
algo.twins

Fit a Two-Component Epidemic Model using MCMC
deleval

Surgical Failures Data
epidata

Continuous-Time SIR Event History of a Fixed Population
imdepi

Occurrence of Invasive Meningococcal Disease in Germany
glm_epidataCS

Fit an Endemic-Only twinstim as a Poisson-glm
hhh4_predict

Predictions from a hhh4 Model
sim.seasonalNoise

Generation of Background Noise for Simulated Timeseries
epidata_animate

Spatio-Temporal Animation of an Epidemic
measles.weser

Measles in the Weser-Ems region of Lower Saxony, Germany, 2001-2002
disProg2sts

Convert disProg object to sts and vice versa
epidata_plot

Plotting the Evolution of an Epidemic
epidata_summary

Summarizing an Epidemic
epidataCS_plot

Plotting the Events of an Epidemic over Time and Space
hagelloch

1861 Measles Epidemic in the City of Hagelloch, Germany
formatDate

Convert Dates to Character (Including Quarter Strings)
hhh4_internals

Internal Functions Dealing with hhh4 Models
hhh4_simulate_plot

Plot Simulations from "hhh4" Models
hhh4_simulate

Simulate "hhh4" Count Time Series
meningo.age

Meningococcal infections in France 1985-1997
epidataCS_update

Update method for "epidataCS"
ks.plot.unif

Plot the ECDF of a uniform sample with Kolmogorov-Smirnov bounds
hhh4_W_utils

Extract Neighbourhood Weights from a Fitted hhh4 Model
hhh4_formula

Specify Formulae in a Random Effects HHH Model
pit

Non-Randomized Version of the PIT Histogram (for Count Data)
discpoly

Polygonal Approximation of a Disc/Circle
influMen

Influenza and meningococcal infections in Germany, 2001-2006
linelist2sts

Convert Dates of Individual Case Reports into a Time Series of Counts
epidata_intersperse

Impute Blocks for Extra Stops in "epidata" Objects
hhh4_plot

Plots for Fitted hhh4-models
refvalIdxByDate

Compute indices of reference value using Date class
salmonella.agona

Salmonella Agona cases in the UK 1990-1995
inside.gpc.poly

Test Whether Points are Inside a "gpc.poly" Polygon
hhh4_validation

Predictive Model Assessment for hhh4 Models
shadar

Salmonella Hadar cases in Germany 2001-2006
farringtonFlexible

Surveillance for Univariate Count Time Series Using an Improved Farrington Method
hcl.colors

HCL-based Heat Colors from the colorspace Package
plapply

Verbose and Parallel lapply
momo

Danish 1994-2008 all-cause mortality data for eight age groups
makeControl

Generate control Settings for an hhh4 Model
sts_creation

Simulate Count Time Series with Outbreaks
find.kh

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

Fit an Additive-Multiplicative Intensity Model for SIR Data
poly2adjmat

Derive Adjacency Structure of "SpatialPolygons"
hepatitisA

Hepatitis A in Germany
polyAtBorder

Indicate Polygons at the Border
salmHospitalized

Hospitalized Salmonella cases in Germany 2004-2014
hhh4_methods

Print, Summary and other Standard Methods for "hhh4" Objects
marks

Import from package spatstat.geom
imdepifit

Example twinstim Fit for the imdepi Data
twinSIR_cox

Identify Endemic Components in an Intensity Model
primeFactors

Prime Number Factorization
scores

Proper Scoring Rules for Poisson or Negative Binomial Predictions
toLatex.sts

toLatex-Method for "sts" Objects
husO104Hosp

Hospitalization date for HUS cases of the STEC outbreak in Germany, 2011
hhh4_simulate_scores

Proper Scoring Rules for Simulations from hhh4 Models
rotaBB

Rotavirus cases in Brandenburg, Germany, during 2002-2013 stratified by 5 age categories
print.algoQV

Print Quality Value Object
twinSIR_intensityplot

Plotting Paths of Infection Intensities for twinSIR Models
layout.labels

Layout Items for spplot
scale.gpc.poly

Centering and Scaling a "gpc.poly" Polygon
runifdisc

Sample Points Uniformly on a Disc
stsSlot-generics

Generic Functions to Access "sts" Slots
nowcast

Adjust a univariate time series of counts for observed but-not-yet-reported events
isScalar

Checks if the Argument is Scalar
hhh4_update

update a fitted "hhh4" model
sts_ggplot

Time-Series Plots for "sts" Objects Using ggplot2
twinstim

Fit a Two-Component Spatio-Temporal Point Process Model
nbOrder

Determine Neighbourhood Order Matrix from Binary Adjacency Matrix
isoWeekYear

Find ISO Week and Year of Date Objects
zetaweights

Power-Law Weights According to Neighbourhood Order
ranef

Import from package nlme
m1

RKI SurvStat Data
intensityplot

Plot Paths of Point Process Intensities
measlesDE

Measles in the 16 states of Germany
intersectPolyCircle

Intersection of a Polygonal and a Circular Domain
magic.dim

Compute Suitable k1 x k2 Layout for Plotting
twinSIR_simulation

Simulation of Epidemic Data
twinstim_simulation

Simulation of a Self-Exciting Spatio-Temporal Point Process
twinstim_step

Stepwise Model Selection by AIC
pairedbinCUSUM

Paired binary CUSUM and its run-length computation
permutationTest

Monte Carlo Permutation Test for Paired Individual Scores
multiplicity.Spatial

Count Number of Instances of Points
stcd

Spatio-temporal cluster detection
knox

Knox Test for Space-Time Interaction
stsplot_space

Map of Disease Counts/Incidence accumulated over a Given Period
surveillance.options

Options of the surveillance Package
multiplicity

Import from package spatstat.geom
siaf.simulatePC

Simulation from an Isotropic Spatial Kernel via Polar Coordinates
plot.survRes

Plot a survRes object
stsNewport

Salmonella Newport cases in Germany 2001-2015
sim.pointSource

Simulate Point-Source Epidemics
stK

Diggle et al (1995) K-function test for space-time clustering
residualsCT

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

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

Salmonella cases in Germany 2001-2014 by data of symptoms onset
salmNewport

Salmonella Newport cases in Germany 2004-2013
stsXtrct

Subsetting "sts" Objects
twinstim_siaf

Spatial Interaction Function Objects
twinstim_iaf

Temporal and Spatial Interaction Functions for twinstim
sts-class

Class "sts" -- surveillance time series
sts_observation

Create an sts object with a given observation date
aggregate-methods

Aggregate an "sts" Object Over Time or Across Units
twinSIR_exData

Toy Data for twinSIR
sts_animate

Animated Maps and Time Series of Disease Counts or Incidence
tidy.sts

Convert an "sts" Object to a Data Frame in Long (Tidy) Format
twinstim_epitest

Permutation Test for Space-Time Interaction in "twinstim"
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
twinSIR_profile

Profile Likelihood Computation and Confidence Intervals
stsplot

Plot Methods for Surveillance Time-Series Objects
twinstim_profile

Profile Likelihood Computation and Confidence Intervals for twinstim objects
stsplot_spacetime

Animated Map of Disease Incidence (DEPRECATED)
surveillance-defunct

Defunct Functions in Package surveillance
plot.disProg

Plot Observed Counts and Defined Outbreak States of a (Multivariate) Time Series
surveillance-package

surveillance: tools:::Rd_package_title("surveillance")
plot.atwins

Plots for Fitted algo.twins Models
twinstim_tiaf

Temporal Interaction Function Objects
xtable.algoQV

Xtable quality value object
twinstim_methods

Print, Summary and Extraction Methods for "twinstim" Objects
twinstim_update

update-method for "twinstim"
stsNClist_animate

Animate a Sequence of Nowcasts
unionSpatialPolygons

Compute the Unary Union of "SpatialPolygons"
stsNC-class

Class "stsNC" -- a class inheriting from class sts which allows the user to store the results of back-projecting surveillance time series
twinstim_plot

Plot methods for fitted twinstim's
wrap.algo

Multivariate Surveillance through independent univariate algorithms
twinstim_simEndemicEvents

Quick Simulation from an Endemic-Only twinstim
stsplot_time

Time-Series Plots for "sts" Objects
untie

Randomly Break Ties in Data
twinstim_intensity

Plotting Intensities of Infection over Time or Space
twinstim_iafplot

Plot the Spatial or Temporal Interaction Function of a twimstim