# `stats`::`mean`

Arithmetic mean of a data sample

MuPAD® notebooks will be removed in a future release. Use MATLAB® live scripts instead.

MATLAB live scripts support most MuPAD functionality, though there are some differences. For more information, see Convert MuPAD Notebooks to MATLAB Live Scripts.

## Syntax

```stats::mean(`x1, x2, …`)
stats::mean(`[x1, x2, …]`)
stats::mean(`s`, <`c`>)
```

## Description

`stats::mean`(x1, x2, …, xn) returns the arithmetic mean of the data xi.

The column index `c` is optional if the data are given by a `stats::sample` object containing only one non-string column. Cf. Example 3.

External statistical data stored in an ASCII file can be imported into a MuPAD® session via `import::readdata`. In particular, see Example 1 of the corresponding help page.

## Examples

### Example 1

We calculate the arithmetic mean of three values:

`stats::mean(a, b, c)`

Alternatively, data may be passed as a list:

`stats::mean([2, 3, 5])`

### Example 2

We create a sample:

`stats::sample([[a1, b1, c1], [a2, b2, c2]])`
```a1 b1 c1 a2 b2 c2 ```

The arithmetic mean of the second column is:

`stats::mean(%, 2)`

### Example 3

We create a sample consisting of one string column and one non-string column:

`stats::sample([["1996", 1242], ["1997", 1353], ["1998", 1142]])`
```"1996" 1242 "1997" 1353 "1998" 1142 ```

We compute the arithmetic mean of the second column. In this case, this column does not have to be specified, since it is the only non-string column:

`float(stats::mean(%))`

## Parameters

 `x1, x2, …` The statistical data: arithmetical expressions. `s` A sample of domain type `stats::sample`. `c` An integer representing a column index of the sample `s`. This column provides the data `x1`, `x2` etc.

## Return Values

Arithmetical expression.

#### Mathematical Modeling with Symbolic Math Toolbox

Get examples and videos