movmean

Перемещение среднего значения

Синтаксис

M = movmean(A,k)
M = movmean(A,[kb kf])
M = movmean(___,dim)
M = movmean(___,nanflag)
M = movmean(___,Name,Value)

Описание

пример

M = movmean(A,k) возвращается, массив локального k - указывают средние значения, где каждое среднее значение вычисляется по раздвижному окну длины k через соседние элементы A. Когда k нечетен, окно центрируется об элементе в текущем положении. Когда k даже, окно центрируется о текущих и предыдущих элементах. Размер окна является автоматически усеченным в конечных точках, когда существует недостаточно элементов, чтобы заполнить окно. Когда окно является усеченным, среднее число взято по только элементам, которые заполняют окно. M одного размера как A.

  • Если A является вектором, то movmean действует вдоль вектора.

  • Если A является многомерным массивом, то movmean действует вдоль первого измерения массива, размер которого не равняется 1.

пример

M = movmean(A,[kb kf]) вычисляет среднее значение с окном длины kb+kf+1, который включает элемент в текущее положение, элементы kb назад и элементы kf вперед.

пример

M = movmean(___,dim) возвращает массив скользящих средних значений по измерению dim для любого из предыдущих синтаксисов. Например, если A является матрицей, то movmean(A,k,2) действует вдоль столбцов A, вычисляя k - скользящее среднее значение элемента для каждой строки.

пример

M = movmean(___,nanflag) задает, включать ли или не использовать значения NaN от вычисления для какого-либо из предыдущих синтаксисов. movmean(A,k,'includenan') включает все значения NaN в вычисление, в то время как movmean(A,k,'omitnan') игнорирует их и вычисляет среднее значение по меньшему количеству точек.

пример

M = movmean(___,Name,Value) задает дополнительные параметры для скользящего среднего значения с помощью одного или нескольких аргументов в виде пар "имя-значение". Например, если x является вектором временных стоимостей, то movmean(A,k,'SamplePoints',x) вычисляет скользящее среднее значение относительно времен в x.

Примеры

свернуть все

Вычислите скользящее среднее значение в центре с тремя точками вектора - строки. Когда существует меньше чем три элемента в окне в конечных точках, берут среднее число по элементам, которые доступны.

A = [4 8 6 -1 -2 -3 -1 3 4 5];
M = movmean(A,3)
M = 1×10

    6.0000    6.0000    4.3333    1.0000   -2.0000   -2.0000   -0.3333    2.0000    4.0000    4.5000

Вычислите запаздывающее скользящее среднее значение с тремя точками вектора - строки. Когда существует меньше чем три элемента в окне в конечных точках, берут среднее число по элементам, которые доступны.

A = [4 8 6 -1 -2 -3 -1 3 4 5];
M = movmean(A,[2 0])
M = 1×10

    4.0000    6.0000    6.0000    4.3333    1.0000   -2.0000   -2.0000   -0.3333    2.0000    4.0000

Вычислите скользящее среднее значение в центре с тремя точками для каждой строки матрицы. Окно запускается на первой строке, скользит горизонтально в конец строки, затем перемещается во вторую строку и так далее. Аргумент размерности равняется двум, которые двигают окно через столбцы A.

A = [4 8 6; -1 -2 -3; -1 3 4]
A = 3×3

     4     8     6
    -1    -2    -3
    -1     3     4

M = movmean(A,3,2)
M = 3×3

    6.0000    6.0000    7.0000
   -1.5000   -2.0000   -2.5000
    1.0000    2.0000    3.5000

Вычислите скользящее среднее значение в центре с тремя точками вектора - строки, содержащего два элемента NaN.

A = [4 8 NaN -1 -2 -3 NaN 3 4 5];
M = movmean(A,3)
M = 1×10

    6.0000       NaN       NaN       NaN   -2.0000       NaN       NaN       NaN    4.0000    4.5000

Повторно вычислите среднее число, но не используйте значения NaN. Когда movmean отбрасывает элементы NaN, он берет среднее число по остающимся элементам в окне.

M = movmean(A,3,'omitnan')
M = 1×10

    6.0000    6.0000    3.5000   -1.5000   -2.0000   -2.5000         0    3.5000    4.0000    4.5000

Вычислите 3-часовое скользящее среднее значение в центре данных в A согласно временному вектору t.

A = [4 8 6 -1 -2 -3];
k = hours(3);
t = datetime(2016,1,1,0,0,0) + hours(0:5)
t = 1x6 datetime array
Columns 1 through 3

   01-Jan-2016 00:00:00   01-Jan-2016 01:00:00   01-Jan-2016 02:00:00

Columns 4 through 6

   01-Jan-2016 03:00:00   01-Jan-2016 04:00:00   01-Jan-2016 05:00:00

M = movmean(A,k,'SamplePoints',t)
M = 1×6

    6.0000    6.0000    4.3333    1.0000   -2.0000   -2.5000

Вычислите скользящее среднее значение в центре с тремя точками вектора - строки, но отбросьте любое вычисление, которое использует меньше чем три точки от вывода. Другими словами, возвратите только средние числа, вычисленные из полного трехэлементного окна, отбросив вычисления конечной точки.

A = [4 8 6 -1 -2 -3 -1 3 4 5];
M = movmean(A,3,'Endpoints','discard')
M = 1×8

    6.0000    4.3333    1.0000   -2.0000   -2.0000   -0.3333    2.0000    4.0000

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

свернуть все

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

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | логический

Длина окна, заданная как числовой скаляр или скаляр длительности. Когда k является положительным целочисленным скаляром, среднее число в центре включает элемент в текущее положение плюс окружение соседей. Например, среднее число с тремя точками, заданное окном длины три результата в следующем вычислении для векторного A:

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | длительность

Направленная длина окна, заданная как числовой вектор - строка или вектор - строка длительности, содержащий два элемента. Когда kb и kf являются положительными целочисленными скалярами, вычисление по элементам kb+kf+1. Вычисление включает элемент в текущее положение, элементы kb перед текущим положением и элементами kf после текущего положения. Например, среднее число с четырьмя точками, заданное направленным окном [2 1], приводит к следующему вычислению для векторного A:

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | длительность

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

dim размерности указывает на размерность, которой movmean управляет вперед, то есть, направление, в котором скользит заданное окно.

Рассмотрите двумерный входной массив, A.

  • Если dim = 1, то movmean(A,k,1) запускается с первого столбца и скользит вертикально по каждой строке. Среднее значение вычисляется по элементам k за один раз. Затем это перемещается во второй столбец и повторяет вычисление. Этот процесс продолжается, пока все столбцы не исчерпываются.

  • Если dim = 2, то movmean(A,k,2) запускается с первой строки и скользит горизонтально по каждому столбцу. Среднее значение вычисляется по элементам k за один раз. Затем это перемещается во вторую строку и повторяет вычисление. Этот процесс продолжается, пока все строки не исчерпываются.

Типы данных: удвойтесь | единственный | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

  • 'includenan' — Включайте значения NaN от входного параметра при вычислении среднего значения, приведении к NaN вывод.

  • 'omitnan' — Проигнорируйте все значения NaN во входном параметре. Если окно содержит только значения NaN, то movmean возвращает NaN.

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: M = movmean (A, k, 'Конечные точки', 'заливка')

Метод, чтобы обработать ведущие и запаздывающие окна, заданные как пара, разделенная запятой, состоящая из 'Endpoints' и одно из следующего:

Значение 'Endpoints'Описание
'shrink'Уменьшите размер окна около конечных точек входного параметра, чтобы включать только существующие элементы.
'discard'Не выводите средние числа, когда окно не полностью наложится с существующими элементами.
заливкаЗамените несуществующими элементами с NaN.
числовой или логический скалярЗамените несуществующими элементами с заданным числовым или логическим значением.

Типы данных: удвойтесь | единственный | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | логический | char | строка

Точки выборки для вычислительных средних чисел, заданных как пара, разделенная запятой, состоящая из 'SamplePoints' и вектора. Точки выборки представляют местоположение данных в A. Точки выборки не должны быть однородно выбраны. По умолчанию вектором точек выборки является [1 2 3 ... ].

Движущиеся окна заданы относительно точек выборки, которые должны быть отсортированы и содержать уникальные элементы. Например, если t является векторными временами, соответствуя входным данным, то movmean(rand(1,10),3,'SamplePoints',t) имеет окно, которое представляет временной интервал между t(i)-1.5 и t(i)+1.5.

Когда вектор точек выборки имеет тип данных datetime или duration, затем движущаяся длина окна должна иметь, вводят duration.

Если точки выборки неоднородно расположены с интервалами, и пара "имя-значение" 'Endpoints' задана, то ее значением должен быть 'shrink'.

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | datetime | длительность

Больше о

свернуть все

Среднее значение

Поскольку случайная переменная векторизовала составленное из скалярных наблюдений N, среднее значение задано как

μ = 1N∑i=1NAi.

Расширенные возможности

Введенный в R2016a

Была ли эта тема полезной?