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

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 array. Каждый элемент массива выхода является геометрическим средним для элементов на соответствующей странице 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` - Среднее геометрическое
скалярный | векторный | матричный | многомерный массив

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

Подробнее о