modes (version 0.6.1)

mode: Mode

Description

This function calculates the mode for an integer valued data vector by default. It also calculates "nmore" more modes than the most frequently occurring value and can take in data that should be treated as integers, real numbers (which can optionally be rounded to the "digits" number of significant digits), or factors. This mode function finds the value(s) that occur most frequently so, crucially, if there is a tie in the frequency count for the mode it will yield two modes instead of the lower valued mode. Yielding all modes instead of just the lowest mode is particularly important when more advanced statistics and machine learning techniques are employed.

Usage

mode(data, type = 1, digits = "NULL", nmore = "NULL")

Arguments

data

Data vector.

type

The type of data the vector contains. Defaults to 1.

• "1" converts the data to integers and then finds the mode(s)
• "2" rounds the data to the number of significant digits found in 'digits' and then finds the mode(s)
• "3" treat

digits

How many significant digits should be retained? Defaults to NULL.

nmore

{Specifices how many modes should be attempted. That is, it finds the "nmore" modes with decreasing frequency. For example, if the data is bimodal, specify nmore=2 and the two most frequent values with their frequency will be returned.}

...

Pass through arguments.

Examples

#Example 1
data<-c(rep(6,9),rep(3,3))
#mode(data,type=1,"NULL","NULL")

#Example 2
#data<-c(rep(6,9),rep(3,9))
#mode(data,type=1,"NULL","NULL")

#Example 3
#data<-c(rep(6,9),rep(3,8),rep(7,7),rep(2,6))
#mode(data,type=1,"NULL",2)

#Example 4
#data<-c(rnorm(15,0,1),rnorm(21,5,1),rep(3,3))
#mode(data)

#Example 5
#data<-c(rep(6,3),rep(3,3),rnorm(15,0,1))
#mode(data,3,NULL,4)
#mode(data,type=2,digits=1,3)