Skip to content

matrixprofiler

0.1.12Package record

Matrix Profile for R

1packages depend
3.3Kdownloads / year
87.7%test coverage
13/13flavors OK

Overview

About

This is the core functions needed by the 'tsmp' package. The low level and carefully checked mathematical functions are here. These are implementations of the Matrix Profile concept that was created by CS-UCR http://www.cs.ucr.edu/~eamonn/MatrixProfile.html.

Changes in 0.1.12
  • **Parallel execution and fork**: Documented limitations of fork-based workers with native threads, including STOMP and MPX. Recommend PSOCK clusters with n_workers = 1 per process for parallel execution across series. Existing fork warnings now clarify that reducing the thread count cannot undo inherited library state and does not guarantee safe fork-based execution.
  • **Native Multivariate STOMP (mstomp)**: Added native high-performance C++ engine (mstomp_rcpp) with multi-threading via RcppThread, properly sorting must/exclusion dimensions, and fixing historical edge cases where must dimensions could be omitted from accumulated distances. Delivers ~197x speedup over legacy pure R execution.
Show all changes in 0.1.12Hide the rest of the changes in 0.1.12
  • **Missing Value Handling in Rolling Window Functions (na_strategy & na.rm)**: Implemented complete missing/non-finite value support across mov_mean(), mov_sum(), mov_var(), mov_std(), mov_min(), mov_max(), movmean_std(), and muinvn() with explicit na_strategy = c("window_na", "remove", "error") and standard na.rm argument compatibility. Default "window_na" returns NA_real_ strictly for windows intersecting non-finite values without corrupting adjacent valid windows or stopping execution.
  • **Multithreaded MASS Variants (mass)**: Extended multi-threading via RcppThread to all MASS variants (v2, weighted, non_normalized, absolute) in mass() and C++ backend (mass2_rcpp, mass_weighted_rcpp, mass_absolute_rcpp), matching mass3_rcpp_parallel with identical numerical output.
  • **Native MPdist Engine**: Added native high-performance C++ implementation of MPdist (mpdist_vect_rcpp and mpdist_simple_rcpp) with multi-threaded parallel execution via RcppThread.
  • **Zero Allocation & O(N) Sliding Min**: Implemented linear-time monotonic deque for sliding window minimum and $O(K)$ selection with std::nth_element, replacing expensive R matrix and data frame allocations and providing massive speedups (over 10x-100x).
  • **Exported mpdist() API**: Exported mpdist(ref_data, query_data, window_size, type = c("simple", "vector"), thr = 0.05, n_workers = 1) in R with dedicated unit test suite.

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 5.5 min · r-devel-windows-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK12 OK2026-04-25
  • NOTE11 OK, 3 NOTE2026-04-22
  • ERROR10 OK, 3 NOTE, 1 ERROR2026-04-18
Show 3 earlier changesHide 3 earlier changes
  • NOTE11 OK, 3 NOTE2026-04-10
  • ERROR10 OK, 3 NOTE, 1 ERROR2026-04-09
  • NOTE11 OK, 3 NOTE2026-03-10
Advisories

none known

Documentation

In release 0.1.12
READMEYes · 644 wordsVignettes· In the repository, left out of the releaseNEWSYes · 100% structured · mentions 0.1.12Citation fileNoWebsiteYes · pkgdown
Help pages
12
Examples that run
100%10 run in a plain check
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
42%

Downloads

3.3K
CRAN downloads in the past year
Rank #11,617 · ~9/day · ~279/mo
Daily download trend is not available in this view yet.
44230 days
92290 days
3.3K1 year
Compare downloads with other packages →
Also on363 r2u3 autocran

Repository

12Stars
3Forks
0Open issues
0Open PRs
7Releases
196Commits
3Commit identities
matrix-profiletime-seriesrrcppcranalgorithm
License file reads as GPL-3.0 · 196 commits · Last activity 2026-10-14 · 0% stars, 30d · Discussions: 1 post
Responsiveness
How these are sampled
PRs merged (all time)
50%
Median days to close, 50 most recently updated closed issues
4
Median days to close, 50 most recently updated closed PRs
4

Stars over time

2025-05-13 · 112026-07-07 · 12
PracticesBeta

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

Checks run against github.com/matrix-profile-foundation/matrixprofiler on 2026-10-18.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (5)
Code of conductContributing guideIssue templatesPR templateSupport guide
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-10-14 · The repository has a site deploy workflow

pkgdown site last built 2026-10-14

Coverage (2)
Coverage reporting (Codecov).covrignore
Show all practicesHide 6 practices
Reproducibility and dev environment (2)
renvDev Container
CRAN release process (3)
cran-comments.mdrevdep/CRAN-SUBMISSION
Research and citation (1)
codemeta.json
Automation and maintenance (1)
Dependabot
Lint, format, editor (4)
lintrEditorConfigVS CodeRStudio project
Git structural (1)
.gitattributes
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • GitHub Copilotfirst seen 2025-12-16
    Seen in the repository: .github/copilot-instructions.md
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
7 external dependencies (excludes base and recommended)

Installing matrixprofiler adds 4 packages (4 with compiled code, 2.4 MB of source tarballs). Heaviest: Rcpp 1.8 MB, RcppThread 308 KB, checkmate 247 KB.

Depends (1)
R >= 4.1
Imports (2)
LinkingTo (2)
Enhances (0)
none
Reverse dependencies
1direct
1indirect
Imports 1
Depends, Imports or LinkingTo, most downloaded first

Datasets

People & History

People (6)
Author, Maintainer since 0.1.1 (2021)
res, ccp, Contributor
res, ccp, Contributor
res, ccp, Contributor
res, ccp, Contributor
res, ccp, Contributor
Releases (8)

Pick two releases to compare their code metrics.

  • 0.1.12Latest
    record
    2026-10-14 · current release · diff ↗ ·
    added 7 exports
    has_cuda, mpdist, mpx_stream_right, mpx_stream_s_right, mstomp, rfcp, rfcp_top_k
  • R
    R 4.6.0 released · 2026-04-24
  • 0.1.10
    record
    2025-12-01 · diff ↗
  • R
    R 4.5.0 released · 2025-04-11
  • R
    R 4.4.0 released · 2024-04-24
  • R
    R 4.3.0 released · 2023-04-21
  • unarchivedReturned to CRAN
    2023-01-26
  • 0.1.9
    record
    2023-01-26 · diff ↗ ·
    added 1 export
    contrast
  • archivedRemoved from CRAN
    2023-01-25
    issues were not corrected in time
  • R
    R 4.2.0 released · 2022-04-22
  • 0.1.7
    record
    2021-11-23 · diff ↗
  • 0.1.5
    record
    2021-05-26 · diff ↗
  • R
    R 4.1.0 released · 2021-05-18
  • unarchivedReturned to CRAN
    2021-03-03
  • 0.1.4
    record
    2021-03-03 · diff ↗ ·
    added 8 exports
    binary_split, complexity, corr_ed, ed_corr, mode, normalize, std, znorm
  • archivedRemoved from CRAN
    2021-02-25
    check problems were not corrected in time
Show 5 earlier eventsHide 5 earlier events
  • unarchivedReturned to CRAN
    2021-02-17
  • 0.1.3
    record
    2021-02-17 · diff ↗ ·
    added 1 export
    zero_crossing
  • archivedRemoved from CRAN
    2021-02-12
    policy violation Wasting the time of the CRAN team - asking question and re-submitting with the same error without waiting for a reply
  • 0.1.1
    record
    2021-02-11
  • R
    R 4.0.0 released · 2020-04-24

Package metadata

First published
2021-02-11
Total releases
8 / 5 yrs
License
GPL-3 OSI
Minimum R
≥ 4.1
Bundled data
7.2 KB / 1 file
Download size
360 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("matrixprofiler")
Bischoff, F., Dau, H., Linardi, M., Silva, D., Yeh, M., & Zhu, Y. (2026). matrixprofiler: Matrix Profile for R (Version 0.1.12) [Computer software]. https://doi.org/10.32614/CRAN.package.matrixprofiler

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

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

APA

Balamuta, J. J. (2026). R Observatory: Metrics for matrixprofiler version 0.1.12 [Data set]. HJJB, LLC. Data release v2026-10-20. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-20, 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 →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy