Events

Store and manipulate event data

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 e.g. here). 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, a 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.

Installation

You can install the current release (0.5) by typing

install.packages('events')

at your 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.

License

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

Citation

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 http://cran.r-project.org/web/packages/events/