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 other 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 (2017) Understanding
##   sequencing data as compositions: an outlook and review. bioRxiv:
##   doi:10.1101/206425
## 
##   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.1.9

License

GPL-2

Issues

Pull Requests

Stars

Forks

Maintainer

Thomas Quinn

Last Published

April 19th, 2018

Functions in propr (3.1.9)

calculateFDR

Calculate FDR Cutoffs
lr2cor

Correlate CLR with a Continuous Measurement
multiplot

Plot Multiple Graphs
progress

Make Progress Bar
permuteTheta

Permute Theta
promptCheck

Feature Check
permuteTheta_false

Permute Theta
alphaThetaW_old

Calculate Weighted Theta
top.lr

Example propr Object
visualize

Visualize Proportionality
permuteTheta_prime

Permute Theta
plotCheck

Plot Check
alphaTheta_old

Calculate alpha Theta
proprTri

Retrieve the lower left triangle of a proportionality matrix.
caneToad.groups

Example Cane Toad Group Data
aldex2propr

Import ALDEx2 Object
alphaTheta

Calculate alpha Theta
proprVLR

Calculates the variance of the log of the ratios.
calculateTheta_old

Calculate Theta
dendroCheck

Dendrogram Plot Check
caneToad.counts

Example Cane Toad Count Data
packageCheck

Package Check
proprSym

Symmetrizes a proportionality matrix.
proportionality

Calculate Proportionality
pals

Calculate PALs for Pairs
proprPhit

Calculate proportionality metric phi (Lovell 2015).
propr

The propr Package
prop2prob

Calculate Probability from Proportionality
pd.e

Example propd Object
calculateThetaW_old

Calculate Weighted Theta
calculateTheta

Calculate Theta
pd.d

Example propd Object
propd

The propd Method
ratios

Recast Matrix as Feature Ratios
mail

Mock Mail Count Data
marg.abs

Example Absolute mRNA
permuteTheta_naive

Permute Theta
permuteTheta_old

Permute Theta
top.counts

Example propr Object
proprALR

Calculates the additive log-ratio transformation.
proprCLR

Calculates the centered log-ratio transformation.
proprPairs

Recasts proportionality matrix as a table of feature pairs.
proprPerb

Calculate proportionality metric rho (Erb 2016).
calculateFDR_old

Calculate FDR Cutoffs
ivar2index

Build Index from ivar Argument
abstract

Abstract Two propr Objects
aldex.cor

Correlate CLR with a Continuous Measurement
ggdend

Dendrogram Plot Wrapper
differentialCheck

Differential Proportionality Check
migraph

igraph Helper Functions