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

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` — Среднегеометрический
скаляр | вектор | матрица | многомерный массив

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

Больше о