Документация

m = geomean(X) возвращает геометрическое среднее значение X.

Если X является вектором, то geomean(X) является геометрическим средним значением элементов в X.
Если X является матрицей, то geomean(X) является вектором - строкой, содержащим геометрическое среднее значение каждого столбца X.
Если X является многомерным массивом, то geomean действует по первому неодноэлементному измерению X.

m = geomean(X,'all') возвращает геометрическое среднее значение всех элементов в X.

m = geomean(X,dim) возвращает среднее геометрическое по операционному измерению dim X.

m = geomean(X,vecdim) возвращает среднее геометрическое по размерностям, заданным в векторном vecdim. Например, если X является 2 массивом 3 на 4, то geomean(X,[1 2]) возвращает 1 массивом 1 на 4. Каждый элемент выходного массива является геометрическим средним значением элементов на соответствующей странице X.

m = geomean(___,nanflag) задает, исключить ли значения NaN из вычисления, с помощью какой-либо из комбинаций входных аргументов в предыдущих синтаксисах. По умолчанию geomean включает значения NaN в вычисление (nanflag имеет значение 'includenan'). Чтобы исключить значения NaN, установите значение nanflag к 'omitnan'.

Примеры

Сравните среднегеометрическое и среднее арифметическое

Установите случайный seed для воспроизводимости результатов.

rng('default')

Создайте матрицу экспоненциальных случайных чисел с 5 строками и 4 столбцами.

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

Вычислите средние геометрические и средние арифметические столбцов 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

Среднее арифметическое больше, чем среднее геометрическое для всех столбцов X.

Геометрическое среднее значение всех элементов

Найдите среднее геометрическое по нескольким размерностям при помощи входного параметра 'all'.

Создайте 2 5 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

Найдите геометрическое среднее значение всех элементов X.

m = geomean(X,'all')

m = 15.7685

m является геометрическим средним значением целого массива X.

Среднегеометрический в заданных измерениях

Найдите среднее геометрическое по различным операционным измерениям и векторам размерностей для многомерного массива.

Создайте 3 5 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

Найдите геометрическое среднее значение X по измерению по умолчанию.

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

По умолчанию geomean действует по первому измерению X, размер которого не равняется 1. В этом случае эта размерность является первой размерностью X. Поэтому gmean1 является 1 5 2 массивами.

Найдите геометрическое среднее значение X вдоль второго измерения.

gmean2 = geomean(X,2)

gmean2 = 
gmean2(:,:,1) =

    5.1549
    6.5784
    7.8155


gmean2(:,:,2) =

   21.5814
   22.6004
   23.6177

gmean2 является 3 1 2 массивами.

Найдите геометрическое среднее значение X по третьему измерению.

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 является массивом 3 на 5.

Найдите геометрическое среднее значение каждой страницы X путем определения первых и вторых измерений с помощью входного параметра vecdim.

mpage = geomean(X,[1 2])

mpage = 
mpage(:,:,1) =

    6.4234


mpage(:,:,2) =

   22.5845

Например, mpage(1,1,2) является геометрическим средним значением элементов в X(:,:,2).

Найдите геометрическое среднее значение элементов в каждом срезе X(i,:,:) путем определения вторых и третьих размерностей.

mrow = geomean(X,[2 3])

mrow = 3×1

   10.5475
   12.1932
   13.5862

Например, mrow(3) является геометрическим средним значением элементов в X(3,:,:) и эквивалентен определению geomean(X(3,:,:),'all').

Геометрическое среднее значение, исключая `NaN`

Создайте вектор и вычислите его geomean, исключая значения NaN.

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

n = 4.7408

Если вы не задаете 'omitnan', то geomean(x) возвращает NaN.

Входные параметры

`X` Входные данные
неотрицательный вектор | неотрицательная матрица | неотрицательный многомерный массив

Входные данные, который представляет выборку от генеральной совокупности, заданной как неотрицательный вектор, матрица или многомерный массив.

Если X является вектором, то geomean(X) является геометрическим средним значением элементов в X.
Если X является матрицей, то geomean(X) является вектором - строкой, содержащим геометрическое среднее значение каждого столбца X.
Если X является многомерным массивом, то geomean действует по первому неодноэлементному измерению X.

Чтобы задать операционную размерность, когда X будет матрицей или массивом, используйте входной параметр dim.

Типы данных: single | double

`dim` Размерность
положительный целочисленный скаляр

Размерность, по которой можно действовать, заданный как положительный целочисленный скаляр. Если вы не задаете значение, то значение по умолчанию является первым измерением массива X, размер которого не равняется 1.

Считайте двумерный массив X:

Если dim равен 1, то geomean(X,1) возвращает вектор - строку, содержащий среднее геометрическое для каждого столбца в X.
Если dim равен 2, то geomean(X,2) возвращает вектор-столбец, содержащий среднее геометрическое для каждой строки в X.

Если dim больше, чем ndims(X) или если size(X,dim) равняется 1, то geomean возвращает X.

Типы данных: single | double

`vecdim` — Вектор размерностей
положительный целочисленный вектор

Вектор размерностей, заданных как положительный целочисленный вектор. Каждый элемент vecdim представляет размерность входного массива X. Вывод m имеет длину 1 в заданных операционных размерностях. Другие длины размерности являются тем же самым для X и m.

Например, если X является 2 3х3 массивом, то geomean(X,[1 2]) возвращает 1 1 3 массивами. Каждый элемент вывода является геометрическим средним значением элементов на соответствующей странице X.

Типы данных: single | double

`nanflag` условие `NaN`
`'includenan'` (значение по умолчанию) | `'omitnan'`

Условие NaN, заданное как одно из этих значений:

'includenan' — Включайте значения NaN при вычислении geomean. Это возвращает NaN.
'omitnan' — Проигнорируйте значения NaN во входе.

Типы данных: char | string

Выходные аргументы

`m` Среднегеометрический
скаляр | вектор | матрица | многомерный массив

Среднегеометрический, возвращенный как скаляр, вектор, матрица или многомерный массив.

Больше о