Exponenta Banner
exponenta event banner

cummax

Совокупный максимум

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

Синтаксис

M = cummax (A)
M = cummax (A, тускло)
M = cummax (___, направление)
M = куммакс (___, нанфлаг)

Описание

пример

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 ® с помощью Coder™ графических процессоров

.

См. также

| | | | |

Представлен в R2014b

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

Поддержка