Skip to content

CellMentor

Bioc current

Supervised Non-negative Matrix Factorization for Dimensional Reduction in Single-Cell Analysis

v1.0.1 · Package record · software · Apache License (>= 2)

Release Lineage

Entered 3.23 · Apr 29, 2026

Current · Requires R 4.6

1.0 In 1 of 49 releases 3.23

Description

Implements supervised cell type-aware non-negative matrix factorization (NMF) for dimensional reduction in single-cell RNA sequencing analysis. The package provides methods for incorporating cell type information into the dimensionality reduction process, enabling improved visualization and downstream analysis of single-cell data while preserving biological structure. CellMentor employs a unique loss function that simultaneously minimizes variation within known cell populations while maximizing distinctions between different cell types, enabling effective transfer of learned patterns from labeled reference datasets to new unlabeled data.

Advisories

None published for Bioconductor

Test coverage

Line coverage

–

Expression

–

Tests / Examples

–

Functions

79 13 exported

Complexity

2.5 avg / 9 max

Call network

79 nodes / 59 edges

Test coverage is not measured for Bioconductor packages; nodes fall back to a neutral fill.

Loading call graph…

Lowest coverage

Per-function coverage is not measured for this package yet.

Code

Structure

Lines of code

5,411

Files

57

Compiled share

0%

Has compiled src

No

Language breakdown

R 3,674 (67.9%)Tests 813 (15%)Docs 621 (11.5%)Vignettes 303 (5.6%)

API

Exported functions

13

Internal functions

64

Recent export changes

v3.23+13 CellMentor, CreateCSFNMFobject, H +10 more

Testing

Has tests

Yes

Test-to-code ratio

0.22

testthat edition

3

Docs

Roxygen coverage

100%

Health & Security signals

Informational signals; not verdicts.

on.exit coverage

–

Unsafe pattern score

0

Dep constraint coverage

4%

Secret pattern count

0

Bundled 3rd-party code

2 items

Portability & License

Min R version

4.5.0

System requirements

–

C++ standard

–

License

Apache License (>= 2)

License flags

SPDX valid, OSI approved

History

Versions

1

First release

2026-05-25

Latest release

2026-05-25

Avg cadence

–

Cold removal rate

–

Dep drift

0

Per-file churn detail lives in the source pipeline: https://github.com/r-observatory/bioc-code-metrics.

Documentation

In the Bioconductor 3.23 release
READMEYes · 639 wordsVignettesYes · 1 · dynamicNEWSYes · 100% structured · mentions 1.0.1Citation fileNoWebsitenot declared in DESCRIPTION
Help pages
15 (1 internal)includes a package overview page
Examples that run
86%12 run in a plain check · 1 only when donttest examples are enabled (R CMD check --as-cran) · 1 never run
Exported functions with examples
92%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
7%
Changes in 1.0.1 (Bioconductor 3.23)

Bug fixes

  • calculate_performance() now passes as.factor(true_labels) and as.factor(clusters) to aricode::NMI(). As of aricode 1.1.0, NMI() routes mixed-type inputs through sort_pairs(), which calls as.integer() on character labels — turning cell-type names such as "alpha" into NA and aborting with "NA are not supported.". Coercing both sides to factor keeps the computation well-defined. Backport of the fix shipped in 1.1.2 on the devel branch.

From NEWS.md in the release

Repository practices

Upstream repositoryBeta

1 development-tooling and community-health practice detected across 1 family in the upstream repository

Checks run against github.com/petrenkokate/cellmentor on 2026-10-11.

Reproducibility and dev environment (1)
data-raw/
How this is detected·Detection ruleset v3 (2026-09-26)

Datasets

Bundled datasets · 4
NameClassSizeAlso in
obj_toy–––
qry_matrix_toymatrix50 × 8No other package
ref_celltype_toyvector12 elementsNo other package
ref_matrix_toymatrix50 × 12No other package

All of CellMentor's data objects

Topics

Maintainer
Ekaterina Petrenko

Available on

CRANr2uBioconductorautoCRANCOPR

People

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("CellMentor")
Petrenko, E. (2026). CellMentor: Supervised Non-negative Matrix Factorization for Dimensional Reduction in Single-Cell Analysis (Version 1.0.1) [Computer software]. https://bioconductor.org/packages/CellMentor

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 CellMentor version 1.0.1 [Data set]. HJJB, LLC. Data release v2026-10-18. https://doi.org/10.5281/zenodo.21843040

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

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