Skip to main content

cNMF Solution Network Space

Project description

cNMF-SNS logo


cNMF-SNS: powerful factorization-based multi-omics integration toolkit

version badge PyPI Latest Release Conda Latest Release Documentation status Downloads License

Authors: Ted Verhey, Heewon Seo, Sorana Morrissy

cNMF-SNS (consensus Non-negative Matrix Factorization Solution Network Space) is a Python package enabling mosaic integration of bulk, single-cell, and spatial expression data between and within datasets. Datasets can have partially overlapping features (eg. genes) as well as non-overlapping features. cNMF provides a robust, unsupervised deconvolution of each dataset into gene expression programs (GEPs). Network-based integration of GEPs enables flexible integration of many datasets across assays (eg. Protein, RNA-Seq, scRNA-Seq, spatial expression) and patient cohorts.

Communities with GEPs from multiple datasets can be annotated with dataset-specific annotations to facilitate interpretation.

⚡Main Features

Here are just a few of the things that cNMF-SNS does well:

  • Identifies interpretable, non-negative programs at multiple resolutions
  • Mosaic integration does not require subsetting features/genes to a shared or overdispersed subset
  • Ideal for incremental integration (adding datasets one at a time) since deconvolution is performed independently on each dataset
  • Integration performs well even when the datasets have mismatched features (eg. Microarray, RNA-Seq, Proteomics) or sparsity (eg single-cell vs bulk RNA-Seq and ATAC-Seq)
  • Two interfaces: command-line interface for rapid data exploration and python interface for extensibility and flexibility

🔧 Install

☁️ Public Release

Install the package with conda (in an isolated conda environment)

conda create -n cnmfsns -c conda-forge cnmfsns
conda activate cnmfsns

📖 Documentation

🗐 Data guidelines

cNMF-SNS can factorize a wide variety of datasets, but will work optimally in these conditions:

  • Use untransformed (raw) data where possible, and avoid log-transformed data.
  • For single-cell or spatial RNA-Seq data, the best data to use is feature counts, then TPM-normalized values, then RPKM/FPKM-normalized values.

📓 Python interface

To get started, sample proteomics datasets and a Jupyter notebook tutorial is available here.

Detailed API reference can be found on ReadTheDocs.

⌨️ Command line interface

See the command line interface documentation.

💭 Getting Help

For errors arising during use of cNMF-SNS, create and browse issues in the GitHub "issues" tab.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cnmfsns-1.8.2.tar.gz (65.0 kB view details)

Uploaded Source

Built Distribution

cnmfsns-1.8.2-py3-none-any.whl (67.7 kB view details)

Uploaded Python 3

File details

Details for the file cnmfsns-1.8.2.tar.gz.

File metadata

  • Download URL: cnmfsns-1.8.2.tar.gz
  • Upload date:
  • Size: 65.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/6.6.0 pkginfo/1.9.6 requests/2.29.0 requests-toolbelt/0.9.1 tqdm/4.65.0 CPython/3.10.10

File hashes

Hashes for cnmfsns-1.8.2.tar.gz
Algorithm Hash digest
SHA256 10eda05712851baddc0467ca3fa25008f75d7de19104567b44c77afca8f0704b
MD5 01becdf5b6bd5d155e35a938b0b23d28
BLAKE2b-256 b8a4159d68df15f1cf231eca89f9615731fd56179c9d58738cb862f585076123

See more details on using hashes here.

File details

Details for the file cnmfsns-1.8.2-py3-none-any.whl.

File metadata

  • Download URL: cnmfsns-1.8.2-py3-none-any.whl
  • Upload date:
  • Size: 67.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/6.6.0 pkginfo/1.9.6 requests/2.29.0 requests-toolbelt/0.9.1 tqdm/4.65.0 CPython/3.10.10

File hashes

Hashes for cnmfsns-1.8.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4532fa068ced772a4f7f3ca47f5bae06007a3e1d2945f39b9ba70a490e99d77b
MD5 6ec32f62a7466ec46957cda0ce81b1a6
BLAKE2b-256 0cedd3ea97f2ba2c347fc017164bb5503387019397c0209991dafa21a82b9d2d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page