.bincode {base}R Documentation

Bin a Numeric Vector


Bin a numeric vector and return integer codes for the binning.


.bincode(x, breaks, right = TRUE, include.lowest = FALSE)



a numeric vector which is to be converted to integer codes by binning.


a numeric vector of two or more cut points, sorted in increasing order.


logical, indicating if the intervals should be closed on the right (and open on the left) or vice versa.


logical, indicating if an ‘x[i]’ equal to the lowest (or highest, for right = FALSE) ‘breaks’ value should be included in the first (or last) bin.


This is a ‘barebones’ version of cut.default(labels = FALSE) intended for use in other functions which have checked the arguments passed. (Note the different order of the arguments they have in common.)

Unlike cut, the breaks do not need to be unique. An input can only fall into a zero-length interval if it is closed at both ends, so only if include.lowest = TRUE and it is the first (or last for right = FALSE) interval.


An integer vector of the same length as x indicating which bin each element falls into (the leftmost bin being bin 1). NaN and NA elements of x are mapped to NA codes, as are values outside range of breaks.

See Also

cut, tabulate


## An example with non-unique breaks:
x <- c(0, 0.01, 0.5, 0.99, 1)
b <- c(0, 0, 1, 1)
.bincode(x, b, TRUE)
.bincode(x, b, FALSE)
.bincode(x, b, TRUE, TRUE)
.bincode(x, b, FALSE, TRUE)

[Package base version 3.3.2 Index]