binCounts: Fast element counting in non-overlapping bins
In matrixStats: Methods that apply to rows and columns of a matrix

Description Usage Arguments Details Value Missing and non-finite values Author(s) See Also

Counts the number of elements in non-overlapping bins

1 2	## Default S3 method: binCounts(x, bx, right=FALSE, ...)

`x`	A `numeric` `vector` of K positions for to be binned and counted.
`bx`	A `numeric` `vector` of B+1 ordered positions specifying the B bins `[bx[1],bx[2])`, `[bx[2],bx[3])`, ..., `[bx[B],bx[B+1])`.
`right`	If `TRUE`, the bins are right-closed (left open), otherwise left-closed (right open).
`...`	Not used.

binCounts(x, bx, right=TRUE) gives equivalent results as rev(binCounts(-x, bx=rev(-bx), right=FALSE)), but is faster and more memory efficient.

Returns an integer vector of length B with non-negative integers.

Missing values in x are ignored/dropped. Missing values in bx are not allowed and gives an error.

Henrik Bengtsson

An alternative for counting occurances within bins is hist, e.g. hist(x, breaks=bx, plot=FALSE)$counts. That approach is ~30-60% slower than binCounts(..., right=TRUE).

To count occurances of indices x (positive integers) in [1,B], use tabulate(x, nbins=B), where x does not have to be sorted first. For details, see tabulate().

To average values within bins, see binMeans().

matrixStats documentation built on May 2, 2019, 4:52 p.m.