tsspiral: An R Package to Create Circular Versions of Time Series Plots

`tsspiral` is an open-source R package that introduces a circular approach to time series visualisation using polar coordinates. We refer to this circular representation of time series data as a spiral. `tsspiral` provides a collection of `ggplot2` geometries for creating a spiral representation of time series data. In our approach, we arrange observations around a circle. Each year is represented by a circle, with the angular position corresponding to the day of the year, and successive years appear as concentric rings. This arrangement facilitates the exploration of periodicity, seasonality, and recurring temporal patterns, particularly in long time series. The package also supports temporal hierarchical visualisations to compare patterns across time scales. By bringing polar-coordinate-based visualisation into routine time series analysis, `tsspiral` offers a practical tool for exploring temporal patterns and communicating complex time-dependent structures. Rather than treating spiral plots as standalone graphics, our approach brings them into the grammar of graphics framework, enabling users to explore temporal patterns through a broader range of visual encodings.

Authors

Publication Details

Journal
arXiv (Cornell University)
Published
2026-11-16
DOI
https://doi.org/10.48550/arxiv.2611.21327
Primary Topic
Data Visualization and Analytics
Type
preprint
Controls
|||
ALL TIME
JAN
FEB
MAR
APR
MAY
JUN
JUL
AUG
SEP
OCT
NOV
preprint

tsspiral: An R Package to Create Circular Versions of Time Series Plots

Thiyanga S. Talagala
arXiv (Cornell University)
Data Visualization and Analytics
preprint

tsspiral: An R Package to Create Circular Versions of Time Series Plots

Thiyanga S. Talagala
preprint en

Abstract

`tsspiral` is an open-source R package that introduces a circular approach to time series visualisation using polar coordinates. We refer to this circular representation of time series data as a spiral. `tsspiral` provides a collection of `ggplot2` geometries for creating a spiral representation of time series data. In our approach, we arrange observations around a circle. Each year is represented by a circle, with the angular position corresponding to the day of the year, and successive years appear as concentric rings. This arrangement facilitates the exploration of periodicity, seasonality, and recurring temporal patterns, particularly in long time series. The package also supports temporal hierarchical visualisations to compare patterns across time scales. By bringing polar-coordinate-based visualisation into routine time series analysis, `tsspiral` offers a practical tool for exploring temporal patterns and communicating complex time-dependent structures. Rather than treating spiral plots as standalone graphics, our approach brings them into the grammar of graphics framework, enabling users to explore temporal patterns through a broader range of visual encodings.

arXiv (Cornell University)
Data Visualization and Analytics
AI Navigator

Ask Laika to Summarize, Analyze, and Connect papers live on the map.

Summarize Papers & Methodologies

Extract key findings, datasets, and comparative methods across publications.

Benchmark Rankings & Visual Analytics

Rank top research institutions, authors, funders, topics, and journals by Field-Weighted Citation Impact (FWCI) and paper volume with instant charts.

Connect Distant Disciplines

Bridge topological clusters on the map to find hidden collaborative intersections.

Laika access coming soon