Синтаксис

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

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

Описание

DMObjNew1 = dmarrayfun(Func, DMObj1) применяет функцию, указанную Func каждому элементу в DMObj1, объект DataMatrix и возвращает результаты в DMObjNew1, новый объект DataMatrix. DMObjNew1 имеет тот же размер (количество строк и столбцов), имена строк и имена столбцов, что и DMObj1. I,J-й элемент DMObjNew1 равно Func(DMObj1(I,J)), где Func - дескриптор функции, который принимает один входной аргумент, возвращает одно скалярное значение и возвращает значения одного и того же класса при каждом вызове.

DMObjNew1 = dmarrayfun(Func, DMObj1, DMObj2, ...) вычисляет функцию, заданную Func использование элементов в DMObj1, DMObj2и т.д. в качестве входных аргументов. I,J-й элемент DMObjNew1 равно Func(DMObj1(I,J), DMObj2(I,J), ...), где Func - дескриптор функции для функции, которая принимает несколько входных аргументов, возвращает один скаляр и возвращает значения одного и того же класса при каждом вызове.

[DMObjNew1, DMObjNew2, ...] = dmarrayfun(Func, DMObj1, ...) вычисляет функцию, заданную Func использование элементов в DMObj1и, возможно, другие входные аргументы. Func - дескриптор функции, который принимает один или несколько входных аргументов, возвращает несколько скаляров и возвращает значения одного и того же класса при каждом вызове. Возвращает объекты DataMatrix DMObjNew1, DMObjNew2и т.д., каждый из которых соответствует одному из выходов Func. Выходные данные Func могут иметь различные классы, однако каждый выход должен быть одинаковым при каждом вызове.

[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'PropertyName', PropertyValue, ...) требования dmarrayfun с необязательными свойствами, использующими пары имя/значение свойства. Можно указать одно или несколько свойств в любом порядке. Каждый PropertyName должен быть заключен в одинарные кавычки и не учитывать регистр. Эти пары имя/значение свойства следующие:

[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'UniformOutput', UniformOutputValue, ...) указывает, Func должен возвращать выходные значения без инкапсуляции в массиве ячеек. Варианты: true (по умолчанию) или false. Если true, dmarrayfun должен возвращать скалярные значения, которые могут быть объединены в массив. Эти значения также могут быть массивом ячеек. Если false, dmarrayfun возвращает массив ячеек (или несколько массивов ячеек), где I,JВ-й ячейке содержится значение, равное Func(DMObj1(I,J),...).

[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'DataMatrixOutput', DataMatrixOutputValue, ...) указывает, должны ли возвращаемые значения быть объектами DataMatrix. Варианты: true (по умолчанию) или false. Если установить 'UniformOutput' свойство для false, это свойство игнорируется.

[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'Rows', RowsValue, ...) применяет функцию только к строкам в объекте DataMatrix, указанному RowsValue, который может быть положительным целым числом, вектором положительных целых чисел, символьным вектором, указывающим имя строки, клеточным массивом символьных векторов или логическим вектором.

[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'Columns', ColumnsValue, ...) применяет функцию только к столбцам в объекте DataMatrix, указанному ColumnsValue, который может быть положительным целым числом, вектором положительных целых чисел, символьным вектором, указывающим имя столбца, массивом ячеек символьных векторов или логическим вектором.

[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'ErrorHandler', ErrorFuncHandle, ...) определяет дескриптор функции для функции, которая dmarrayfun вызовы, если вызов Func не удается. Функция обработки ошибок будет вызвана со следующими входными аргументами:

Если не указать ErrorFuncHandle, dmarrayfun возвращает ошибку из вызова в Func.

См. также

arrayfun | DataMatrix | dmbsxfun