as_factor {mlr3misc} | R Documentation

## Convert to Factor

### Description

Converts a vector to a `factor()` and ensures that levels are in the order of the provided levels.

### Usage

    as_factor(x, levels, ordered = is.ordered(x))

### Arguments

`x` | (atomic `vector()`) Vector to convert to factor.
`levels` | (`character()`) Levels of the new factor.
`ordered` | (`logical(1)`) If `TRUE`, create an ordered factor.

### Value

(`factor()`).

### Examples

    x = factor(c("a", "b"))
    y = factor(c("a", "b"), levels = c("b", "a"))

    # x with the level order of y
    as_factor(x, levels(y))

    # y with the level order of x
    as_factor(y, levels(x))

[Package mlr3misc version 0.8.0 Index]