Learn R Programming

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

Quick start

Welcome to the propr GitHub page!

The bioinformatic evaluation of gene co-expression often begins with correlation-based analyses. However, this approach lacks statistical validity when applied to relative data. This includes, for example, biological count data generated by high-throughput RNA-sequencing, chromatin immunoprecipitation (ChIP), ChIP-sequencing, Methyl-Capture sequencing, and other techniques. This package implements several metrics for proportionality, including phi [Lovell et al (2015)] and rho [Erb and Notredame (2016)]. This package also implements several metrics for differential proportionality. Unlike correlation, these measures give the same result for both relative and absolute data.

library(devtools)
devtools::install_github("tpq/propr")
library(propr)
?propr

Further reading

To learn more about proportionality, please see the vignettes and relevant literature.

citation("propr")
## 
## To cite propr in publications use:
## 
##   Quinn T, Richardson MF, Lovell D, Crowley T (2017) propr: An
##   R-package for Identifying Proportionally Abundant Features Using
##   Compositional Data Analysis. Scientific Reports 7(16252):
##   doi:10.1038/s41598-017-16520-0
## 
##   Erb I, Quinn T, Lovell D, Notredame C (2017) Differential
##   Proportionality - A Normalization-Free Approach To Differential
##   Gene Expression. Proceedings of CoDaWork 2017, The 7th
##   Compositional Data Analysis Workshop; available under bioRxiv
##   134536: doi:10.1101/134536
## 
##   Quinn T, Erb I, Richardson MF, Crowley T (2018) Understanding
##   sequencing data as compositions: an outlook and review.
##   Bioinformatics. Advanced Access Publication:
##   doi:10.1093/bioinformatics/bty175
## 
##   Lovell D, Pawlowsky-Glahn V, Egozcue JJ, Marguerat S, Bahler J
##   (2015) Proportionality: A Valid Alternative to Correlation for
##   Relative Data. PLoS Comput Biol 11(3):
##   doi:10.1371/journal.pcbi.1004075
## 
##   Erb I, Notredame C (2016) How should we measure proportionality
##   on relative gene expression data? Theory Biosci 135(1):
##   doi:10.1007/s12064-015-0220-8
## 
## To see these entries in BibTeX format, use 'print(<citation>,
## bibtex=TRUE)', 'toBibtex(.)', or set
## 'options(citation.bibtex.max=999)'.

Copy Link

Version

Install

install.packages('propr')

Monthly Downloads

166

Version

3.5.1

License

GPL-2

Issues

Pull Requests

Stars

Forks

Maintainer

Thomas Quinn

Last Published

May 9th, 2018

Functions in propr (3.5.1)

calculateThetaW_old

Calculate Weighted Theta
calculateFDR_old

Calculate FDR Cutoffs
calculateTheta

Calculate Theta
calculateFDR

Calculate FDR Cutoffs
caneToad.counts

Example Cane Toad Count Data
abstract

Abstract Two propr Objects
aldex2propr

Import ALDEx2 Object
aldex.cor

Correlate CLR with a Continuous Measurement
marg.abs

Example Absolute mRNA
alphaThetaW_old

Calculate Weighted Theta
caneToad.groups

Example Cane Toad Group Data
ggdend

Dendrogram Plot Wrapper
mail

Mock Mail Count Data
ivar2index

Build Index from ivar Argument
migraph

igraph Helper Functions
multiplot

Plot Multiple Graphs
lr2cor

Correlate CLR with a Continuous Measurement
pd.e

Example propd Object
permuteTheta

Permute Theta
packageCheck

Package Check
pals

Calculate PALs for Pairs
permuteTheta_false

Permute Theta
permuteTheta_old

Permute Theta
permuteTheta_prime

Permute Theta
permuteTheta_naive

Permute Theta
pd.d

Example propd Object
propr

The propr Package
prop2prob

Calculate Probability from Proportionality
promptCheck

Feature Check
plotCheck

Plot Check
top.counts

Example propr Object
propd

The propd Method
progress

Make Progress Bar
proprALR

Calculates the additive log-ratio transformation.
top.lr

Example propr Object
proprSym

Symmetrizes a proportionality matrix.
proportionality

Calculate Proportionality
proprCLR

Calculates the centered log-ratio transformation.
proprPerb

Calculate proportionality metric rho (Erb 2016).
proprPairs

Recasts proportionality matrix as a table of feature pairs.
proprTri

Retrieve the lower left triangle of a proportionality matrix.
proprVLR

Calculates the variance of the log of the ratios.
visualize

Visualize Proportionality
ratios

Recast Matrix as Feature Ratios
proprPhit

Calculate proportionality metric phi (Lovell 2015).
calculateTheta_old

Calculate Theta
alphaTheta_old

Calculate alpha Theta
differentialCheck

Differential Proportionality Check
dendroCheck

Dendrogram Plot Check