Learn R Programming

lumi (version 2.24.0)

ssn: Simple Scaling Normalization

Description

This function basically adjusts the samples to the same background level and then optionally scales to the same foreground level.

Usage

ssn(x.lumi, targetArray = NULL, scaling = TRUE, bgMethod=c('density', 'mean', 'median', 'none'), fgMethod=c('mean', 'density', 'median'), ...)

Arguments

x.lumi
an ExpressionSet inherited object or a data matrix with columns as samples and rows as genes
targetArray
A target chip is the model for other chips to normalize. It can be a column index, a vector or a LumiBatch object with one sample.
scaling
determine whether do scaling or just background shift
bgMethod
optional methods of determining the background level
fgMethod
optional methods of determining the foreground level
...
other parameters used by density function

Value

Return an object with expression values normalized. The class of the return object is the same as the input object x.lumi.

Details

This function basically adjusts the samples to the same background level and then optionally scales to the same foreground level. The adjustment is based on the raw scale data (For the transformed data, it still estimates the parameters in the raw scale by inverse transformation.). Comparing with other normalization methods, like quantile and curve-fitting methods, SSN is a more conservative method. The only assumption is that each sample has the same background levels and the same scale (if do scaling). There are three methods ('density', 'mean' and 'median') for background estimation. If bgMethod is 'none', then the background level will be set as 0, i.e., no background adjustment. For the 'density' bgMethod, it estimates the background based on the mode of probe intensities based on the assumption that the background level intensity is the most frequent value across all the probes in the chip. For the foreground level estimation, it also provides three methods ('mean', 'density', 'median'). For the 'density' fgMethod, it assumes the background probe levels are symmetrically distributed. Then we estimate the foreground levels by taking the intensity mean of all other probes except from the background probes. For the 'mean' and 'median' methods (for both bgMethod and fgMethod), it basically estimates the level based on the mean or median of all probes of the sample. If the fgMethod is the same as bgMethod (except 'density' method), no scaling will be performed.

See Also

lumiN