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.

Примеры

свернуть все

Открыть 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
Открыть 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
Открыть 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
Открыть 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
Открыть 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
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
Открыть 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 | 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

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

Генерация кода C/C + +
Сгенерируйте код C и C++ с помощью Coder™ MATLAB ®

.

См. также

| |

Введенный в R2017a

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

Поддержка

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