normalize2Reference: Quantile Normalize Columns of a Matrix Based on a Reference Distribution

Description

Normalize the columns of a matrix to have the same quantiles, allowing for missing values. Users do not normally need to call this function directly - use normalize.AffyBatch.normalize2Reference instead.

Usage

normalize2Reference(data, refData = NULL, ties = TRUE)

Arguments

data

numeric matrix. Missing values are allowed.

refData

A vector of reference values.

ties

logical. If TRUE, ties in each column of A are treated in careful way. Tied values will be normalized to the mean of the corresponding pooled quantiles.

Value

A matrix of the same dimensions as A containing the normalized values.

Details

This function is intended to normalize single channel or A-value microarray intensities between arrays. Each quantile of each column is set to either: quantiles of the reference distribution (refData supplied) or the mean of that quantile across arrays (refData is NULL) . The intention is to make all the normalized columns have the same empirical distribution. This will be exactly true if there are no missing values and no ties within the columns: the normalized columns are then simply permutations of one another.

If there are ties amongst the intensities for a particular array, then with ties=FALSE the ties are broken in an unpredictable order. If ties=TRUE, all the tied values for that array will be normalized to the same value, the average of the quantiles for the tied values.

References