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

Change language to:
English - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Aide de Scilab >> Statistiques > Moyennes - Valeur centrale > harmean

harmean

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

Syntaxe

hm = harmean(x)
hm = harmean(x, 'r'|1 )
hm = harmean(x, 'c'|2 )

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.

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,'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)
harmean(x, "r") // erreur: syntaxe exclue avec les hypermatrices
harmean(x, 3)   // idem

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 (row mean, column mean) of vector/matrix entries
  • 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:
Tue Feb 25 08:50:25 CET 2020