movprod

Движущийся продукт

Описание

пример

M = movprod(A,k) возвращает массив локального k- специальные продукты, где каждый продукт вычисляется по раздвижному окну длины k через соседние элементы AM одного размера с A.

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

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

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

пример

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

пример

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

пример

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

пример

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

Примеры

свернуть все

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

A = [1 2 4 -1 -2 -3 -1 3 2 1];
M = movprod(A,3)
M = 1×10

     2     8    -8     8    -6    -6     9    -6     6     2

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

A = [1 2 1 -1 -2 -3 -1 3 4 1];
M = movprod(A,[2 0])
M = 1×10

     1     2     2    -2     2    -6    -6     9   -12    12

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

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

     1     2     1
    -1    -2    -3
    -1     3     4

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

     2     2     2
     2    -6     6
    -3   -12    12

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

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

     2   NaN   NaN   NaN    -6   NaN   NaN   NaN    12     4

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

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

     2     2    -1     2    -6     6    -9    12    12     4

Вычислите 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 = movprod(A,k,'SamplePoints',t)
M = 1×6

    32   192   -48    12    -6     6

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

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

     2    -2     2    -6    -6     9   -12    12

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

свернуть все

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

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

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

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration

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

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | duration

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

Рассмотрите матричный A.

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

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

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

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

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

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

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

Пример: M = movprod(A,k,'Endpoints','fill')

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

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

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string

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

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

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

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

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | datetime | duration

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

Смотрите также

| |

Введенный в R2017a

Для просмотра документации необходимо авторизоваться на сайте