tdarec

0.2.1

A 'recipes' Extension for Persistent Homology and Its Vectorizations

0packages depend

2.8Kdownloads / year

74.4%test coverage

13/13checks pass

Overview

About

Maintained by Jason Cory BrunsonFirst published 2025-05-263 releasesCRAN page ↗GitHub ↗

Topological data analytic methods in machine learning rely on vectorizations of the persistence diagrams that encode persistent homology, as surveyed by Ali &al (2000) doi:10.48550/arXiv.2212.09703. Persistent homology can be computed using 'TDA' and 'ripserr' and vectorized using 'TDAvec'. The Tidymodels package collection modularizes machine learning in R for straightforward extensibility; see Kuhn & Silge (2022, ISBN:978-1-4920-9644-3). These 'recipe' steps and 'dials' tuners make efficient algorithms for computing and vectorizing persistence diagrams available for Tidymodels workflows.

Install

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

install.packages("tdarec", 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("tdaverse/tdarec")

Development version from tdaverse/tdarec. 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-tdarec

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-tdarec

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-tdarec

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

Health

CRAN checks

13OK

Slowest check: 6.0 min · r-devel-linux-x86_64-fedora-clang

Code health

Yes

Tests · ratio 0.66

74.4%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-08
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 931 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

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

Downloads

2.8K

CRAN downloads in the past year

Rank #8,369 · ~8/day · ~235/mo

Releases R versions

Daily download trend is not available in this view yet.

29430 days

1.3K90 days

2.8K1 year

Compare downloads with other packages →

Also on103 r2u36 autocran

Repository

GitHub ↗ tdaverse/tdarec

1Stars

2Forks

10Open issues

0Open PRs

1Releases

199Commits

2Contributors

machine-learningpersistent-homologyrecipestidymodelstopological-data-analysisvectorization

License GPL-3.0 · 199 commits · Last activity 2026-04-13

Stars over time

2025-06-06 · 12026-07-07 · 1

Repository practices

Upstream repositoryBeta

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

Checks run against github.com/tdaverse/tdarec on 2026-07-19.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (1)

data-raw/

CRAN release process (1)

cran-comments.md

Docs source (1)

README.Rmd

Show all practices

Lint, format, editor (1)

RStudio project

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

Dependencies

Declared dependencies

20 external dependencies (excludes base and recommended)

Depends (3)

R >= 3.5.0recipes dials

Imports (7)

rlang vctrs scales tibble purrr (>= 1.0.0)tidyr magrittr

LinkingTo (0)

none

Suggests (11)

cli ripserr TDA TDAvec testthat (>= 3.0.0)modeldata tdaunif knitr rmarkdown (>= 1.10)tidymodels ranger

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

People & History

People (1)

Maintainer (1)

Jason Cory Brunson

Maintainer, Author

Authors (1)

Jason Cory Brunson

Maintainer, Author

Package Timeline

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

R
R 4.6.0 released · 2026-04-24
0.2.1Latest
2026-04-11 · current release · diff ↗
0.2.0
2025-06-20 · diff ↗
0.1.0
2025-05-26
R
R 4.5.0 released · 2025-04-11

Package metadata

First published: 2025-05-26
Total releases: 3 / 1 yrs
License: GPL (>= 3) OSI
Minimum R: ≥ 3.5.0
Bundled data: 136 KB / 1 file
Download size: 670 KB
Installed size: not tracked yet
With dependencies: not tracked yet

Report a problem with this page →