Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
2024.1.0 - Français


harmean

moyenne harmonique : inverse de la moyenne des inverses (zéros exclus)

Syntaxe

hm = harmean(x)
hm = harmean(x, orientation)

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 hmhm(1,j) est la moyenne harmonique de chaque colonne x(:,j).

hm = harmean(x,'c') (ou hm = harmean(x, 2) ) retourne le vecteur colonne hmhm(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
Report an issue
<< geomean Moyennes - Valeur centrale mean >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Jun 17 17:52:28 CEST 2024