e– title: “Package Vignette for Genomic Interactions: ChIA-PET data” output: pdf_document: default html_document: keep_md: TRUE —
ChIA-PET
Chromatin interaction analysis with paired-end tag sequencing (ChIA-PET) is a recent method to study protein-mediated interactions at a genome-wide scale. Like most techniques for studying chromatin interaction it is based on chromosome conformation capture technology. Unlike 3C, 4C and 5C, however, it can detect interactions genome-wide, and includes a ChIP step to purify interactions involving a protein of interest.
The raw data from ChIA-PET is in the form of paired-end reads attached to one of two linker sequences. Reads with chimeric linkers are removed, and the data is aligned to the reference genome. The ChIA-PET tool can then be used to find pairs of regions (“anchors”) which have a significant number of reads mapping between them and therefore represent biologically meaningful chromatin interactions in the sample.
Imports
First we need to load the GenomicInteractions package, and the mm9 reference genome:
library(GenomicInteractions)
library(BSgenome.Hsapiens.UCSC.hg19) ## Loading required package: BSgenome
## Loading required package: BiocGenerics
## Loading required package: parallel
##
## Attaching package: 'BiocGenerics'
##
## The following objects are masked from 'package:parallel':
##
## clusterApply, clusterApplyLB, clusterCall, clusterEvalQ,
## clusterExport, clusterMap, parApply, parCapply, parLapply,
## parLapplyLB, parRapply, parSapply, parSapplyLB
##
## The following object is masked from 'package:stats':
##
## xtabs
##
## The following objects are masked from 'package:base':
##
## Filter, Find, Map, Position, Reduce, anyDuplicated, append,
## as.data.frame, as.vector, cbind, colnames, do.call,
## duplicated, eval, evalq, get, intersect, is.unsorted, lapply,
## mapply, match, mget, order, paste, pmax, pmax.int, pmin,
## pmin.int, rank, rbind, rep.int, rownames, sapply, setdiff,
## sort, table, tapply, union, unique, unlist, unsplit
##
## Loading required package: S4Vectors
## Loading required package: stats4
## Loading required package: IRanges
## Loading required package: GenomeInfoDb
## Loading required package: GenomicRanges
## Loading required package: Biostrings
## Loading required package: XVector
## Loading required package: rtracklayerData
We can then read in our data directly from the output of the ChIA-PET tool. At this stage we can also provide information about the cell type and a description tag for the experiment. The data is taken from Li et al., 2012, published in Cell. They have used antibodies against the initiation form of Pol II, which you would expect to find at active promoters, and we are looking at data from the K562 myelogenous leukemia cell line. The data should therefore give us an insight into the processes which regulate genes that are being actively transcribed.
chiapet.data = system.file("extdata/k562.rep1.cluster.pet3+.txt",
package="GenomicInteractions")
k562.rep1 = GenomicInteractions(chiapet.data,
type="chiapet.tool",
experiment_name="k562",
description="k562 pol2 8wg16",
gname="BSgenome.Hsapiens.UCSC.hg19")## Warning in valid.GenomicRanges.seqinfo(x, suggest.trim = TRUE): GRanges object contains 5 out-of-bound ranges located on sequence
## chrM. Note that only ranges located on a non-circular sequence
## whose length is not NA can be considered out-of-bound (use
## seqlengths() and isCircular() to get the lengths and circularity
## flags of the underlying sequences). You can use trim() to trim
## these ranges. See ?`trim,GenomicRanges-method` for more
## information.This loads the data into a GenomicInteractions object, which consists of two linked GenomicRanges objects containing the anchors in each interaction, as well as the p-value, FDR and the number of reads supporting each interaction.
GenomicInteractions Objects
The metadata we have added can easily be accesed, and edited:
name(k562.rep1)## [1] "k562"genomeName(k562.rep1)## [1] "BSgenome.Hsapiens.UCSC.hg19"description(k562.rep1) = "PolII-8wg16 Chia-PET for K562"As can the data from the ChIA-PET experiment:
head(count(k562.rep1))## [1] 3 562 3 3 3 3head(FDR(k562.rep1))## [1] 1.25703e-10 0.00000e+00 1.17148e-06 4.86859e-08 2.76777e-08 3.97019e-08hist(-log10(pValue(k562.rep1)))
The two linked GRanges objects can be returned, but not altered in-place:
anchorOne(k562.rep1)## GRanges object with 64565 ranges and 0 metadata columns:
## seqnames ranges strand
## <Rle> <IRanges> <Rle>
## [1] chr1 [569923, 571422] *
## [2] chr1 [832762, 905482] *
## [3] chr1 [839093, 842325] *
## [4] chr1 [839394, 841792] *
## [5] chr1 [852732, 855234] *
## ... ... ... ...
## [64561] chrX [154432947, 154435728] *
## [64562] chrX [154436729, 154439876] *
## [64563] chrX [154439790, 154442306] *
## [64564] chrX [154459649, 154462031] *
## [64565] chrX [154839051, 154843949] *
## -------
## seqinfo: 93 sequences from an unspecified genomeanchorTwo(k562.rep1)## GRanges object with 64565 ranges and 0 metadata columns:
## seqnames ranges strand
## <Rle> <IRanges> <Rle>
## [1] chrM [ 8343, 10675] *
## [2] chr1 [838471, 920603] *
## [3] chr1 [935529, 939051] *
## [4] chr1 [955082, 956755] *
## [5] chr1 [933686, 937006] *
## ... ... ... ...
## [64561] chrX [154442295, 154446983] *
## [64562] chrX [154442541, 154445105] *
## [64563] chrX [154448372, 154451728] *
## [64564] chrX [154469340, 154471852] *
## [64565] chrX [154843729, 154848393] *
## -------
## seqinfo: 93 sequences from an unspecified genomeGenomicInteractions objects can easily handle interactions detected between chromosomes, known as trans-chromosomal interactions, since the anchors can be at any point along the genome. is.trans returns a logical vector; likewise is.cis is the opposite of this function.
sprintf("Percentage of trans-chromosomal interactions %.2f",
100*sum(is.trans(k562.rep1))/length(k562.rep1))## [1] "Percentage of trans-chromosomal interactions 1.00"The length of each interaction is not stored as metadata, but we can calculate the distance of each interaction using either the inner edge, outer edge or midpoints of the anchors. This is undefined for inter-chromosomal interactions, so NA is returned, so it is important to exclude these interactions from some analyses.
head(calculateDistances(k562.rep1, method="midpoint"))## [1] NA 10414 96580 115324 81362 79097GenomicRanges objects can be subsetted by either integer or logical vectors like most R objects, and also BioConductor Rle objects.
k562.rep1[1:10] # first interactions in the dataset## GenomicInteractions
## Name: k562
## Description: PolII-8wg16 Chia-PET for K562
## Genome: BSgenome.Hsapiens.UCSC.hg19
## Number of individual interactions: 10
## Number of interactions: 624
## Annotated: no
## Annotated with: N/A
## Interactions:
## chr1:569923..571422 ----- chrM:8343..10675
## chr1:832762..905482 ----- chr1:838471..920603
## chr1:839093..842325 ----- chr1:935529..939051
## chr1:839394..841792 ----- chr1:955082..956755
## chr1:852732..855234 ----- chr1:933686..937006
## chr1:855857..858861 ----- chr1:935670..937245
## chr1:874166..879175 ----- chr1:933341..938306
## chr1:874191..877867 ----- chr1:955675..959630
## chr1:889677..896594 ----- chr1:933898..938982
## chr1:898754..907581 ----- chr1:931134..939571k562.rep1[sample(length(k562.rep1), 100)] # 100 interactions subsample## GenomicInteractions
## Name: k562
## Description: PolII-8wg16 Chia-PET for K562
## Genome: BSgenome.Hsapiens.UCSC.hg19
## Number of individual interactions: 100
## Number of interactions: 1069
## Annotated: no
## Annotated with: N/A
## Interactions:
## chr17:1573637..1576029 ----- chr17:1618748..1621956
## chr2:122281738..122285310 ----- chr2:122332356..122335171
## chr3:39144513..39153823 ----- chr3:39150846..39160869
## chr1:65715720..65725861 ----- chr1:65723031..65733565
## chr12:58143080..58147361 ----- chr12:58290609..58293518
## chr11:75108862..75112568 ----- chr11:75234339..75239079
## chr19:19086875..19091371 ----- chr19:19096445..19100736
## chr18:3568387..3571753 ----- chr18:3601489..3605116
## chr11:122872868..122875867 ----- chrM:13944..15911
## chr17:41161648..41166356 ----- chr17:41165757..41170284
## ....k562.cis = k562.rep1[is.cis(k562.rep1)]The length of each interaction is not stored as metadata, but we can calculate the distance of each interaction using either the inner edge, outer edge or midpoints of the anchors. Since this is undefinable for trans-chromosomal interactions it is best to first subset only cis interactions before calling calculateDistances, otherwise NAs will be present in the returned vector.
head(calculateDistances(k562.cis, method="midpoint"))## [1] 10414 96580 115324 81362 79097 59152k562.short = k562.cis[calculateDistances(k562.cis) < 1e6] # subset shorter interactions
hist(calculateDistances(k562.short)) 
We can also subset based on the properties of the linked GRanges objects.
chrom = c("chr17", "chr18")
sub = seqnames(anchorOne(k562.rep1)) %in% chrom & seqnames(anchorTwo(k562.rep1)) %in% chrom
k562.rep1 = k562.rep1[sub]Annotation
Genomic Interaction data is often used to look at the interactions between different elements in the genome, which are believed to have different functional roles. Interactions between promoters and their transcription termination sites, for example, are thought to be a by-product of the transcription process, whereas long-range interactions with enhancers play a role in gene regulation.
Since GenomicInteractions is based on GenomicRanges, it is very easy to interrogate GenomicInteractions objects using GenomicRanges data. In the example, we want to annotate interactions that overlap the promoters, transcription termination sites or the body of any gene. Since this can be a time-consuming and data-heavy process, this example runs the analysis for only chromosomes 17 & 18.
First we need the list of RefSeq transcripts:
library(GenomicFeatures)
hg19.refseq.db <- makeTranscriptDbFromUCSC(genome="hg19", table="refGene")
refseq.genes = genes(hg19.refseq.db)
refseq.transcripts = transcriptsBy(hg19.refseq.db, by="gene")
non_pseudogene = names(refseq.transcripts) %in% unlist(refseq.genes$gene_id)
refseq.transcripts = refseq.transcripts[non_pseudogene] Rather than downloading the whole Refseq database, these are provided for chromosomes 17 & 18:
data("hg19.refseq.transcripts")
refseq.transcripts = hg19.refseq.transcriptsWe can then use functions from GenomicRanges to call promoters and terminators for these transcripts. We have taken promoter regions to be within 2.5kb of an annotated TSS and terminators to be within 1kb of the end of an annotated transcript. Since genes can have multiple transcripts, they can also have multiple promoters/terminators, so these are GRangesList objects, which makes handling these objects slightly more complicated.
refseq.promoters = promoters(refseq.transcripts, upstream=2500, downstream=2500)
# unlist object so "strand" is one vector
refseq.transcripts.ul = unlist(refseq.transcripts)
# terminators can be called as promoters with the strand reversed
strand(refseq.transcripts.ul) = ifelse(strand(refseq.transcripts.ul) == "+", "-", "+")
refseq.terminators.ul = promoters(refseq.transcripts.ul, upstream=1000, downstream=1000)
# change back to original strand
strand(refseq.terminators.ul) = ifelse(strand(refseq.terminators.ul) == "+", "-", "+")
# `relist' maintains the original names and structure of the list
refseq.terminators = relist(refseq.terminators.ul, refseq.transcripts)These can be used to subset a GenomicInteractions object directly from GRanges using the GenomicRanges overlaps methods. findOverlaps called on a GenomicInteractions object will return a list containing Hits objects for both anchors.
We can finds any interactions involving a RefSeq promoter:
subsetByFeatures(k562.rep1, refseq.promoters)## GenomicInteractions
## Name: k562
## Description: PolII-8wg16 Chia-PET for K562
## Genome: BSgenome.Hsapiens.UCSC.hg19
## Number of individual interactions: 2907
## Number of interactions: 58468
## Annotated: no
## Annotated with: N/A
## Interactions:
## chr18:32867582..32873274 ----- chr18:32922823..32925514
## chr18:32868754..32872112 ----- chr18:32951674..32954977
## chr18:32869487..32873870 ----- chr18:32874779..32879603
## chr18:32869840..32873068 ----- chr18:32879913..32884536
## chr18:47003049..47019610 ----- chr18:47008666..47025005
## chr18:47012484..47015203 ----- chr18:47812091..47814221
## chr17:79346130..79394680 ----- chr17:79351995..79402511
## chr17:79355826..79362327 ----- chr17:79476977..79481908
## chr17:79359152..79363524 ----- chr17:79446741..79452118
## chr17:79359808..79362448 ----- chr17:79407414..79411196
## ....However, one of the most powerful features in the GenomicInteractions package is the ability to annotate each anchor with a list of genomic regions and then summarise interactions according to these features. This annotation is implemented as metadata columns for the anchors in the GenomicInteractions object and so is fast, and facilitates more complex analyses.
The order in which we annotate the anchors is important, since each anchor can only have one node.class. The first listed take precedence. Any regions not overlapping ranges in annotation.features will be labelled as distal.
annotation.features = list(promoter=refseq.promoters,
terminator=refseq.terminators,
gene.body=refseq.transcripts)
annotateInteractions(k562.rep1, annotation.features)## Annotating with promoter ...
## Annotating with terminator ...
## Annotating with gene.body ...annotationFeatures(k562.rep1)## [1] "gene.body" "promoter" "distal" "terminator"We can now find interactions involving promoters using the annotated node.class for each anchor:
p.one = anchorOne(k562.rep1)$node.class == "promoter"
p.two = anchorTwo(k562.rep1)$node.class == "promoter"
k562.rep1[p.one|p.two]## GenomicInteractions
## Name: k562
## Description: PolII-8wg16 Chia-PET for K562
## Genome: BSgenome.Hsapiens.UCSC.hg19
## Number of individual interactions: 2907
## Number of interactions: 58468
## Annotated: yes
## Annotated with: promoter, gene.body, distal, terminator
## Interactions:
## chr17:616580..621961 ----- chr17:620669..626263
## chr17:632528..638035 ----- chr17:636590..641349
## chr17:634120..651606 ----- chr17:642300..659172
## chr17:654893..657597 ----- chr17:683192..687275
## chr17:656003..658841 ----- chr17:679596..682692
## chr17:673770..677108 ----- chr17:682371..686167
## chr17:683084..686703 ----- chr17:898969..901916
## chr17:687188..690752 ----- chr17:693438..696262
## chr17:898836..907994 ----- chr17:904952..915973
## chr17:1074362..1080545 ----- chr17:1079966..1084168
## ....This information can be used to categorise interactions into promoter-distal, promoter-terminator etc. A table of interaction types can be generated with categoriseInteractions:
categoriseInteractions(k562.rep1)## category count
## 1 gene.body-gene.body 795
## 2 gene.body-promoter 917
## 3 gene.body-distal 76
## 4 gene.body-terminator 164
## 5 promoter-promoter 1187
## 6 promoter-distal 519
## 7 promoter-terminator 284
## 8 distal-distal 396
## 9 distal-terminator 101
## 10 terminator-terminator 70Alternatively, we can subset the object based on interaction type:
k562.rep1[isInteractionType(k562.rep1, "terminator", "gene.body")]## GenomicInteractions
## Name: k562
## Description: PolII-8wg16 Chia-PET for K562
## Genome: BSgenome.Hsapiens.UCSC.hg19
## Number of individual interactions: 164
## Number of interactions: 930
## Annotated: yes
## Annotated with: terminator, gene.body
## Interactions:
## chr17:1471461..1474306 ----- chr17:1476213..1479585
## chr17:1632604..1638741 ----- chr17:1636658..1642967
## chr17:3845976..3849573 ----- chr17:3908009..3910817
## chr17:4055646..4058706 ----- chr17:4063342..4068158
## chr17:4443890..4451615 ----- chr17:4446815..4454998
## chr17:5277711..5281329 ----- chr17:5288795..5291138
## chr17:5281726..5286005 ----- chr17:5287752..5290284
## chr17:5286162..5289463 ----- chr17:5292806..5296669
## chr17:7093706..7096305 ----- chr17:7099230..7102080
## chr17:7358505..7360654 ----- chr17:7366458..7368912
## ....The 3 most common node.class values have short functions defined for convenience (see ?is.pp for a complete list):
k562.rep1[is.pp(k562.rep1)] # promoter-promoter interactions
k562.rep1[is.dd(k562.rep1)] # distal-distal interactions
k562.rep1[is.pt(k562.rep1)] # promoter-terminator interactionsSummary plots of interactions classes can easily be produced to get an overall feel for the data:
plotInteractionAnnotations(k562.rep1, other=5)
viewpoints will only take those interactions with a certain node.class:
plotInteractionAnnotations(k562.rep1, other=5, viewpoints="promoter")
These are also combined in the function plotSummaryStats.
Feature Summaries
The summariseByFeatures allows us to look in more detail at interactions involving a specific set of loci. In this example we use all RefSeq promoters, which we already have loaded in a GRangesList object.
It is however possible to use any dataset which can be represented as a named GRanges object, for example transcription-factor ChIP data, predicted cis-regulatory sites or certain categories of genes.
The categories are generated automatically from the annotated node.class values in the object.
k562.rep1.promoter.annotation = summariseByFeatures(k562.rep1, refseq.promoters,
"promoter", distance.method="midpoint",
annotate.self=TRUE)
colnames(k562.rep1.promoter.annotation)## [1] "Promoter.id"
## [2] "numberOfPromoterInteractions"
## [3] "numberOfPromoterUniqueInteractions"
## [4] "numberOfPromoterInterChromosomalInteractions"
## [5] "numberOfPromoterUniqueInterChromosomalInteractions"
## [6] "numberOfPromoterGene.bodyInteractions"
## [7] "numberOfPromoterPromoterInteractions"
## [8] "numberOfPromoterDistalInteractions"
## [9] "numberOfPromoterTerminatorInteractions"
## [10] "numberOfUniquePromoterGene.bodyInteractions"
## [11] "numberOfUniquePromoterPromoterInteractions"
## [12] "numberOfUniquePromoterDistalInteractions"
## [13] "numberOfUniquePromoterTerminatorInteractions"
## [14] "PromoterDistanceMedian"
## [15] "PromoterDistanceMean"
## [16] "PromoterDistanceMinimum"
## [17] "PromoterDistanceMaximum"
## [18] "PromoterDistanceWeightedMedian"
## [19] "numberOfSelfPromoterGene.bodyInteractions"
## [20] "numberOfSelfPromoterPromoterInteractions"
## [21] "numberOfSelfPromoterTerminatorInteractions"
## [22] "numberOfSelfUniquePromoterGene.bodyInteractions"
## [23] "numberOfSelfUniquePromoterPromoterInteractions"
## [24] "numberOfSelfUniquePromoterTerminatorInteractions"This allows us to very quickly generate summaries of the data and provides a quick method to isolate genes of interest. In this case we produce lists of RefSeq IDs, which can easily be converted to EntrezIDs or gene symbols through existing BioConductor packages (in this case org.Hs.eg.db provides bimaps between common human genome annotations).
Which promoters have the strongest Promoter-Promoter interactions based on PET-counts?
i = order(k562.rep1.promoter.annotation$numberOfPromoterPromoterInteractions,
decreasing=TRUE)[1:10]
k562.rep1.promoter.annotation[i,"Promoter.id"]## [1] "100506779" "9256" "406934" "54894" "100616220"
## [6] "6827" "56155" "5889" "5034" "396"Which promoters are contacting the largest number of distal elements?
i = order(k562.rep1.promoter.annotation$numberOfUniquePromoterDistalInteractions,
decreasing=TRUE)[1:10]
k562.rep1.promoter.annotation[i,"Promoter.id"]## [1] "10140" "400604" "7050" "100130581" "100616277"
## [6] "26118" "100874261" "101927666" "140735" "5366"What percentage of promoters are in contact with transcription termination sites?
total = sum(k562.rep1.promoter.annotation$numberOfPromoterTerminatorInteractions > 0)
sprintf("%.2f%% of promoters have P-T interactions", 100*total/nrow(k562.rep1.promoter.annotation))## [1] "16.43% of promoters have P-T interactions"References
Li, Guoliang, et al. “Software ChIA-PET tool for comprehensive chromatin interaction analysis with paired-end tag sequencing.” Genome Biol 11 (2010): R22.
Li, Guoliang, et al. “Extensive promoter-centered chromatin interactions provide a topological basis for transcription regulation.” Cell 148.1 (2012): 84-98