mode_first {moder}

The first-appearing mode

Description

mode_first() returns the mode that appears first in a vector, i.e., before any other modes.

Usage

mode_first(x, na.rm = FALSE, accept = FALSE)

Arguments

x

A vector to search for its first mode.

na.rm

Boolean. Should missing values in x be removed before computation proceeds? Default is FALSE.

accept

Boolean. Should the first-appearing value known to be a mode be accepted? If FALSE (the default), returns NA if a value that appears earlier might be another mode due to missing values.

Value

The first mode (most frequent value) in x. If it can't be determined because of missing values, returns NA instead.

See Also

• mode_all() for the full set of modes.

• mode_single() for the only mode, or NA if there are more.

Examples

# `2` is most frequent:
mode_first(c(1, 2, 2, 2, 3))

# Can't determine the first mode --
# it might be `1` or `2` depending
# on the true value behind `NA:
mode_first(c(1, 1, 2, 2, NA))

# Ignore `NA`s with `na.rm = TRUE`
# (there should be good reasons for this!):
mode_first(c(1, 1, 2, 2, NA), na.rm = TRUE)

# `1` is the most frequent value,
# no matter what `NA` stands for:
mode_first(c(1, 1, 1, 2, NA))

# By default, the function insists on
# the first mode, so it won't accept the
# first value *known* to be a mode if an
# earlier value might be a mode, too:
mode_first(c(1, 2, 2, NA))

# You may accept the first-known mode:
mode_first(c(1, 2, 2, NA), accept = TRUE)