summarise.Ranges {plyranges} | R Documentation

## Reduce multiple values in a Ranges down to a single value

### Description

Reduce multiple values in a Ranges down to a single value

### Usage

    ## S3 method for class 'Ranges'
    summarise(.data, ...)

### Arguments

`.data` | a Ranges object
`...` | Name-value pairs of summary functions. The name will be the name of the variable in the result. The value should be an expression that will return a value that has length one or length equal to the number of groups.

### Details

Creates one or more variables as a `S4Vectors::DataFrame()` from the input Ranges object. If the ranges object is grouped, there will be a row for each group. Because grouping may remove whether a Ranges object is valid, a DataFrame is always returned.

### Value

A `S4Vectors::DataFrame()`

### Examples

    df <- data.frame(start = 1:10, width = 5,  seqnames = "seq1",
    strand = sample(c("+", "-", "*"), 10, replace = TRUE), gc = runif(10))
    rng <- as_granges(df)
    rng %>% summarise(gc = mean(gc))
    rng %>% group_by(strand) %>% summarise(gc = mean(gc))

[Package plyranges version 1.14.0 Index]