rnaither: Wrapper function for full automated analysis

Description Usage Arguments Value Examples

View source: R/rnaistat.R

Description

Performs a standard analysis of the data (quality and statistics) from a dataset file.

Usage

1
rnaither(data, expname, excludeCellcounts="none", logtransform=FALSE, normalization=c("lowess","bscore"), test="ttest", scorethresh=2.0, pvalthresh=0.05, dogo=FALSE, outdir="results", layoutnames="NA", makeplots=TRUE, reorder=TRUE)               

Arguments

data

A data frame containing the experimental data to analyze. Each row is corresponding to one well, with the following columns:

  • Spotnumber The position of the well on the plate

  • Internal_GeneID The ID of the siRNA

  • GeneName The gene name

  • SpotType Can be -1, 0, 1 or 2. Type -1 wells (e.g. emtpy wells, wells with poor quality) are not considered in subsequent analyses but are kept in the data set for the sake of completeness. Type 0 wells correspond to negative controls, type 1 wells to positive controls. Type 2 wells correspond to the standard data wells.

  • SigIntensity The signal intensity (channel 1)

  • SDSIntensity The standard deviation of the signal intensity, if available

  • Background The background per well, if available

  • LabtekNb The plate number

  • RowNb The row number

  • ColNb The column number

  • ScreenNb The screen number

  • NbCells E.g. the number of cells identified in the well (channel 2)

  • PercCells The ratio (number of identified cells)/(number of identified objects)

expname

A character string, assigning a name to the experiment. This will be used as title in the html output generated by rnaither.

excludeCellcounts

a string constant, one of "none", "lowest", "both", "lowestperplate" or "bothperplate". The default is "none". This parameter can be used to exclude wells from the analysis that have very low or very high numbers of cells.

  • "none"No wells will be excluded based on the number of cells they contain.

  • "lowest", "lowestperplate"The wells with the lowest 5 percent of cellcounts will be excluded from further analysis. "lowest" will consider the entire screen at once, and exclude the wells that are overall the lowest 5 percent. "lowestperplate" will consider each plate separately, excluding on each plate the 5 percent of wells having the lowest cellcounts.

  • "both", "bothperplate"The wells with the lowest and highest 5 percent of cellcounts will be excluded from further analysis. Excluding wells with high cell counts may be useful for image based screens, if it is suspected that cells overlap in images, which might cause problems for image processing. "both" will consider the entire screen at once, and exclude the wells that are overall the lowest and highest 5 percent. "bothperplate" will consider each plate separately, excluding on each plate the 5 percent of wells having the lowest and highest cellcounts.

logtransform

A logical variable, specifying whether or not the signal intensities should be log-transformed. Default is FALSE.

normalization

A list of strings containing the normalization steps to carry out. The default are is c("lowess","bscore"). The following normalization procedures are available:

  • "lowess"To carry out lowess normalization. This corrects for effects of cell counts on the signal intensities.

  • "liwong"To carry out Li-Wong rank normalization of the signal intensities.

  • "varadjust"To divide each signal intensity value by the variance of the signal intensities on the respective plate.

  • "divnorm"To divide each signal intensity value by the median signal intensity of the respective plate.

  • "quantile"To carry out a quantile normalization on the signal intensities.

  • "bscore"To carry out a bscore normalization on the signal intensities (corrects for spatial effects on a plate.

  • "zscore"To carry out a zscore normalization (subtract median of plate, divide by median absolute deviation per plate).

  • "negcontrol"To normalize on the negative controls - subtract median of negative controls, divide by MAD of negative controls, per plate.

  • "percontrol"To do a percentage of controls normalization - Rescale signal intensities so that mean of negative controls is 100, mean of positive controls is 0.

  • "percneg"To do a percentage of negative controls normalization - set mean of negative controls to 100, zero signal intensity remains at 0. Normalization routines will be executed in the order as they occur in the list.

test

Specify what statistical test should be used to identify hits. One of

  • "ttest"to carry out a t-test if the mean score for a given siRNA / Gene is 0.

  • "wilcox"to carry out a Wilcoxon test if the mean score for a given siRNA / Gene is 0.

  • "none"to carry out no statistical test.

The default is "ttest".

scorethresh

The threshold on the normalized score to be used to identify hits. The default is 2.0, hence siRNAs with score > +2 or score < -2 are considered hits.

pvalthresh

The threshold on the p-value from the statistical test to be used to identify hits. The default is 0.05

dogo

A logical variable, specifies whether or not a Gene Ontology-based analysis should be carried out. This parameter is currently ignored, GO is presently not supported nby the rnaither wrapper.

outdir

a string specifying the directory in which the results should be stored. Can be an absolute or relative path.

layoutnames

A list of strings, that can be used to assign names to different layouts in the screen. The list should contain the same number of elements as there are different layouts in the screen. These names will be used as labels for the layouts in the html output. If this parameter is not specified, layouts will be numbered in the canonical way.

makeplots

TRUE or FALSE, if set to FALSE, only a subset of the quality control plots will be generated. This speeds up processing, but will result in missing images in the html output.

reorder

logical variable, indicating whether dataset should be reordered prior to processing further. This is recommended if the data frame is incomplete, i.e. if wells or plates are missing completely. reorder=T will considerably slow down the analysis.

Value

Generates the html output file index.html in the directory specified by the outdir parameter.

Examples

1
2
3
data(exampleDataset, package="RNAither")

rnaither(dataset, expname="Example", excludeCellcounts="none", logtransform=FALSE, normalization=c("lowess","zscore"), test="none", scorethresh=2.0, pvalthresh=0.05, outdir="results")

RNAither documentation built on Nov. 8, 2020, 8:06 p.m.