modal

0th

Percentile

modal value

Compute the mode for a vector of numbers, or across raster layers. The mode, or modal value, is the most frequent value in a set of values.

Keywords
math, univar
Usage
# S4 method for ANY
modal(x, ..., ties='random', na.rm=FALSE, freq=FALSE)

# S4 method for Raster modal(x, ..., ties='random', na.rm=FALSE, freq=FALSE)

Arguments
x

vector of numbers (typically integers), characters, logicals, or factors, or a Raster* object

...

additional argument of the same type as x

ties

character. Indicates how to treat ties. Either 'random', 'lowest', 'highest', 'first', or 'NA'

na.rm

logical. If TRUE, NA values are ignored. If FALSE, NA is returned if x has any NA values

freq

return the frequency of the modal value, instead of the modal value

Value

vector or RasterLayer. The vector has length 1 and is of the same type as x, except when x is a factor and additional arguments (values) are supplied, in which case the values are coerced to characters and a character value is returned.

Aliases
  • modal
  • modal,ANY-method
  • modal,Raster-method
Examples
# NOT RUN {
data <- c(0,1,2,3,3,3,3,4,4,4,5,5,6,7,7,8,9,NA)
modal(data, na.rm=TRUE)
# }
Documentation reproduced from package raster, version 2.9-5, License: GPL (>= 3)

Community examples

Looks like there are no examples yet.