summariseByFeaturePairs {GenomicInteractions} | R Documentation

## Summarise the number of interactions between two sets of features.

### Description

This function will calculate the number of observed interactions between two sets of features provided by the end-user. This allows the summarisation of the number of features of a specific type a particular region is involved in and how many interactions exist between them.

### Usage

    summariseByFeaturePairs(
      GIObject,
      features.one,
      feature.name.one,
      features.two,
      feature.name.two
    )

    ## S4 method for signature 'GInteractions'
    summariseByFeaturePairs(
      GIObject,
      features.one,
      feature.name.one,
      features.two,
      feature.name.two
    )

### Arguments

`GIObject` | An annotated GInteractions object
`features.one` | A GRanges object containing the feature set of interest
`feature.name.one` | The name of the first feature set of interest
`features.two` | A GRanges object containing the second feature set of interest
`feature.name.two` | The name of the second feature set of interest

### Value

A data frame with one line for each range in ‘features’

### Examples

    data('hic_example_data')
    data('mm9_refseq_promoters')
    data('thymus_enhancers')
    annotateInteractions(hic_example_data, list(promoter = mm9_refseq_promoters, enhancer = thymus_enh))
    # can be slow so subset of features used for examples
    p <- unique(unlist(head(regions(hic_example_data)$promoter.id)))
    e <- unique(unlist(head(regions(hic_example_data)$enhancer.id)))
    p <- p[!is.na(p)]
    p <- mm9_refseq_promoters[p]
    e <- e[!is.na(e)]
    e <- thymus_enh[e]
    ep_summary <- summariseByFeaturePairs(hic_example_data, p, 'promoter', e, 'enhancer')

[Package GenomicInteractions version 1.26.0 Index]