pA_logit_dev: pA_logit_dev

View source: R/Tests.R

pA_logit_devR Documentation

pA_logit_dev

Description

Function to evaluate the overall effect of predictors on pA usage per transcript through a deviance test.

Usage

pA_logit_dev(data, model, design = NULL, sample_ID = NULL)

Arguments

data

Dataset containing poly A (pA) site read counts. This dataset must have a long shape, meaning that there should be only one column containing read counts (and it MUST be named "count"). The first four columns must be called "transcript", "pA.site", "sample" and "count". Thus, each row in data contains the read count for one pA - transcript - sample combination. Other sample attributes beyond sample ID may be recorded in additional variables in this dataset, or provided separately through a design matrix and a key variable (e.g. sample ID) connecting the data and design matrices.

model

Regression model describing the dependence of pA site usage on sample attribute(s).

design

(optional) Design matrix. A matrix describing sample attributes which can be used as predictors in the regression model.

sample_ID

(optional) A key variable connecting the counts dataset (data) and the design matrix.

Details

A deviance test compares the likelihood of the fitted model with its corresponding null. In other words, it tests how much the prediction of response is improved by including the covariates, compared to a model with no covariates (the intercept only or null model). In the case of poly A site usage, a logistic regression model is run first (but the outcome is not reported); then, instead of reporting the effects of individual predictors (covariates) on the ratio of specific pairs of pA sites, a deviance test reveals the overall relevance or informativeness of all the predictors in the model towards the pA site usage pattern for each transcript across samples.

Value

Deviance test p-values (one per transcript).

Examples

fit3_pA <- pA_logit_dev(pA.toy2, pA.site ~ cell_line, pA_design, "sample")

goodarzilab/APAlog documentation built on March 25, 2022, 3:40 p.m.