Mode - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Statistics

  

Mode

  

compute the mode

 

Calling Sequence

Parameters

Description

Computation

Data Set Options

Random Variable Options

Notes

Examples

References

Compatibility

Calling Sequence

Mode(A, ds_options)

Mode(X, rv_options)

Parameters

A

-

data set or Matrix data set

X

-

algebraic; random variable or distribution

ds_options

-

(optional) equation(s) of the form option=value where option is one of ignore, weights, type, bandwidth, bins, left, right, result; specify options for computing the mode of a data set

rv_options

-

(optional) equation of the form numeric=value; specifies options for computing the mode of a random variable

Description

• 

The Mode function computes the mode of the specified random variable or computes the kernel or sample mode for a data set.

• 

The first parameter can be a data set (for example, a Vector), a Matrix data set, a distribution (see Statistics[Distribution]), a random variable, or an algebraic expression involving random variables (see Statistics[RandomVariable]).

Computation

• 

By default, all computations involving random variables are performed symbolically (see option numeric below).

• 

All computations involving data are performed in floating-point; therefore, all data provided must have type/realcons and all returned solutions are floating-point, even if the problem is specified with exact values.

• 

For more information about computation in the Statistics package, see the Statistics[Computation] help page.

Data Set Options

  

The ds_options argument can contain one or more of the options shown below. More information for some options is available in the Statistics[DescriptiveStatistics] help page.

• 

ignore=truefalse -- This option controls how missing data is handled by the Mode command. Missing items are represented by undefined or Float(undefined). So, if ignore=false and A contains missing data, the Mode command will return undefined. If ignore=true all missing items in A will be ignored. The default value is false.

• 

weights=rtable -- Vector of weights (one-dimensional rtable). If weights are given, the Mode function will scale each data point to have given weight. Note that the weights provided must have type/realcons and the results are floating-point, even if the problem is specified with exact values. Both the data array and the weights array must have the same number of elements.

• 

type=sample or kernel -- The type options indicates what mode type should be calculated on the data set (by default this is set to sample'.  If sample' is set, the sample mode (defined as the most frequent data item in the set) will be calculated.  If kernel is set, the kernel mode (defined as the mode of a kernel density estimate based on the data set) will be calculated.

• 

kernel=gaussian, biweight, epanechnikov, triangular or rectangular -- If type='kernel' then this option specifies the type of kernel used in the kernel density estimate (by default this is gaussian).  This parameter is ignored otherwise.

• 

bandwidth=realcons -- If type='kernel' then this options specifies the bandwidth of the kernel density estimate (by default this is 1/4).  This parameter is ignored otherwise.

• 

bins=posint -- If type='kernel' and result='discrete' then this option represents the number of bins used in the operation of calculating a discrete kernel density estimate (by default this is 512).  This parameter is ignored otherwise.

• 

left=realcons -- If type='kernel' then this option represents the lower (left) bound on elements of the data sample used in calculating the kernel density estimate.  This parameter is ignored otherwise.

• 

right=realcons -- If type='kernel' then this option represents the upper (right) bound on elements of the data sample used in calculating the kernel density estimate.  This parameter is ignored otherwise.

• 

method=discrete or exact -- If type='kernel' then this parameter specifies the output method for the kernel density estimate (by default this is discrete).  This parameter is ignored otherwise.

Random Variable Options

  

The rv_options argument can contain one or more of the options shown below. More information for some options is available in the Statistics[RandomVariables] help page.

• 

numeric=truefalse -- By default, the mode is computed using exact arithmetic. To compute the mode numerically, specify the numeric or numeric = true option.

Notes

• 

This function is only guaranteed to return one potential mode. In cases where multiple modes exist, only the first detected mode is guaranteed to be returned. If a single mode is detected, it is returned as a number, whereas if multiple modes are detected, they are returned as a set or range.

• 

Note that discrete kernel density estimation removes results that do not fall within the generated range, including missing data.  Hence, if you do not specify result='exact' option, missing data will be automatically ignored.

Examples

withStatistics:

Compute the mode of the Weibull distribution with parameters p and q.

ModeWeibullp,q

0q<1p11q1qotherwise

(1)

Use numeric parameters.

ModeWeibull3&comma;5

34155455

(2)

ModeWeibull3&comma;5&comma;numeric

2.869057499

(3)

Determine the mode of a set of sample data (most frequently occurring item).

A1&comma;2&comma;2&comma;2&comma;3&comma;4&comma;5&comma;5&comma;5&comma;6&comma;7&comma;7&comma;7&comma;7&comma;7&comma;7&comma;8&comma;8&comma;1&comma;1&comma;2&comma;3&comma;4&comma;5&colon;

ModeA

7.

(4)

Generate a random sample of size 100000 drawn from the above distribution and compute the sample mode.

ASampleWeibull3&comma;5&comma;105&colon;

ModeA&comma;type=kernel

2.86291749594519

(5)

Compute the mode of a sum of two random variables.

XRandomVariableNormal5&comma;2

X_R3

(6)

YRandomVariableNormal10&comma;1&colon;

ModeX+Y

15

(7)

Verify this using simulation.

CSampleX+Y&comma;105&colon;

ModeC&comma;type=kernel

14.8615452068189

(8)

Compute the mode of a weighted data set.

Vseqi&comma;i=57..77&comma;undefined&colon;

W2&comma;4&comma;14&comma;41&comma;83&comma;169&comma;394&comma;669&comma;990&comma;1223&comma;1329&comma;1230&comma;1063&comma;646&comma;392&comma;202&comma;79&comma;32&comma;16&comma;5&comma;2&comma;5&colon;

ModeV&comma;weights=W

67.

(9)

ModeV&comma;type=kernel&comma;weights=W

67.0284486386156

(10)

Consider the following Matrix data set.

MMatrix3&comma;1130&comma;114694&comma;4&comma;1527&comma;127368&comma;3&comma;1527&comma;88464&comma;2&comma;878&comma;96484&comma;4&comma;995&comma;96484

M31130114694415271273683152788464287896484499596484

(11)

We compute the mode of each of the columns.

ModeM

3.&comma;4.1527.96484.

(12)

References

  

Stuart, Alan, and Ord, Keith. Kendall's Advanced Theory of Statistics. 6th ed. London: Edward Arnold, 1998. Vol. 1: Distribution Theory.

Compatibility

• 

The A parameter was updated in Maple 16.

See Also

Statistics

Statistics[Computation]

Statistics[DescriptiveStatistics]

Statistics[Distributions]

Statistics[ExpectedValue]

Statistics[KernelDensity]

Statistics[RandomVariables]

Statistics[StandardError]