Store and manipulate event data

Note (2020-03-15): Most of the functionality in this R package is superseded by the excellent tidyverse package dplyr, which wasn't quite such a big thing back in 2012 when this was written. You should probably use that instead.

Events is an R package to make life a bit easier for people who analyse event data (that's the kind of thing that KEDS/TABARI generates as output. There's no fancy stuff, just a logical interface to all the data massaging we do to event data before any actual analysis. The package also bundles the CAMEO and WEIS event code schemes, plus their Goldstein numerical scalings, and some event data from the Bosnian conflict.

The philosophy of the package is that you apply filters and aggregators to a stream of events until you get what you need. For event data the usual last step is an application of make_dyads to make a set of named temporally regular directed dyad time series suitable for time series analysis. The design is rather unix-ish, if you care for that sort of thing.

Events unifies existing software tools for event data, particularly those currently linked from the PSU event data pages. For example, events has scrub_keds function, one_a_day filter, and does most of the things you might have used KEDS_Count and Aggregator for.

There's more detail and a worked example in the package vignette. You should probably read that.


You can install the current release (0.5) by typing


at your local R prompt.

If you're interested you can peruse the source code of the current release (0.5) on CRAN or the latest development version on Github.


Events is open source software distributed under the Gnu Public License (GPL).


If you'd like to refer to the package in written work, you can use this:

Lowe W. (2012) 'events: Store and manipulate event data'. R package version 0.5, URL: