ranges-select: Select metadata columns of the Ranges object by name or...

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

Select metadata columns of the Ranges object by name or position

Description

Select metadata columns of the Ranges object by name or position

Usage

## S3 method for class 'Ranges'
select(.data, ..., .drop_ranges = FALSE)

Arguments

.data	a Ranges object
...	One or more metadata column names.
.drop_ranges	If TRUE select will always return a tibble. In this case, you may select columns that form the core part of the Ranges object.

Details

Note that by default select only acts on the metadata columns (and will therefore return a Ranges object) if a core component of a Ranges is dropped or selected without the other required components (this includes the seqnames, strand, start, end, width names), then select will throw an error unless .drop_ranges is set to TRUE.

Value

a Ranges object or a tibble

See Also

dplyr::select()

Examples

df <- data.frame(start = 1:10, width = 5,  seqnames = "seq1",
strand = sample(c("+", "-", "*"), 10, replace = TRUE), gc = runif(10), counts = rpois(10, 2))
rng <- as_granges(df)
select(rng, -gc)
select(rng, gc)
select(rng, counts, gc)
select(rng, 2:1)
select(rng, seqnames, strand, .drop_ranges = TRUE)

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