select.Ranges {plyranges} | R Documentation

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

[Package plyranges version 1.12.1 Index]