Introduction

The statistics module in Python provides a variety of functions for statistical calculations, including the multimode() function, which specifically addresses the need to find all modes in a dataset. This feature is useful when dealing with complex datasets where multiple values may share the highest frequency.

This article will explore how to use the statistics.multimode() function, including its synteax, parameters, and practical examples.

Using the multimode() Function

The syntax for the statistics.multimode() function is as follows:

statistics.multimode(data)

where data represents the input dataset, which must be a list or an iterable containing numerical or categorical values. The statistics.multimode() function returns a list of modes found in the input data. If there are multiple modes, they will all be included in the returned list. If there is no single mode — meaning all values occur with equal frequency — the function will return all unique values in the dataset.

Let’s start with a simple example where we have a dataset with a single mode.

import statistics
data = [1, 2, 2, 3, 4]
modes = statistics.multimode(data)
print(modes)

# Output: [2]

In this example, the number 2 appears most frequently, thus it is returned as the mode.

Now consider a dataset that has multiple modes.

data = [1, 1, 2, 2, 3, 4]
modes = statistics.multimode(data)
print(modes)

# Output: [1, 2]

Here, both 1 and 2 occur with the same highest frequency, so the function returns both values.

Let’s explore what happens when there is no mode.

data = [1, 2, 3, 4]
modes = statistics.multimode(data)
print(modes)

# Output: [1, 2, 3, 4]

In this case, since all values occur only once, the function returns a list of all unique values.

The statistics.multimode() function is also effective for categorical data. Consider the following example.

data = ['apple', 'banana', 'apple', 'orange', 'banana']
modes = statistics.multimode(data)
print(modes)

# Output: ['apple', 'banana']

In this dataset, both apple and banana occur most frequently, resulting in both being returned as modes.

For the curious, if an empty list is passed as input, the function will return an empty list:

data = []
modes = statistics.multimode(data)
print(modes)

# Output: []

Wrapping Up

The statistics.multimode() function is a helpful tool for identifying modes in both numerical and categorical datasets. For further learning, consider exploring additional resources on statistics and data analysis in Python — including the Python statistics module’s official documentation — which can enhance your data science skills and knowledge.