Learn R Programming

CRMetrics

05-07-2023

Cell Ranger output filtering and metrics visualisation

Installation

install.packages("remotes")
remotes::install_github("khodosevichlab/CRMetrics") # CRAN version
remotes::install_github("khodosevichlab/CRMetrics", ref = "dev") # developer version

Initialization

A CRMetrics object can be initialized in different ways using CRMetrics$new(). Either data.path or cms must be provided. The most important arguments are:

  • data.path: A path to a directory containing sample-wise directories with outputs from cellranger count. Can also be NULL. Can also be a vector of multiple paths.
  • cms: A list with count matrices. Must be named with sample IDs. Can also be NULL
  • metadata: Can either be 1) a data.frame, or 2) a path to a table file (separator should be set with the sep.meta argument), or 3) NULL. For 1) and 2) the object must contain named columns, and one column has to be named sample containing sample IDs. Sample IDs must match the directory names in data.path or names of cms unless both these are NULL. In case of 3), a minimal metadata object is created from names in data.path or names of cms.

Vignette

For usage, please see the vignette / code.

Python integrations

CRMetrics makes use of several Python packages, some of them through the reticulate package in R, please see the included example workflow in the vignette.

Cite

To cite this work, please run citation("CRMetrics") or cite our preprint:

Fabienne Lorena Kick, Henrietta Holze, Rasmus Rydbirk, Konstantin Khodosevich: CRMetrics - an R package for Cell Ranger Filtering and Metrics Visualisation, 06 July 2023, PREPRINT (Version 1) available at Research Square [https://doi.org/10.21203/rs.3.rs-2853524/v1]

Copy Link

Version

Install

install.packages('CRMetrics')

Monthly Downloads

668

Version

0.3.0

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Rasmus Rydbirk

Last Published

September 1st, 2023

Functions in CRMetrics (0.3.0)

addDetailedMetricsInner

Add detailed metrics
filterVector

Create filtering vector
addPlotStatsSamples

Add statistics to plot
CRMetrics

CRMetrics class object
addSummaryMetrics

Add summary metrics
checkDataPath

Check data path
getH5Paths

Get H5 file paths
addPlotStats

Add statistics to plot
plotGeom

Plot the data as points, as bars as a histogram, or as a violin
labelsFilter

Get labels for percentage of filtered cells
percFilter

Calculate percentage of filtered cells
createUniqueCellNames

Create unique cell names
read10xH5

Read 10x HDF5 files
read10x

Load 10x count matrices
checkCompGroup

Set correct 'comp.group' parameter
checkCompMeta

Check whether 'comp.group' is in metadata