cummin

Кумулятивный минимум

Синтаксис

M = cummin(A)
M = cummin(A,dim)
M = cummin(___,direction)
M = cummin(___,nanflag)

Описание

пример

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

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

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

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

пример

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

пример

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

пример

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

Примеры

свернуть все

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

v = randi([0,10],1,10)
v = 1×10

     8     9     1    10     6     1     3     6    10    10

M = cummin(v)
M = 1×10

     8     8     1     1     1     1     1     1     1     1

Найдите кумулятивные минимумы столбцов 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 = cummin(A)
M = 3×3

     3     5     2
     1     5     2
     1     5     1

Найдите кумулятивные минимумы строк 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 = cummin(A,2)
M = 3×3

     3     3     2
     1     1     1
     7     7     1

Вычислите кумулятивные минимумы в третьей размерности 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 = cummin(A,3,'reverse')
M = 
M(:,:,1) =

     1     2
     3     4


M(:,:,2) =

     5     6
     7     8


M(:,:,3) =

     5     6
     7     8

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

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

     3     3     3     3     0     0

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

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

     3     3   NaN   NaN   NaN   NaN

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

свернуть все

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

свернуть все

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

Советы

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

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

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

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

| | | | |

Введенный в R2014b

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