HitsList-class: List of Hits objects

Description Details Accessors Coercion Note Author(s) See Also


The HitsList class stores a set of Hits objects. It's typically used to represent the result of findOverlaps on two RangesList objects.


Roughly the same set of utilities are provided for HitsList as for Hits:

The as.matrix method coerces a HitsList object in a similar way to Hits, except a column is prepended that indicates which space (or element in the query RangesList) to which the row corresponds.

The as.table method flattens or unlists the list, counts the number of hits for each query range and outputs the counts as a table, which has the same shape as from a single Hits object.

To transpose a HitsList object x, so that the subject and query in each space are interchanged, call t(x). This allows, for example, counting the number of hits for each subject element using as.table.


queryHits(x): Equivalent to unname(as.matrix(x)[,1]).

subjectHits(x): Equivalent to unname(as.matrix(x)[,2]).

space(x): gets the character vector naming the space in the query RangesList for each hit, or NULL if the query did not have any names.


In the code snippets below, x is a HitsList object.

as.matrix(x): calls as.matrix on each Hits, combines them row-wise and offsets the indices so that they are aligned with the result of calling unlist on the query and subject.

as.table(x): counts the number of hits for each query element in x and outputs the counts as a table, which is aligned with the result of calling unlist on the query.

t(x): Interchange the query and subject in each space of x, returns a transposed HitsList object.


This class is highly experimental. It has not been well tested and may disappear at any time.


Michael Lawrence

See Also

  • findOverlaps in the IRanges package, which returns a HitsList object when the query and subject are RangesList objects.

S4Vectors documentation built on May 20, 2017, 10:39 p.m.
Search within the S4Vectors package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.

Please suggest features or report bugs in the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.