geomean

Media geométrica

Sintaxis

m = geomean(X)

m = geomean(X,'all')

m = geomean(X,dim)

m = geomean(X,vecdim)

m = geomean(___,nanflag)

Descripción

m = geomean(X) devuelve la media geométrica de X.

• Si X es un vector, geomean(X) es la media geométrica de los elementos de X.

• Si X es una matriz, geomean(X) es un vector fila que contiene la media geométrica de cada columna de X.

• Si X es un arreglo multidimensional, geomean opera a lo largo de la primera dimensión no singular de X.

m = geomean(X,'all') devuelve la media geométrica de todos los elementos de X.

m = geomean(X,dim) devuelve la media geométrica a lo largo de la dimensión operativa dim de X.

m = geomean(X,vecdim) devuelve la media geométrica de las dimensiones especificadas en el vector vecdim. Por ejemplo, si X es un arreglo de 2 por 3 por 4, entonces geomean(X,[1 2]) devuelve un arreglo de 1 por 1 por 4. Cada elemento del arreglo de salida es la media geométrica de los elementos de la página correspondiente de X.

m = geomean(___,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, geomean 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 geométrica 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 geométrica y aritmética de las columnas de X.

geometric = geomean(X)

geometric = 1×4

    0.2805    0.3083    0.2079    0.2698

arithmetic = mean(X)

arithmetic = 1×4

    0.5833    0.8577    0.5734    0.6357

La media aritmética es mayor que la media geométrica para todas las columnas de X.

Media geométrica de todos los elementos

Encuentre la media geométrica en varias dimensiones utilizando el argumento de entrada 'all'.

Cree un arreglo de 2 por 5 por 4 X.

X = reshape(1:40,[2 5 4])

X = 
X(:,:,1) =

     1     3     5     7     9
     2     4     6     8    10


X(:,:,2) =

    11    13    15    17    19
    12    14    16    18    20


X(:,:,3) =

    21    23    25    27    29
    22    24    26    28    30


X(:,:,4) =

    31    33    35    37    39
    32    34    36    38    40

Encuentre la media geométrica de todos los elementos de X.

m = geomean(X,'all')

m = 15.7685

m es la media geométrica de todo el arreglo X.

Media geométrica a lo largo de las dimensiones especificadas

Encuentre la media geométrica 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 geométrica de X a lo largo de la dimensión predeterminada.

gmean1 = geomean(X)

gmean1 = 
gmean1(:,:,1) =

    1.8171    4.9324    7.9581   10.9696   13.9761


gmean1(:,:,2) =

   16.9804   19.9833   22.9855   25.9872   28.9885

De manera predeterminada, geomean 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, gmean1 es un arreglo de 1 por 5 por 2.

Encuentre la media geométrica de X a lo largo de la segunda dimensión.

gmean2 = geomean(X,2)

gmean2 = 
gmean2(:,:,1) =

    5.1549
    6.5784
    7.8155


gmean2(:,:,2) =

   21.5814
   22.6004
   23.6177

gmean2 es un arreglo de 3 por 1 por 2.

Encuentre la media geométrica de X a lo largo de la tercera dimensión.

gmean3 = geomean(X,3)

gmean3 = 3×5

    4.0000    8.7178   12.4097   15.8114   19.0788
    5.8310   10.0000   13.5647   16.9115   20.1494
    7.3485   11.2250   14.6969   18.0000   21.2132

gmean3 es un arreglo de 3 por 5.

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

mpage = geomean(X,[1 2])

mpage = 
mpage(:,:,1) =

    6.4234


mpage(:,:,2) =

   22.5845

Por ejemplo, mpage(1,1,2) es la media geométrica de los elementos de X(:,:,2).

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

mrow = geomean(X,[2 3])

mrow = 3×1

   10.5475
   12.1932
   13.5862

Por ejemplo, mrow(3) es la media geométrica de los elementos de X(3,:,:) y es equivalente a especificar geomean(X(3,:,:),'all').

Media geométrica excluyendo NaN

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

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

n = 4.7408

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

Argumentos de entrada

X — Datos de entrada

vector no negativo | matriz no negativa | arreglo multidimensional no negativo

Datos de entrada que representan una muestra de una población, especificados como un vector, una matriz o un arreglo multidimensional no negativos.

• Si X es un vector, geomean(X) es la media geométrica de los elementos de X.

• Si X es una matriz, geomean(X) es un vector fila que contiene la media geométrica de cada columna de X.

• Si X es un arreglo multidimensional, geomean opera a lo largo de la primera dimensión no singular de X.

Para especificar la dimensión operativa cuando X es una matriz o un arreglo, utilice el argumento de entrada dim.

Tipos de datos: single | double

dim — Dimensión

escalar entero positivo

Dimensión a lo largo de la que operar, especificada como un escalar entero positivo. Si no especifica un valor, el valor predeterminado es la primera dimensión del arreglo de X cuyo tamaño no sea igual a 1.

Considere un arreglo de dos dimensiones X:

• Si dim es igual a 1, geomean(X,1) devuelve un vector fila que contiene la media geométrica de cada columna de X.

• Si dim es igual a 2, geomean(X,2) devuelve un vector columna que contiene la media geométrica de cada fila de X.

Si dim es mayor que ndims(X) o si size(X,dim) es 1, geomean devuelve X.

Tipos de datos: single | double

vecdim — Vector de dimensiones

vector entero positivo

Un vector de dimensiones, especificado como un vector entero positivo. 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 3, geomean(X,[1 2]) devuelve un arreglo de 1 por 1 por 3. Cada elemento de la salida es la media geométrica de los elementos de la página correspondiente de X.

Tipos de datos: single | double

nanflag — Condición NaN

'includenan' (predeterminado) | 'omitnan'

Condición NaN, especificada como uno de estos valores:

• 'includenan': incluye valores NaN al calcular la geomean. Esto devuelve NaN.

• 'omitnan': ignora valores NaN en la entrada.

Tipos de datos: char | string

Argumentos de salida

m — Media geométrica

escalar | vector | matriz | arreglo multidimensional

Media geométrica, devuelta como un escalar, un vector, una matriz o un arreglo multidimensional.

Más acerca de

Media geométrica

La media geométrica de una muestra X es

$$m={\left[{\displaystyle \prod _{i=1}^n{x}_i}\right]}^{\frac{1}{n}}$$

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

Capacidades ampliadas

Arreglos altos

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

Esta función 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 Automatic dimension restriction (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 un entorno basado 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

geomean es compatible completamente con las entradas gpuArray.

Consulte también

mean | median | harmmean | trimmean

Temas

• Geometric Distribution