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

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'.

Примеры

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

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

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

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

Подробнее