ranges-summarise: Reduce multiple values in a Ranges down to a single value

In sa-lee/plyranges: A fluent interface for manipulating GenomicRanges

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))

sa-lee/plyranges documentation built on April 15, 2024, 12:25 p.m.