Main Content

mean

Valeur moyenne ou moyennée d’un tableau

Description

exemple

M = mean(A) renvoie la moyenne des éléments de A le long de la première dimension du tableau dont la taille est supérieure à 1.

  • Si A est un vecteur, mean(A) renvoie la moyenne des éléments.

  • Si A est une matrice, mean(A) renvoie un vecteur ligne contenant la moyenne de chaque colonne.

  • Si A est un tableau multidimensionnel, mean(A) opère le long de la première dimension du tableau dont la taille est supérieure à 1, en traitant les éléments comme des vecteurs. La taille de M dans cette dimension devient 1, tandis que les tailles de toutes les autres dimensions restent identiques à celles de A.

  • Si A est une table ou une timetable, mean(A) renvoie une table à une ligne contenant la moyenne de chaque variable. (depuis R2023a)

exemple

M = mean(A,"all") renvoie la moyenne de tous les éléments de A.

exemple

M = mean(A,dim) renvoie la moyenne sur la dimension dim. Par exemple, si A est une matrice, mean(A,2) renvoie un vecteur colonne contenant la moyenne de chaque ligne.

exemple

M = mean(A,vecdim) renvoie la moyenne basée sur les dimensions spécifiées dans le vecteur vecdim. Par exemple, si A est une matrice, mean(A,[1 2]) renvoie la moyenne de tous les éléments de A, car chaque élément d’une matrice est contenu dans la tranche de tableau définie par les dimensions 1 et 2.

exemple

M = mean(___,outtype) renvoie la moyenne avec un type de données spécifié pour n’importe laquelle des syntaxes précédentes. outtype peut être "default", "double" ou "native".

exemple

M = mean(___,missingflag) spécifie s’il faut inclure ou omettre les valeurs manquantes dans A. Par exemple, mean(A,"omitmissing") ignore toutes les valeurs manquantes lors du calcul de la moyenne. Par défaut, mean inclut les valeurs manquantes.

Exemples

réduire tout

Créez une matrice et calculez la moyenne de chaque colonne.

A = [0 1 1; 2 3 2; 1 3 2; 4 2 2]
A = 4×3

     0     1     1
     2     3     2
     1     3     2
     4     2     2

M = mean(A)
M = 1×3

    1.7500    2.2500    1.7500

Créez une matrice et calculez la moyenne de chaque ligne.

A = [0 1 1; 2 3 2; 3 0 1; 1 2 3]
A = 4×3

     0     1     1
     2     3     2
     3     0     1
     1     2     3

M = mean(A,2)
M = 4×1

    0.6667
    2.3333
    1.3333
    2.0000

Créez un tableau de 4 x 2 x 3 de nombres entiers compris entre 1 et 10 et calculez les valeurs moyennes sur la deuxième dimension.

rng('default')
A = randi(10,[4,2,3]);
M = mean(A,2)
M = 
M(:,:,1) =

    8.0000
    5.5000
    2.5000
    8.0000


M(:,:,2) =

   10.0000
    7.5000
    5.5000
    6.0000


M(:,:,3) =

    6.0000
    5.5000
    8.5000
   10.0000

Créez un tableau 3D et calculez la moyenne sur chaque page de données (lignes et colonnes).

A(:,:,1) = [2 4; -2 1];
A(:,:,2) = [9 13; -5 7];
A(:,:,3) = [4 4; 8 -3];
M1 = mean(A,[1 2])
M1 = 
M1(:,:,1) =

    1.2500


M1(:,:,2) =

     6


M1(:,:,3) =

    3.2500

Pour calculer la moyenne sur toutes les dimensions d’un tableau, vous pouvez soit spécifier chaque dimension dans l’argument de la dimension du vecteur, soit utiliser l’option "all".

M2 = mean(A,[1 2 3])
M2 = 3.5000
Mall = mean(A,"all")
Mall = 3.5000

Créez un vecteur simple précision de uns et calculez sa moyenne simple précision.

A = single(ones(10,1));
M = mean(A,"native")
M = single
    1

Le résultat est également simple précision.

class(M)
ans = 
'single'

Créez une matrice contenant les valeurs NaN.

A = [1.77 -0.005 NaN -2.95; NaN 0.34 NaN 0.19]
A = 2×4

    1.7700   -0.0050       NaN   -2.9500
       NaN    0.3400       NaN    0.1900

Calculez les valeurs moyennes de la matrice, en excluant les valeurs manquantes. Pour les colonnes de la matrice qui contiennent une valeur NaN, mean procède au calcul avec les éléments non NaN. Pour les colonnes de matrice qui contiennent toutes les valeurs NaN, la moyenne est NaN.

M = mean(A,"omitnan")
M = 1×4

    1.7700    0.1675       NaN   -1.3800

Arguments d'entrée

réduire tout

Tableau en entrée, spécifié sous forme de vecteur, de matrice, de tableau multidimensionnel, de table ou de timetable.

  • Si A est un scalaire, mean(A) renvoie A.

  • Si A est une matrice vide de 0 x 0, alors mean(A) renvoie NaN.

Types de données : single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | datetime | duration | table | timetable

Dimension sur laquelle opérer, spécifiée en tant que scalaire entier positif. Si vous ne spécifiez pas la dimension, alors la valeur par défaut est la première dimension de tableau de taille supérieure à 1.

La dimension dim indique la dimension dont la longueur est réduite à 1. size(M,dim) équivaut à 1, tandis que toutes les autres dimensions restent inchangées.

Prenez une matrice A en entrée de dimension m x n :

  • mean(A,1) calcule la moyenne des éléments dans chaque colonne de A et renvoie un vecteur ligne de dimension 1 x n.

    mean(A,1) column-wise operation

  • mean(A,2) calcule la moyenne des éléments de chaque colonne de A et renvoie un vecteur colonne de dimension m x 1.

    mean(A,2) row-wise operation

mean renvoie A lorsque dim est supérieure à ndims(A) ou lorsque size(A,dim) équivaut à 1.

Vecteur de dimensions, spécifié sous forme de vecteur de nombres entiers positifs. Chaque élément représente une dimension du tableau en entrée. Les longueurs de la sortie dans les dimensions de fonctionnement spécifiées sont de 1, tandis que les autres restent inchangées.

Prenez A, un tableau d’entrée de 2 x 3 x 3. mean(A,[1 2]) renvoie alors un tableau de 1 x 1 x 3 dont les éléments correspondent aux moyennes sur chaque page de A.

Mapping of a 2-by-3-by-3 input array to a 1-by-1-by-3 output array

Type de données en sortie, spécifié sous forme de l’une des valeurs dans cette table. Ces options spécifient également le type de données dans lequel l’opération est effectuée.

outtypeType de données en sortie
"default"double, sauf si le type de données en entrée est single, duration, datetime, table ou timetable, auquel cas la sortie est "native"
"double"double, sauf si le type de données en entrée est duration, datetime, table ou timetable, auquel cas "double" n’est pas supporté
"native"

Même type de données qu'en entrée, sauf si :

  • Le type de données en entrée est logical, auquel cas la sortie est double

  • Le type de données en entrée est char, auquel cas "native" n’est pas supporté

  • Le type de données en entrée est timetable, auquel cas la sortie est table

Condition de valeur manquante, spécifiée sous forme de l’une des valeurs de cette table.

ValeurType de données en entréeDescription
"includemissing"Tous les types de données supportés

Inclue les valeurs manquantes dans A lors du calcul de la moyenne. Si un élément de la dimension opérationnelle est manquant, l’élément correspondant dans M l’est également.

"includenan"double, single, duration
"includenat"datetime
"omitmissing"Tous les types de données supportésIgnore les valeurs manquantes dans A et calcule la moyenne sur un nombre réduit de points. Si tous les éléments de la dimension opérationnelle sont manquants, l’élément correspondant dans M l’est également.
"omitnan"double, single, duration
"omitnat"datetime

En savoir plus

réduire tout

Moyenne

Pour un vecteur A de longueur finie composé de N observations scalaires, la moyenne est définie en tant que

μ=1Ni=1NAi.

Capacités étendues

Historique des versions

Introduit avant R2006a

développer tout

Voir aussi

Fonctions