R: Most frequent value(s)

mfv {statip} | R Documentation

## Most frequent value(s)

### Description

The function `mfv` returns the most frequent value(s) (or mode(s)) found in a vector. The function `mfv1` returns the first of these values, so that `mfv1(x)` is identical to `mfv(x)[[1L]]`.

### Usage

    mfv(x, na.rm = FALSE, ...)

    mfv1(x, na.rm = FALSE, ...)

### Arguments

`x` | Vector of observations (of type numeric, integer, character, factor, or logical). `x` is to come from a discrete distribution.
`na.rm` | logical. If `TRUE`, missing values do not interfer with the result, see 'Details'.
`...` | Additional arguments (not used).

### Details

See David Smith' blog post here to understand the philosophy followed in the code of `mfv` for missing values treatment.

### Value

The function `mfv` returns a vector of the same type as `x`. One should be aware that this vector can be of length `> 1`, in case of multiple modes. `mfv1` always returns a vector of length `1` (the first of the modes found).

### Note

`mfv` calls the function `tabulate`.

### References

- Dutta S. and Goswami A. (2010). Mode estimation for discrete distributions. Mathematical Methods of Statistics, 19(4):374–384.

### Examples

    # Basic examples:
    mfv(c(3, 3, 3, 2, 4))            # 3
    mfv(c(TRUE, FALSE, TRUE))        # TRUE
    mfv(c("a", "a", "b", "a", "d"))  # "a"

    mfv(c("a", "a", "b", "b", "d"))  # c("a", "b")
    mfv1(c("a", "a", "b", "b", "d")) # "a"

    # With missing values:
    mfv(c(3, 3, 3, 2, NA))           # 3
    mfv(c(3, 3, 2, NA))              # NA
    mfv(c(3, 3, 2, NA), na.rm = TRUE)# 3

    # With only missing values:
    mfv(c(NA, NA))                   # NA
    mfv(c(NA, NA), na.rm = TRUE)     # NaN

[Package statip version 0.2.0 Index]