dmarrayfun (DataMatrix)

Примените функцию к каждому элементу в объекте DataMatrix

Синтаксис

DMObjNew1 = dmarrayfun(Func, DMObj1)
DMObjNew1 = dmarrayfun(Func, DMObj1, DMObj2, ...)
[DMObjNew1, DMObjNew2, ...] = dmarrayfun(Func, DMObj1, ...)
[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'UniformOutput', UniformOutputValue, ...)
[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'DataMatrixOutput', DataMatrixOutputValue, ...)
[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'Rows', RowsValue, ...)
[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'Columns', ColumnsValue, ...)
[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'ErrorHandler', ErrorFuncHandle, ...)

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

Func

Указатель на функцию для функции, которая возвращает один или несколько скаляров и возвращает значения того же класса каждый раз, он называется.

DMObj1

Объект DataMatrix, такой, как создано DataMatrix Конструктор Object.

DMObj2

Любое из следующего:

  • Объект DataMatrix, такой, как создано DataMatrix Конструктор Object

  • Числовой массив MATLAB®

Примечание

DMObj2 и последующие входные объекты или массивы должны быть одного размера (количество строк и столбцов) как DMObj1.

UniformOutputValue

Задает ли Func должен возвратить выходные значения без инкапсуляции в массиве ячеек. Выбором является true (значение по умолчанию) или false. Если true, dmarrayfun должен возвратить скалярные значения, которые могут быть конкатенированы в массив. Эти значения могут также быть массивом ячеек. Если false, dmarrayfun возвращает массив ячеек (или несколько массивов ячеек), где IJячейка th содержит значение, равное Func(DMObj1(I, J)...).

DataMatrixOutputValue

Задает, должны ли возвращаемые значения быть объектами DataMatrix. Выбором является true (значение по умолчанию) или false. Если вы устанавливаете 'UniformOutput' свойство к false, это свойство проигнорировано.

RowsValue, ColumnsValue

Задает строки или столбцы, к которым можно применить функцию. Выбор:

  • Положительное целое число

  • Вектор из положительных целых чисел

  • Вектор символов, задающий строку или имя столбца

  • Массив ячеек из символьных векторов

  • Логический вектор

ErrorFuncHandleЗадает указатель на функцию к функции что dmarrayfun вызовы, если вызов Func сбои.

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

DMObjNew1, DMObjNew2Объекты DataMatrix, созданные из применения функции к каждому элементу в одном или нескольких объектах DataMatrix. Размер (количество строк и столбцов), имена строки и имена столбцов совпадет с DMObj1.

Описание

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

DMObjNew1 = dmarrayfun(Func, DMObj1, DMObj2, ...) выполняет функцию, заданную Func использование элементов в DMObj1, DMObj2, и т.д. как входные параметры. IJэлемент th 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, DMObj1PropertyName ', PropertyValue, ...) вызовы dmarrayfun с дополнительными свойствами, которые используют имя свойства / пары значения свойства. Можно задать одно или несколько свойств в любом порядке. Каждый PropertyName должен быть заключен в одинарные кавычки и нечувствительный к регистру. Это имя свойства / пары значения свойства следующие:

[DMObjNew1, ...] = dmarrayfun(Func, DMObj1, ...'UniformOutput', UniformOutputValue, ...) задает ли Func должен возвратить выходные значения без инкапсуляции в массиве ячеек. Выбором является true (значение по умолчанию) или false. Если true, dmarrayfun должен возвратить скалярные значения, которые могут быть конкатенированы в массив. Эти значения могут также быть массивом ячеек. Если false, dmarrayfun возвращает массив ячеек (или несколько массивов ячеек), где IJячейка th содержит значение, равное 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 сбои. Функция обработки ошибок будет вызвана с этими входными параметрами:

  • Структура со следующими полями:

    • identifier — Идентификатор ошибки

    • message — Текст сообщения об ошибке

    • index — Линейный индекс во входной массив (массивы), в котором произошла ошибка

  • Набор входных параметров, в которых перестал работать вызов функции

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

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

| |

Представленный в R2008b