harmean

Paramètres

x

vecteur, matrice, ou hypermatrice de nombres réels ou complexes, ou de polynômes à coefficients réels ou complexes. Fractions rationelles non acceptées.

orientation

indice de la dimension selon laquelle harmean est calculée. Il peut être

• un caractère "*" (default), "r", "c" or "m". "m" est équivalent à find(size(x)>1,1).
• un entier positif. 1 est équivalent à "r" et 2 est équivalent à "c".

hm

scalaire, ou vecteur ligne (si "r" est utilisé), ou vecteur colonne (si "c" est utilisé). Si x sont des polynômes, hm est de type fraction rationelle.

Description

harmean calcule la moyenne harmonique des valeurs d'entrée, c'est à dire l'inverse de la moyenne des inverses des valeurs d'entrée non nulles.

hm = harmean(x) or hm = harmean(x, '*') retourne la moyenne harmonique de tous les éléments de x.

hm = harmean(x,'r') (ou hm = harmean(x, 1) ) retourne le vecteur ligne hm où hm(1,j) est la moyenne harmonique de chaque colonne x(:,j).

hm = harmean(x,'c') (ou hm = harmean(x, 2) ) retourne le vecteur colonne hm où hm(i,1) est la moyenne harmonique de chaque ligne x(i,:).

Si x est une hypermatrice et une option "r", 1, "c", 2 est utilisée, une erreur se produit.

Exemples

harmean(1:10) // Retourne 1 / mean(1 ./(1:10))
h = harmean([1 1 0 1 0 1])  // retourne 1: les zéros ne sont pas considérés
1 / mean(1./[1 1 0 1 0 1])  // retourne 0 dés qu'au moins un zéro est fourni

x = grand(3, 4, "uin",-10, 10)
harmean(x)
harmean(x, "r")
harmean(x, 2)

// Hypermatrice
x = grand(3,4,2, "uin",-10, 10)
harmean(x)
// attention: harmean(x, "r") et harmean(x, 3) génère une erreur: syntaxe exclue avec les hypermatrices

harmean([%z 0])
harmean([%z %z/2])
harmean([%z %i+%z])
harmean([%z %i+%z]) == 1 / ((1/%z + 1/(%i+%z))/2)

Bibliographie

Wonacott, T.H. & Wonacott, R.J.; Introductory Statistics, 5ème édition, J.Wiley & Sons, 1990.

Voir aussi

• mean — mean of all values, or means along a given dimension
• geomean — moyenne géométrique