Exponenta Banner
exponenta event banner

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') игнорирует их.

Примеры

свернуть все

Скрипт Open Live Script

Найдите совокупные минимумы 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
Скрипт Open Live Script

Найдите совокупные минимумы столбцов 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
Скрипт Open Live Script

Найдите совокупные минимумы строк 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
Скрипт Open Live Script

Вычислите совокупные минимумы в третьей размерности 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
Скрипт Open Live Script

Создайте вектор, содержащий стоимость 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 также сравнивает углы фазы.

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | логический | длительность
Поддержка комплексного числа: Да

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

Была ли эта тема полезной?
Документация MATLAB
Поддержка