Learn R Programming

⚠️There's a newer version (0.28) of this package.Take me there.

Background

Nonnegative Matrix Factorization (NMF) is an unsupervised learning technique that has been applied successfully in several fields, including signal processing, face recognition and text mining. Recent applications of NMF in bioinformatics have demonstrated its ability to extract meaningful information from high-dimensional data such as gene expression microarrays. Developments in NMF theory and applications have resulted in a variety of algorithms and methods. However, most NMF implementations have been on commercial platforms, while those that are freely available typically require programming skills. This limits their use by the wider research community.

Results

Our objective is to provide the bioinformatics community with an open-source, easy-to-use and unified interface to standard NMF algorithms, as well as with a simple framework to help implement and test new NMF methods. For that purpose, we have developed a package for the R/BioConductor platform. The package ports public code to R, and is structured to enable users to easily modify and/or add algorithms. It includes a number of published NMF algorithms and initialization methods and facilitates the combination of these to produce new NMF strategies. Commonly used benchmark data and visualization methods are provided to help in the comparison and interpretation of the results.

Conclusions

The NMF package helps realize the potential of Nonnegative Matrix Factorization, especially in bioinformatics, providing easy access to methods that have already yielded new insights in many applications.


Travis check:

Copy Link

Version

Install

install.packages('NMF')

Monthly Downloads

10,233

Version

0.26

License

GPL (>= 2)

Maintainer

Nicolas Sauwen

Last Published

March 20th, 2023

Functions in NMF (0.26)

NMF-deprecated

Deprecated Functions in the Package NMF
NMFList-class

Class for Storing Heterogeneous NMF fits
NMFSeed-class

Base class that defines the interface for NMF seeding methods.
NMF-package

Algorithms and framework for Nonnegative Matrix Factorization (NMF).
nmf_update.lee_R

NMF Algorithm/Updates for Frobenius Norm
nmf_update.brunet_R

NMF Algorithm/Updates for Kullback-Leibler Divergence
NMF-class

Generic Interface for Nonnegative Matrix Factorisation Models
NMFOffset-class

NMF Model - Nonnegative Matrix Factorization with Offset
NMF-defunct

Defunct Functions and Classes in the NMF Package
NMFfitX1-class

Structure for Storing the Best Fit Amongst Multiple NMF Runs
NMFfit-class

Base Class for to store Nonnegative Matrix Factorisation results
NMFStrategyIterative-class

Interface for Algorithms: Implementation for Iterative NMF Algorithms
NMFfitXn-class

Structure for Storing All Fits from Multiple NMF Runs
NMFStrategy-class

Virtual Interface for NMF Algorithms
NMFfitX-class

Virtual Class to Handle Results from Multiple Runs of NMF Algorithms
NMFns-class

NMF Model - Nonsmooth Nonnegative Matrix Factorization
NMFStrategyFunction-class

Interface for Single Function NMF Strategies
NMFStrategy

Factory Method for NMFStrategy Objects
nmfAlgorithm.SNMF_R

NMF Algorithm - Sparse NMF via Alternating NNLS
NMFstd-class

NMF Model - Standard model
advanced-NMF

Advanced Usage of the Package NMF
NMFfitX

Factory Method for Multiple NMF Run Objects
aheatmap

Annotated Heatmaps
getRNG1

Extracting RNG Data from NMF Objects
.atrack

Annotation Tracks
algorithmic-NMF

Generic Interface for Algorithms
summary

Assessing and Comparing NMF Models
bioc-NMF

Specific NMF Layer for Bioconductor
Strategy-class

Generic Strategy Class
checkErrors

Error Checks in NMF Runs
ccBreaks

Generate Break Intervals from Numeric Variables
algorithm,NMFList-method

Returns the method names used to compute the NMF fits in the list. It returns NULL if the list is empty.
basisnames

Dimension names for NMF objects
basiscor

Correlations in NMF Models
ccPalette

Builds a Color Palette from Compact Color Specification
basis

Accessing NMF Factors
deviance

Distances and Objective Functions
ccRamp

Builds a Color Ramp from Compact Color Specification
connectivity

Clustering Connectivity and Consensus Matrices
c,NMF-method

Concatenating NMF Models
consensus,NMFfitXn-method

Computes the consensus matrix of the set of fits stored in object, as the mean connectivity matrix across runs.
heatmap-NMF

Heatmaps of NMF Factors
ccSpec

Extract Colour Palette Specification
consensus,NMFfitX1-method

Returns the consensus matrix computed while performing all NMF runs, amongst which object was selected as the best fit.
pmax.inplace

Updating Objects In Place
nbasis

Dimension of NMF Objects
fit

Extracting Fitted Models
canFit

Testing Compatibility of Algorithm and Models
fcnnls

Fast Combinatorial Nonnegative Least-Square
dispersion

Dispersion of a Matrix
fitted

Fitted Matrix in NMF Models
gfile

Open a File Graphic Device
tryViewport

Internal Grid Extension
nmfApply

Apply Function for NMF Objects
nmfAlgorithm

Listing and Retrieving NMF Algorithms
match_atrack

Extending Annotation Vectors
consensushc

Hierarchical Clustering of a Consensus Matrix
latex_preamble

LaTeX Utilities for Vignettes
isCRANcheck

Package Check Utils
cluster_mat

Cluster Matrix Rows in Annotated Heatmaps
registerDoBackend

Utilities and Extensions for Foreach Loops
nmfObject

Updating NMF Objects
nmfReport

Run NMF Methods and Generate a Report
cophcor

Cophenetic Correlation Coefficient
compare-NMF

Comparing Results from Different NMF Runs
nmf.equal

Testing Equality of NMF Models
nmf

Running NMF algorithms
nmfWrapper

Wrapping NMF Algorithms
nmfFormals

Showing Arguments of NMF Algorithms
nmf_update.euclidean_offset.h

NMF Multiplicative Update for NMF with Offset Models
nmfModel

Factory Methods NMF Models
nmfSeed

Seeding Strategies for NMF Algorithms
offset,NMFfit-method

Returns the offset from the fitted model.
parse_formula

Simple Parsing of Formula
nmf_update.euclidean.h

NMF Multiplicative Updates for Euclidean Distance
nmf_update.KL.h

NMF Multiplicative Updates for Kullback-Leibler Divergence
nmf_update.ns

NMF Multiplicative Update for Nonsmooth Nonnegative Matrix Factorization (nsNMF).
options-NMF

NMF Package Specific Options
nneg

Transforming from Mixed-sign to Nonnegative Data
plot,NMFfit,missing-method

Plots the residual track computed at regular interval during the fit of the NMF model x.
parallel-NMF

Utilities for Parallel Computations
revPalette

Flags a Color Palette Specification for Reversion
purity

Purity and Entropy of a Clustering
rss

Residual Sum of Squares and Explained Variance
randomize

Randomizing Data
profplot

Plotting Expression Profiles
rnmf

Generating Random NMF Models
show,NMF-method

Show method for objects of class NMF
show,NMFfitX-method

Show method for objects of class NMFfitX
rmatrix

Generating Random Matrices
predict

Clustering and Prediction
show,NMFList-method

Show method for objects of class NMFList
scale.NMF

Rescaling NMF Models
.fcnnls

Internal Routine for Fast Combinatorial Nonnegative Least-Squares
featureScore

Feature Selection in NMF Models
runtime,NMFList-method

Returns the CPU time required to compute all NMF fits in the list. It returns NULL if the list is empty. If no timing data are available, the sequential time is returned.
show,NMFStrategyIterative-method

Show method for objects of class NMFStrategyIterative
setupBackend

Computational Setup Functions
runtime.all,NMFfitXn-method

Returns the CPU time used to perform all the NMF fits stored in object.
show,NMFfitXn-method

Show method for objects of class NMFfitXn
NMFSeed

NMFSeed is a constructor method that instantiate NMFSeed objects.
smoothing

Smoothing Matrix in Nonsmooth NMF Models
NMFStop

Stopping Criteria for NMF Iterative Strategies
show,NMFns-method

Show method for objects of class NMFns
esGolub

Golub ExpressionSet
lverbose

Internal verbosity option
show,NMFfitX1-method

Show method for objects of class NMFfitX1
cutdendro

Fade Out the Upper Branches from a Dendrogram
show,NMFfit-method

Show method for objects of class NMFfit
nmf_update.lsnmf

Multiplicative Updates for LS-NMF
nmfEstimateRank

Estimate Rank for NMF Models
nmfCheck

Checking NMF Algorithm
syntheticNMF

Simulating Datasets
[,NMF-method

Sub-setting NMF Objects
t.NMF

Transformation NMF Model Objects
methods-NMF

Registry for NMF Algorithms
txtProgressBar

Simple Progress Bar
bterms<-

Fixed Terms in NMF Models
objective,NMFfit-method

Returns the objective function associated with the algorithm that computed the fitted NMF model object, or the objective value with respect to a given target matrix y if it is supplied.
show,NMFOffset-method

Show method for objects of class NMFOffset
offset,NMFOffset-method

Offsets in NMF Models with Offset
utils-NMF

Utility Function in the NMF Package
is.nmf

Testing NMF Objects
staticVar

Get/Set a Static Variable in NMF Algorithms
sparseness

Sparseness
ibterms

Fixed Terms in NMF Models
show,NMFSeed-method

Show method for objects of class NMFSeed
setNMFMethod

Registering NMF Algorithms
silhouette.NMF

Silhouette of NMF Clustering
residuals

Residuals in NMF Models
seed

Interface for NMF Seeding Methods