R: Bin a Numeric Vector

.bincode {base} | R Documentation

## Bin a Numeric Vector

### 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`, 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 to `NA` codes, as are values outside range of `breaks`.

### See Also

`cut`, `tabulate`

### 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 3.1.2 Index]