Wrap Around Time Series Graphics

Wrap-around Time Series (WATS) plots for interrupted time series designs with seasonal patterns.

GitHub Travis-CI AppVeyor Coveralls
Master Build Status Build status Coverage Status
Dev Build Status Build status Coverage Status
Ubuntu 12.04 LTS Windows Server 2012 Test Coverage

This implements the approaches described in Joseph Lee Rodgers, William Howard Beasley, and Matthew Schuelke (2014). Wrap-around Time Series Plots (WATS Plots) for Interrupted Time Series Designs: Applications to Fertility Rates and the Oklahoma City Bombing. Multivariate Behavioral Research.

The figures can be viewed in the vignettes, or in the Handouts document. The release version of Wats is available on CRAN.

Article Abstract

Keywords: time series, interrupted time series design, group differences, graphical analysis, circular data, H-spread

Selected Figures

Figure 2

Figure2Stylized #### Figure 4 Figure6

Reproducible Research

When the Wats package is installed on your local machine, the Reproduce.R script starts with our initial datasets (ie, the vital statistics birth counts and the US Census population estimates) to create the derivative datasets and resulting graphs and analysis.

Nonstandard Directories

The following directories are not part of the standard R package:

  • Datasets: CSV versions of the *.rda data.frames officially included in the package.
  • DocumentationForDevelopers: Notes and links that should help package developers set up on their computer. Typical package users won't have a need for this.
  • PublicationGraphs: A deprecated location that contains loose graphs of older versions of the manuscript.
  • Playgrounds: R snippets to help developers experiment with potential new features.
  • UtilityScripts: R scripts that aren't incorpated into the package. They help automate certain tasks, or document how parts of the package were created.


CRAN Version Rate Zenodo
Latest CRAN_Status_Badge CRANPace DOI
Latest CRAN version CRAN Downloads Independently-hosted Archive

The released CRAN version of Wats can be installed through R with.


The latest development version of Wats can be installed from GitHub after installing the devtools package.


Code Repository

The software is written primarily in R, under the MIT License. The DOI of this major release of the repository is 10.5281/zenodo.11921. (The DOI of the article is 10.1080/00273171.2014.946589.)


Versions 0.10.3 (Developed 2015-11-10)


  • This submission is fixes a small incompatibility with the upcoming version of ggplot2. ggplot2's more stringent checking caught a mistake; when calling ggplot2::geom_vline, Wats used the parameter x, instead of the correct xintercept.

Versions 0.3 through 0.10 (Developed from 2014-05-24 through 2015-08-16)

Changes: *Updated to newer CRAN policies

Version 0.2 (Developed from 2013-12-30 through 2014-05-24)

New Features:

  • Vignette showing reanalysis with 2014 version of the data.


  • Additional documentation and explanation
  • Finalized for resubmission to Multivariate Behavioral Research
  • Tweaked default cosmetic properties of some components
  • Adding Reproduce file
  • Modified and relocated some package dependencies
  • Changed from GPL-2 to MIT license
  • Upgraded to Roxygen 4.0.0
  • Upgraded to ggplot2 1.0.0

Bug Fixes

  • AnnotateData() properly accepts the centerFunction parameter, and doesn't revert to median. Thanks Mark Joseph Lachowicz ([email protected]). GitHub Issue #2.
  • Removed unnecessary aes setting of y in CartesianPeriodic.R

Version 0.1 (Developed from 2010 through 2013-12-11)

New Features:

  • AugmentZZZ() and AnnotateData() functions.
  • CartesianRolling(), CartesianPeriodic(), and PolarPeriodic() functions.
  • Vignette to reproduce figures in MBR manuscript.

GitHub Commits & Releases

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.10.3 by Will Beasley, 4 years ago


Report a bug at https://github.com/OuhscBbmc/Wats/issues

Browse source code at https://github.com/cran/Wats

Authors: Will Beasley [aut, cre] , Joe Rodgers [aut] , Matthew Schuelke [ctb] , Ronnie Coleman [ctb] , Mark Joseph Lachowicz [ctb]

Documentation:   PDF Manual  

Task views:

MIT + file LICENSE license

Imports colorspace, ggplot2, grid, lubridate, plyr, RColorBrewer, testit, zoo

Depends on stats

Suggests BayesSingleSub, boot, devtools, knitr, scales, testthat

See at CRAN