cummax

Кумулятивный максимум

Описание

пример

M = cummax(A) возвращает элементы кумулятивного максимума A. По умолчанию, cummax(A) действует вдоль первого измерения массива, размер которого не равняется 1.

  • Если A вектор, затем cummax(A) возвращает вектор, одного размера содержащий кумулятивные максимумы A.

  • Если A матрица, затем cummax(A) возвращает матрицу, одного размера содержащий кумулятивные максимумы в каждом столбце A.

  • Если A многомерный массив, затем cummax(A) возвращает массив, одного размера содержащий кумулятивные максимумы вдоль первого измерения массива A чей размер не равняется 1.

пример

M = cummax(A,dim) возвращает кумулятивные максимумы по измерению dim. Например, если A матрица, затем cummax(A,2) возвращает кумулятивные максимумы вдоль строк A.

пример

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

пример

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

Примеры

свернуть все

Найдите кумулятивные максимумы 1 10 вектор из случайных целых чисел.

v = randi(10,1,10)
v = 1×10

     9    10     2    10     7     1     3     6    10    10

M = cummax(v)
M = 1×10

     9    10    10    10    10    10    10    10    10    10

Найдите кумулятивные максимумы столбцов 3х3 матрицы.

A = [3 5 2; 1 6 3; 7 8 1]
A = 3×3

     3     5     2
     1     6     3
     7     8     1

M = cummax(A)
M = 3×3

     3     5     2
     3     6     3
     7     8     3

Найдите кумулятивные максимумы строк 3х3 матрицы.

A = [3 5 2; 1 6 3; 7 8 1]
A = 3×3

     3     5     2
     1     6     3
     7     8     1

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

     3     5     5
     1     6     6
     7     8     8

Вычислите кумулятивные максимумы в третьей размерности 2 2 3 массивами. Задайте direction как 'reverse' работать от конца третьей размерности к началу.

A = cat(3,[1 2; 3 4],[9 10; 11 12],[5 6; 7 8])
A = 
A(:,:,1) =

     1     2
     3     4


A(:,:,2) =

     9    10
    11    12


A(:,:,3) =

     5     6
     7     8

M = cummax(A,3,'reverse')
M = 
M(:,:,1) =

     9    10
    11    12


M(:,:,2) =

     9    10
    11    12


M(:,:,3) =

     5     6
     7     8

Создайте вектор, содержащий NaN значения и вычисляют кумулятивные максимумы. По умолчанию, cummax игнорирует NaN значения.

A = [3 5 NaN 9 0 NaN];
M = cummax(A)
M = 1×6

     3     5     5     9     9     9

Если вы включаете NaN значения в вычислении, затем кумулятивный максимум становится NaN как только первый NaN значение в A столкнут.

M = cummax(A,'includenan')
M = 1×6

     3     5   NaN   NaN   NaN   NaN

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

свернуть все

Входной массив, заданный как векторный, матричный или многомерный массив. Для комплексных элементов, cummax сравнивает величину элементов. Если величины равны, cummax также сравнивает углы фазы.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration
Поддержка комплексного числа: Да

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

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

  • cummax(A,1) работает над последовательными элементами в столбцах A и возвращает массив одного размера с A с кумулятивными максимумами в каждом столбце.

  • cummax(A,2) работает над последовательными элементами в строках A и возвращает массив одного размера с A с кумулятивными максимумами в каждой строке.

cummax возвращает A если dim больше ndims(A).

Направление накопления в виде 'forward' (значение по умолчанию) или 'reverse'.

  • 'forward' работает от 1 к end из активной размерности.

  • 'reverse' работает от end к 1 из активной размерности.

Типы данных: char

NaN условие в виде одного из следующих значений:

  • 'omitnan' — Проигнорируйте весь NaN значения во входе. Если вход имеет последовательный ведущий NaN значения, затем cummax возвращает NaN в соответствующих элементах выхода. Например, cummax([NaN 7 13 6],'omitnan') возвращает вектор-строку [NaN 7 13 13].

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

Типы данных: char

Выходные аргументы

свернуть все

Кумулятивные максимумы, возвращенные как вектор, матрица или многомерный массив. Размер и тип данных M совпадают с теми из A.

Советы

  • 'reverse' опция во многих кумулятивных функциях позволяет быстрые направленные вычисления, не требуя щелчка или отражения входного массива.

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

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

Генерация кода графического процессора
Сгенерируйте код CUDA® для NVIDIA® графические процессоры с помощью GPU Coder™.

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

| | | | |

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