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

Примеры

свернуть все

Открыть 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
Открыть 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
Открыть 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
Открыть 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
Открыть 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 также сравнивает углы фазы.

Типы данных: 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.

Совет

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

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

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

.

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

.

См. также

| | | | |

Введенный в R2014b

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

Поддержка