R: Bin a Numeric Vector (original) (raw)
| .bincode {base} | R Documentation |
|---|
Description
Bin a numeric vector and return integer codes for the binning.
Usage
.bincode(x, breaks, right = TRUE, include.lowest = FALSE)
Arguments
| x | a numeric vector which is to be converted to integer codes by binning. |
|---|---|
| breaks | a numeric vector of two or more cut points, sorted in increasing order. |
| right | logical, indicating if the intervals should be closed on the right (and open on the left) or vice versa. |
| include.lowest | 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. |
Details
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](../../base/help/cut.html), 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.
Value
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 toNA codes, as are values outside range of breaks.
See Also
[cut](../../base/help/cut.html), [tabulate](../../base/help/tabulate.html)
Examples
## 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 4.6.0 Index]