README.md

Epicopy

Epicopy is an R package that obtains copy number variation (CNV) information from Illumina Human Methylation 450K microarrays. If the users have their own reference normal samples or decide to not use any normals for reference (see Usage section below), Epicopy can be used as a standalone package.

If not, users may choose to install its companion package "EpicopyData" which contains a series of normal tissues compiled from the Cancer Genome Atlas (TCGA) effort. It contains normal tissues from three sources; thyroid, breast, and lung. For more information on EpicopyData please visit the EpicopyData page.

Changelog

[20170202] v0.99.7: Remove EpicopyData dependency for vignette.

Installation

The preferred method for installation is through Hadley Wickham's install_github function through the package devtools.

If users have their own normal samples, it is recommended that they install the standalone version as it is much smaller in size.

Standalone

To install the standalone package use the following line:

devtools::install_github('sean-cho/Epicopy')

Complete

The complete version includes all the normals compiled from TCGA.

Step 1: Install EpicopyData

Please download the binary release here and run the following lines of code.

path <- "path.to.file/EpicopyData_1.0.1.tar.gz"
install.packages(path, repos = NULL, type = 'source')

Step 2a: Install Epicopy without vignette

devtools::install_github('sean-cho/Epicopy')

Step 2b: Install Epicopy with vignette

Warning: Please note that the vignette includes the complete processing of three example raw data files and may take a while to build.

devtools::install_github('sean-cho/Epicopy', build_vignette = TRUE)

Usage

Standalone

Since no vignette is built, users can view the online vignette for examples here. Additional information is also available in the help files.

The key to using Epicopy as a standalone package is to specify normals in the samplesheet or, missing that, Epicopy will use the median of all the samples in the epicopy or getLRR functions. This is important, as the default argument uses all normals included in the EpicopyData package.

With EpicopyData normals

Install and build the vignette. Users may specify any of the normals included in with the EpicopyData package using the options: - all or NULL (default): Uses all EpicopyData normals, or median of all samples if EpicopyData is not installed. - thyroid, breast, or lung: Uses normal tissue of specified organ.

More information is available using ?getLRR.



sean-cho/Epicopy documentation built on May 29, 2019, 4:24 p.m.