harmmean

Media armónica

Sintaxis

m = harmmean(X)

m = harmmean(X,'all')

m = harmmean(X,dim)

m = harmmean(X,vecdim)

m = harmmean(___,nanflag)

Descripción

m = harmmean(X) calcula la media armónica de una muestra. Para vectores, harmmean(X) es la media armónica de los elementos de X. Para matrices, harmmean(X) es un vector fila que contiene las medias armónicas de cada una de las columnas. Para arreglos de N dimensiones, harmmean opera a lo largo de la primera dimensión no singular de X.

m = harmmean(X,'all') devuelve la media armónica de todos los elementos de X.

m = harmmean(X,dim) toma la media armónica a lo largo de la dimensión operativa dim de X.

m = harmmean(X,vecdim) devuelve la media armónica a lo largo de las dimensiones especificadas en el vector vecdim. Cada elemento de vecdim representa una dimensión del arreglo de entrada X. La salida m tiene la longitud 1 en las dimensiones operativas especificadas. El resto de las longitudes de las dimensiones son iguales para X e m. Por ejemplo, si X es un arreglo de 2 por 3 por 4, entonces harmmean(X,[1 2]) devuelve un arreglo de 1 por 1 por 4. Cada elemento del arreglo de salida es la media armónica de los elementos de la página correspondiente de X.

m = harmmean(___,nanflag) especifica si se deben excluir los valores NaN del cálculo, utilizando cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores. De forma predeterminada, harmmean incluye los valores NaN en el cálculo (nanflag tiene el valor 'includenan'). Para excluir los valores NaN, establezca el valor de nanflag en 'omitnan'.

Ejemplos

Comparar la media armónica y aritmética

Establezca la semilla aleatoria para reproducir los resultados.

rng('default')

Cree una matriz de números aleatorios exponenciales con 5 filas y 4 columnas.

X = exprnd(1,5,4)

X = 5×4

    0.2049    2.3275    1.8476    1.9527
    0.0989    1.2783    0.0298    0.8633
    2.0637    0.6035    0.0438    0.0880
    0.0906    0.0434    0.7228    0.2329
    0.4583    0.0357    0.2228    0.0414

Calcule las medias armónica y aritmética de las columnas de X.

harmonic = harmmean(X)

harmonic = 1×4

    0.1743    0.0928    0.0797    0.1205

arithmetic = mean(X)

arithmetic = 1×4

    0.5833    0.8577    0.5734    0.6357

La media aritmética es mayor que la media armónica para todas las columnas de X.

Media armónica de todos los valores

Encuentre la media armónica de todos los valores de un arreglo.

Cree un arreglo de 3 por 5 por 2 X.

X = reshape(1:30,[3 5 2])

X = 
X(:,:,1) =

     1     4     7    10    13
     2     5     8    11    14
     3     6     9    12    15


X(:,:,2) =

    16    19    22    25    28
    17    20    23    26    29
    18    21    24    27    30

Encuentre la media armónica de los elementos de X.

m = harmmean(X,'all')

m = 
7.5094

Media armónica a lo largo de las dimensiones especificadas

Encuentre la media armónica a lo largo de diferentes dimensiones operativas y vectores de dimensiones de un arreglo multidimensional.

Cree un arreglo de 3 por 5 por 2 X.

X = reshape(1:30,[3 5 2])

X = 
X(:,:,1) =

     1     4     7    10    13
     2     5     8    11    14
     3     6     9    12    15


X(:,:,2) =

    16    19    22    25    28
    17    20    23    26    29
    18    21    24    27    30

Encuentre la media armónica de X a lo largo de la dimensión predeterminada.

hmean1 = harmmean(X)

hmean1 = 
hmean1(:,:,1) =

    1.6364    4.8649    7.9162   10.9392   13.9523


hmean1(:,:,2) =

   16.9607   19.9666   22.9710   25.9743   28.9770

De manera predeterminada, harmmean opera a lo largo de la primera dimensión de X cuyo tamaño es distinto de 1. En este caso, esta dimensión es la primera dimensión de X. Por consiguiente, hmean1 es un arreglo de 1 por 5 por 2.

Encuentre la media armónica de X a lo largo de la segunda dimensión.

hmean2 = harmmean(X,2)

hmean2 = 
hmean2(:,:,1) =

    3.1852
    5.0641
    6.5693


hmean2(:,:,2) =

   21.1595
   22.1979
   23.2329

hmean2 es un arreglo de 3 por 1 por 2.

Encuentre la media armónica de X a lo largo de la tercera dimensión.

hmean3 = harmmean(X,3)

hmean3 = 3×5

    1.8824    6.6087   10.6207   14.2857   17.7561
    3.5789    8.0000   11.8710   15.4595   18.8837
    5.1429    9.3333   13.0909   16.6154   20.0000

hmean3 es un arreglo de 3 por 5.

Encuentre la media armónica de cada página de X especificando la primera y la segunda dimensión con el argumento de entrada vecdim.

mpage = harmmean(X,[1 2])

mpage = 
mpage(:,:,1) =

    4.5205


mpage(:,:,2) =

   22.1645

Por ejemplo, mpage(1,1,2) es la media armónica de los elementos de X(:,:,2).

Encuentre la media armónica de los elementos de cada porción de X(i,:,:) especificando la segunda y la tercera dimensión.

mrow = harmmean(X,[2 3])

mrow = 3×1

    5.5369
    8.2469
   10.2425

Por ejemplo, mrow(3) es la media armónica de los elementos de X(3,:,:) y es equivalente a especificar harmmean(X(3,:,:),'all').

Media armónica excluyendo NaN

Cree un vector y calcule su harmmean, excluyendo los valores NaN.

x = 1:10;
x(3) = nan; % Replace the third element of x with a NaN value
n = harmmean(x,'omitnan')

n = 
3.4674

Si no especifica 'omitnan', harmmean(x) devuelve NaN.

Más acerca de

Media armónica

La media armónica de una muestra X es

$$m=\frac{n}{{\displaystyle \sum _{i=1}^n\frac{1}{x_i}}}$$

donde n es el número de valores de X.

Sugerencias

• Cuando harmmean calcula la media armónica de un arreglo que contiene 0, el valor devuelto es 0.

Capacidades ampliadas

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función harmmean es totalmente compatible con arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Estos argumentos de entrada no son compatibles: 'all', vecdim y nanflag.

• El argumento de entrada dim debe ser una constante en tiempo de compilación.

• Si no especifica el argumento de entrada dim, la dimensión en funcionamiento (o en operación) puede ser diferente en el código generado. Como resultado, se podrían producir errores en el tiempo de ejecución. Para obtener más información, consulte Incompatibility with MATLAB for Default Dimension Selection (MATLAB Coder).

Para obtener más información sobre la generación de código, consulte Introduction to Code Generation y General Code Generation Workflow.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con los entornos basados en procesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos de GPU. Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2024a: Especificar las entradas gpuArray

harmmean es compatible completamente con las entradas gpuArray.

Consulte también

mean | median | geomean | trimmean