Exponenta Banner
exponenta event banner

movprod

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

свернуть все на странице

Синтаксис

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

Описание

пример

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

Примеры

свернуть все

Скрипт Open Live Script

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

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
Скрипт Open Live Script

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

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
Скрипт Open Live Script

Вычислите движущийся продукт в центре с 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
Скрипт Open Live Script

Вычислите движущийся продукт в центре с тремя точками вектора - строки, содержащего два элемента 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
Скрипт Open Live Script

Вычислите 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
Скрипт Open Live Script

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

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 | логический

Длина окна, заданная как числовой скаляр или скаляр длительности. Когда 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 должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: 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

Документация MATLAB
Поддержка