read.metharray.sheet: Reading an Illumina methylation sample sheet

View source: R/read.meth.R

read.metharray.sheetR Documentation

Reading an Illumina methylation sample sheet

Description

Reading an Illumina methylation sample sheet, containing pheno-data information for the samples in an experiment.

Usage

read.metharray.sheet(base, pattern = "csv$", ignore.case = TRUE,
    recursive = TRUE, verbose = TRUE)

Arguments

base

The base directory from which the search is started.

pattern

What pattern is used to identify a sample sheet file, see list.files

ignore.case

Should the file search be case sensitive?

recursive

Should the file search be recursive, see list.files?

verbose

Should the function be verbose?

Details

This function search the directory base (possibly including subdirectories depending on the argument recursive for “sample sheet” files (see below). These files are identified solely on the base of their filename given by the arguments pattern and ignore.case (note the use of a dollarsign to mean end of file name).

In case multiple sheet files are found, they are all read and the return object will contain the concatenation of the files.

A sample sheet file is essentially a CSV (comma-separated) file containing one line per sample, with a number of columns describing pheno-data or other important information about the sample. The file may contain a header, in which case it is assumed that all lines up to and including a line starting with \[Data\] should be dropped. This is modelled after a sample sheet file Illumina provides. It is also very similar to the targets file made used by the popular limma package (see the extensive package vignette).

An attempt at guessing the file path to the IDAT files represented in the sheet is made. This should be doublechecked and might need to manually changed.

The type of methylation array is guess by looking at the number of probes in the IDAT files.

Value

A data.frame containing the columns of all the sample sheets. As described in details, a column named Sentrix_Position is renamed to Array and Sentrix_ID is renamed to Slide. In addition the data.frame will contain a column named Basename.

Author(s)

Kasper Daniel Hansenkhansen@jhsph.edu.

See Also

read.metharray.exp and read.metharray for functions reading IDAT files. list.files for help on the arguments recursive and ignore.case.

Examples

if(require(minfiData)) {

baseDir <- system.file("extdata", package = "minfiData")
sheet <- read.metharray.sheet(baseDir)

}

hansenlab/minfi documentation built on May 3, 2024, 3:49 p.m.