Wrap Around Time Series Graphics

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

Ubuntu 12.04 LTSWindows Server 2012Test Coverage

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

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.

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.
Latest CRAN versionCRAN DownloadsIndependently-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.


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.)



  • 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.

Changes: *Updated to newer CRAN policies

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 (mark.j.lachowicz@vanderbilt.edu). GitHub Issue #2.
  • Removed unnecessary aes setting of y in CartesianPeriodic.R

New Features:

  • AugmentZZZ() and AnnotateData() functions.
  • CartesianRolling(), CartesianPeriodic(), and PolarPeriodic() functions.
  • Vignette to reproduce figures in MBR manuscript.
  • For a detailed change log, please see https://github.com/OuhscBbmc/Wats/commits/master.
  • For a list of the major releases, please see https://github.com/OuhscBbmc/Wats/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, 2 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: Time Series Analysis

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