R Observatory: Metrics for TheseusPlot version 0.3.0

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

TheseusPlot

0.3.0

Visualizing Decomposition of Differences in Rate Metrics

0packages depend

2.7Kdownloads / year

72.5%test coverage

13/13checks pass

Overview

About

Maintained by Koji MakiyamaFirst published 2025-08-283 releasesCRAN page ↗GitHub ↗

Provides tools for decomposing differences in rate metrics between two groups into contributions from individual subgroups and visualizing them as a "Theseus Plot". Inspired by the story of the Ship of Theseus, the method replaces subgroup data from one group with that of another step by step, recalculating the overall metric at each stage to quantify subgroup contributions. A Theseus Plot combines the stepwise progression of a waterfall plot with the comparative bars of a bar chart, offering an intuitive way to understand subgroup-level effects.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("TheseusPlot", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("hoxo-m/TheseusPlot")

Development version from hoxo-m/TheseusPlot. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-theseusplot

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-TheseusPlot

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-TheseusPlot

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 3.7 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 0.47

72.5%

Coverage · measured lines

100%

Documentation · exports

11

Dependencies · direct

Check history

OK2026-08-05
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
NOTE2026-08-01
12 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 1,024 wordsVignettesNopkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 100%
Documented parameters: 100%
Return-value docs: 67%
References docs: 0%

Downloads

2.7K

CRAN downloads in the past year

Rank #11,230 · ~8/day · ~229/mo

Releases R versions

Daily download trend is not available in this view yet.

14130 days

87390 days

2.7K1 year

Compare downloads with other packages →

Also on84 r2u19 autocran

Repository

GitHub ↗ hoxo-m/theseusplot

5Stars

1Forks

2Open issues

0Open PRs

3Releases

93Commits

2Contributors

data-sciencedata-visualization

93 commits · Last activity 2026-06-17 · 0% stars, 30d

Stars over time

2025-08-28 · 12026-07-07 · 5

Repository practices

Upstream repositoryBeta

3 development-tooling and community-health practices detected across 3 families in the upstream repository

Checks run against github.com/hoxo-m/theseusplot on 2026-08-16.

Continuous integration (1)

GitHub Actions

CRAN release process (1)

cran-comments.md

Docs source (1)

README.Rmd

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

14 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.1.0

Imports (11)

dplyr forcats ggplot2 memoise R6 rlangstatsstringr tibble tidyr waterfalls

LinkingTo (0)

none

Suggests (4)

knitr nycflights13 rmarkdown testthat

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

People & History

People (5)

Maintainer (1)

Koji Makiyama

Author, Maintainer, Copyright holder

Authors (1)

Koji Makiyama

Author, Maintainer, Copyright holder

Contributors (1)

Kazuyuki Sano

Contributor, wdc · added in 0.2.0

Copyright holders (1)

Koji Makiyama

Author, Maintainer, Copyright holder

Other (3)

LY Corporation Analytics Solution Enhancement Team

spn

Daisuke Ichikawa

exp

Shinichi Takayanagi

med

Package Timeline

3 releases. Pick two to compare their code metrics. R releases are shown for context.

0.3.0Latest
2026-06-15 · current release · diff ↗
R
R 4.6.0 released · 2026-04-24
0.2.0
2026-04-09 · diff ↗
0.1.1
2026-03-10
R
R 4.5.0 released · 2025-04-11

Package metadata

First published: 2025-08-28
Total releases: 3 / 1 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.1.0
Download size: 79 KB
Installed size: not tracked yet
With dependencies: not tracked yet

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("TheseusPlot")

Format

Makiyama, K., LY Corporation Analytics Solution Enhancement Team, Ichikawa, D., Sano, K., & Takayanagi, S. (2026). TheseusPlot: Visualizing Decomposition of Differences in Rate Metrics (Version 0.3.0) [Computer software]. https://doi.org/10.32614/CRAN.package.TheseusPlot

This is what citation() produces when a package has no citation file of its own. If it prints something else, use that.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

Format

APA

Balamuta, J. J. (2026). R Observatory: Metrics for TheseusPlot version 0.3.0 [Data set]. HJJB, LLC. Data release v2026-08-18. https://doi.org/10.5281/zenodo.21843040

From data release v2026-08-18, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →