--- title: F. ChIP-seq author: Martin Morgan (mtmorgan@fredhutch.org) date: "`r Sys.Date()`" output: BiocStyle::html_document: markdown_strict: true toc: true vignette: > %\VignetteIndexEntry{F. ChIP-seq} %\VignetteEngine{knitr::rmarkdown} \usepackage[utf8]{inputenc} --- ```{r style, echo=FALSE, results='asis'} BiocStyle::markdown() ``` ```{r setup, echo=FALSE} options(digits=3) suppressPackageStartupMessages({ library(csaw) library(edgeR) library(GenomicRanges) library(ChIPseeker) library(genefilter) }) ``` # Motivation & work flow Key references - Kharchenko, Tolstorukov, and Park ([2008](http://www.ncbi.nlm.nih.gov/pmc/articles/PMC2597701/)). - Lun and Smyth ([2014](http://dx.doi.org/10.1093/nar/gku351)). ## ChIP-seq Kharchenko et al. ([2008](http://www.ncbi.nlm.nih.gov/pmc/articles/PMC2597701/)). ![ChIP-seq Overview](our_figures/ChIPSeq_nbt-1508-F1.jpg) - Tags versus sequenced reads; single-end read extension in 3' direction - Strand shift / cross-correlation - Defined (narrow, e.g., transcription factor binding sites) versus diffuse (e.g., histone marks) peaks ChIP-seq for differential binding - Designed experiment with replicate samples per treatment - Analysis using insights from microarrays / RNA-seq Novel statistical issues - Inferring peaks without 'data snooping' (using the same data twice, once to infer peaks, once to estimate differential binding) - Retaining power - Minimizing false discovery rate ## Work flow - Following Bailey et al., [2013](http://dx.doi.org/10.1371/journal.pcbi.1003326) ![](our_figures/ChIPSeq-workflow.png) Experimental design and execution - Single sample - ChIPed transcription factor and\ldots - Input (fragmented genomic DNA) or control (e.g., IP with non-specific antibody such as immunoglobulin G, IgG) - Designed experiments - Replication of TF / control pairs Sequencing & alignment - Sequencing depth rules of thumb: $>10M$ reads for narrow peaks, $>20M$ for broad peaks - Long & paired end useful but not essential -- alignment in ambiguous regions - Basic aligners generally adequate, e.g., no need to align splice junctions - Sims et al., [2014](http://dx.doi.org/10.1038/nrg3642) Peak calling - Very large number of peak calling programs; some specialized for e.g., narrow vs. broad peaks. - Commmonly used: [MACS](http://liulab.dfci.harvard.edu/MACS/), PeakSeq, CisGenome, ... - MACS: Model-based Analysis for ChIP-Seq, Liu et al., [2008](http://dx.doi.org/10.1186/gb-2008-9-9-r137) - Scale control tag counts to match ChIP counts - Center peaks by shifting $d/2$ - Model occurrence of a tag as a Poisson process - Look for fixed width sliding windows with exceess number of tag enrichment - Empirical FDR: Swap ChIP and control samples; FDR is \# control peaks / \# ChIP peaks - Output: BED file of called peaks Down-stream analysis - Annotation: what genes are my peaks near? - Differential representation: which peaks are over- or under-represented in treatment 1, compared to treatment 2? - Motif identification (peaks over known motifs?) and discovery - Integrative analysis, e.g., assoication of regulatory elements and expression ## Peak calling 'Known' ranges - Count tags in pre-defined ranges, e.g., promoter regions of known genes - Obvious limitations, e.g., regulatory elements not in specified ranges; specified range contains multiple regulatory elements with complementary behavior _de novo_ windows - Width: narrow peaks, 1bp; broad peaks, 150bp - Offset: 25-100bp; influencing computational burden _de novo_ peak calling - Third-party software (many available; [MACS](http://liulab.dfci.harvard.edu/MACS/) commonly used) - Various strategies for calling peaks -- Lun & Smyth, [Table 1](http://nar.oxfordjournals.org/content/42/11/e95/T1.expansion.html) - Call each sample independently; intersection or union of peaks across samples, ... - Call peaks from a pooled library - ... - Relevant slides [pdf](http://bioconductor.org/help/course-materials/2014/CSAMA2014/4_Thursday/lectures/ChIPSeq_slides.pdf) ## Peak calling across libraries - Table 1: Description of peak calling strategies. Each strategy is given an identifier and is described by the mode in which MACS is run, the libraries on which it is run and the consolidation operation (if any) performed to combine peaks between libraries or groups. For method 6, the union of the peaks in each direction of enrichment is taken.
ID Mode Library Operation
1 Single-sample Individual Union
2 Single-sample Individual Intersection
3 Single-sample Individual At least 2
4 Single-sample Pooled over group Union
5 Single-sample Pooled over group Intersection
6 Two-sample Pooled over group Union
7 Single-sample Pooled over all
- How to choose? -- Lun & Smyth, - Under the null hypothesis, type I error rate is uniform - [Table 2](http://nar.oxfordjournals.org/content/42/11/e95/T2.expansion.html): consequences for type I error - Best strategy: call peaks from a pooled library - Table 2: The observed type I error rate when testing for differential enrichment using counts from each peak calling strategy. Error rates for a range of specified error thresholds are shown. All values represent the mean of 10 simulation iterations with the standard error shown in brackets. RA: reference analysis using 10 000 randomly chosen true peaks.
ID Error rate
  0.01 0.05 0.1
RA 0.010 (0.000) 0.051 (0.001) 0.100 (0.002)
1 0.002 (0.000) 0.019 (0.001) 0.053 (0.001)
2 0.003 (0.000) 0.030 (0.000) 0.073 (0.001)
3 0.006 (0.000) 0.042 (0.001) 0.092 (0.001)
4 0.033 (0.001) 0.145 (0.001) 0.261 (0.002)
5 0.000 (0.000) 0.001 (0.000) 0.005 (0.000)
6 0.088 (0.006) 0.528 (0.013) 0.893 (0.006)
7 0.010 (0.000) 0.049 (0.001) 0.098 (0.001)
```{r null-p, cache=TRUE} ## 100,000 t-tests under the null, n = 6 n <- 6; m <- matrix(rnorm(n * 100000), ncol=n) P <- genefilter::rowttests(m, factor(rep(1:2, each=3)))$p.value quantile(P, c(.001, .01, .05)) hist(P, breaks=20) ``` _de novo_ hybrid strategies # Practical: Differential binding (`r Biocpkg("csaw")`) This exercise is based on the `r Biocpkg("csaw")` vignette, where more detail can be found. ## 1 - 4: Experimental Design ... Alignment The experiment involves changes in binding profiles of the NFYA protein between embryonic stem cells and terminal neurons. It is a subset of the data provided by Tiwari et al. [2012](http://dx.doi.org/10.1038/ng.1036) available as [GSE25532](http://www.ncbi.nlm.nih.gov/geo/query/acc.cgi?acc=GSE25532). There are two es (embryonic stem cell) and two tn (terminal neuron) replicates. Single-end FASTQ files were extracted from GEO, aligned using `r Biocpkg("Rsubread")`, and post-processed (sorted and indexed) using `r Biocpkg("Rsamtools")` with the script available at ```{r csaw-preprocess, eval=FALSE} system.file(package="UseBioconductor", "scripts", "ChIPSeq", "NFYA", "preprocess.R") ``` Create a data frame summarizing the files used. ```{r csaw-setup} files <- local({ acc <- c(es_1="SRR074398", es_2="SRR074399", tn_1="SRR074417", tn_2="SRR074418") data.frame(Treatment=sub("_.*", "", names(acc)), Replicate=sub(".*_", "", names(acc)), sra=sprintf("%s.sra", acc), fastq=sprintf("%s.fastq.gz", acc), bam=sprintf("%s.fastq.gz.subread.BAM", acc), row.names=acc, stringsAsFactors=FALSE) }) ``` ## 5: Reduction Change to the directory where the BAM files are located ```{r csaw-setwd, eval=FALSE} setwd("~/UseBioconductor-data/ChIPSeq/NFYA") ``` Load the csaw library and count reads in overlapping windows. This returns a `SummarizedExperiment`, so explore it a bit... ```{r csaw-reduction, eval=FALSE} library(csaw) library(GenomicRanges) frag.len <- 110 system.time({ data <- windowCounts(files$bam, width=10, ext=frag.len) }) # 156 seconds acc <- sub(".fastq.*", "", data$bam.files) colData(data) <- cbind(files[acc,], colData(data)) ``` ## 6: Analysis **Filtering** (vignette Chapter 3) Start by filtering low-count windows. There are likely to be many of these (how many?). Is there a rational way to choose the filtering threshold? ```{r csaw-filter, eval=FALSE} library(edgeR) # for aveLogCPM() keep <- aveLogCPM(assay(data)) >= -1 data <- data[keep,] ``` ```{r csaw-data-load, echo=FALSE} frag.len <- 110 fl <- system.file(package="UseBioconductor", "extdata", "csaw-data-filtered.Rds") data <- readRDS(fl) ``` **Normalization (composition bias)** (vignette Chapter 4) csaw uses binned counts in normalization. The bins are large relative to the ChIP peaks, on the assumption that the bins primarily represent non-differentially bound regions. The sample bin counts are normalized using the `r Biocpkg("edgeR")` TMM (trimmed median of M values) method seen in the RNASeq differential expression lab. Explore vignette chapter 4 for more on normalization (this is a useful resource when seeking to develop normalization methods for other protocols!). ```{r csaw-normalize, eval=FALSE} system.time({ binned <- windowCounts(files$bam, bin=TRUE, width=10000) }) #139 second normfacs <- normalize(binned) ``` ```{r csaw-normacs-load, echo=FALSE} fl <- system.file(package="UseBioconductor", "extdata", "csaw-normfacs.Rds") normfacs <- readRDS(fl) ``` **Experimental design and Differential binding** (vignette Chapter 5) Differential binding will be assessed using `r Biocpkg("edgeR")`, where we need to specify the experimental design ```{r csaw-experimental-design} design <- model.matrix(~Treatment, colData(data)) ``` Apply a standard `r Biocpkg("edgeR")` work flow to identify differentially bound regions. Creatively explore the results. ```{r csaw-de} y <- asDGEList(data, norm.factors=normfacs) y <- estimateDisp(y, design) fit <- glmQLFit(y, design, robust=TRUE) results <- glmQLFTest(fit, contrast=c(0, 1)) head(results$table) ``` **Multiple testing** (vignette Chapter 6) The challenge is that FDR across all detected differentially bound _regions_ is what one is interested in, but what is immediately available is the FDR across differentially bound _windows_; region will often consist of multiple overlapping windows. As a first step, we'll take a 'quick and dirty' approach to identifying regions by merging 'high-abundance' windows that are within, e.g., 1kb of one another ```{r csaw-merge-windows} merged <- mergeWindows(rowRanges(data), tol=1000L) ``` Combine test results across windows within regions. Several strategies are explored in section 6.5 of the vignette. ```{r csaw-combine-merged-tests} tabcom <- combineTests(merged$id, results$table) head(tabcom) ``` Section 6.6 of the vignette discusses approaches to identifying the 'best' windows within regions. Finally, create a `GRangesList` that associated with two result tables and the genomic ranges over which the results were calculated. ```{r csaw-grangeslist} gr <- rowRanges(data) mcols(gr) <- as(results$table, "DataFrame") grl <- split(gr, merged$id) mcols(grl) <- as(tabcom, "DataFrame") ``` ## Annotation ### csaw ### ChIPseeker