Примените функцию к каждому элементу массива на графическом процессоре
Примечание
Эта функция ведет себя так же к MATLAB® функция arrayfun, за исключением того, что оценка функции происходит на графическом процессоре, не на центральном процессоре. Любые необходимые данные не уже на графическом процессоре перемещены в память графического процессора. Функция MATLAB передала в для оценки, скомпилирован и затем выполнен на графическом процессоре. Все выходные аргументы возвращены как gpuArray объекты. Можно получить gpuArray данные с помощью gather функция.
B = arrayfun(FUN,A)FUN к каждому элементу gpuArray Aarrayfun затем конкатенирует выходные параметры от FUN в выходной gpuArray BB одного размера с A и B(i,j,...) = FUN(A(i,j,...)). Входной параметр FUN указатель на функцию к функции MATLAB, которая берет один входной параметр и возвращает скалярное значение. FUN называется так же много раз, как существуют элементы A.
Вы не можете задать порядок в который arrayfun вычисляет элементы B или используйте то, чтобы они были сделанным в каком-то конкретном порядке.
B = arrayfun(FUN,A1,...,An)FUN к элементам массивов A1,...,An, так, чтобы B(i,j,...) = FUN(A1(i,j,...),...,An(i,j,...)). Функциональный FUN должен взять n входные параметры и возвращают скаляр. Неодноэлементные размерности входных параметров A1,...,An должен все соответствовать, или входные параметры должны быть скаляром. Любые одноэлементные размерности или скалярные входные параметры фактически реплицированы прежде чем быть введенным в функциональный FUN.
[B1,...,Bm] = arrayfun( возвращает несколько выходных массивов FUN,___)B1,...,Bm когда функциональный FUN возвращает m выходные значения. arrayfun вызовы FUN каждый раз со столькими же выходных параметров, сколько существует в вызове arrayfun, то есть, m \times. Если вы вызываете arrayfun с большим количеством выходных аргументов, чем поддерживаемый FUN, MATLAB генерирует ошибку. FUN может возвратить выходные аргументы, имеющие различные типы данных, но тип данных каждого выхода должен быть тем же каждым разом FUN называется.
В первый раз вы вызываете arrayfun чтобы запустить конкретную функцию на графическом процессоре, существует некоторое служебное время, чтобы настроить функцию для выполнения графического процессора. Последующие вызовы arrayfun с той же функцией может запуститься быстрее.
Неодноэлементные размерности входных массивов должны совпадать друг с другом. Другими словами, соответствующие размерности аргументов A1,...,An, должно быть равно друг другу или равен одному. Каждый раз, когда размерность входного массива является одиночным элементом (равный 1arrayfun одноэлементное расширение использования. Массив фактически реплицирован по одноэлементному измерению, чтобы совпадать с самым большим из других массивов в той размерности. Когда размерность входного массива является одиночным элементом, и соответствующая размерность в другом массиве аргументов является нулем, arrayfun фактически уменьшает одноэлементную размерность к 0.
Каждая размерность выходного массива B одного размера с самым большим из входных массивов в той размерности для ненулевого размера или нулем в противном случае. Следующий код показывает как размерности размера 1 увеличены или вниз совпадать с размером соответствующей размерности в других аргументах.
R1 = rand(2,5,4,"gpuArray"); R2 = rand(2,1,4,3,"gpuArray"); R3 = rand(1,5,4,3,"gpuArray"); R = arrayfun(@(x,y,z)(x+y.*z),R1,R2,R3); size(R)
2 5 4 3
R1 = rand(2,2,0,4,"gpuArray"); R2 = rand(2,1,1,4,"gpuArray"); R = arrayfun(@plus,R1,R2); size(R)
2 2 0 4
Поскольку операции поддержаны arrayfun строго поэлементны, и каждый расчет каждого элемента выполняется независимо от других, определенные ограничения вводятся:
Массивы ввода и вывода не могут изменить форму или размер.
Создание массивов функционирует, такие как rand не поддерживайте спецификации размера. Массивы случайных чисел имеют независимые потоки для каждого элемента.
Как arrayfun в MATLAB, матричной экспоненциальной степени, умножении и делении (^, *, /, \) выполните поэлементные вычисления только.
Операции, которые изменяют размер или форму массивов ввода или вывода (catизменение, и так далее), не поддерживаются.
Индексация только для чтения (subsref) и доступ к переменным родительской (внешней) функциональной рабочей области из вложенных функций поддерживается. Вы можете индексные переменные, которые существуют в функции перед оценкой на графическом процессоре. Присвоение или subsasgn индексация этих переменных из вложенной функции не поддерживается. Для примера поддерживаемого использования смотрите Операции Шаблона на графическом процессоре.
Анонимные функции не имеют доступа к своей родительской функциональной рабочей области.
Перегрузка поддерживаемых функций не позволена.
Код не может вызвать скрипты.
Нет никакого ans переменная, чтобы содержать неприсвоенные результаты расчета. Убедитесь, что явным образом присвоили переменным результаты всех вычислений.
Следующие функции языка не поддерживаются: персистентные или глобальные переменные, parforSPMDSwitch, и try/catch.
Pcode-файлы не могут содержать вызов arrayfun с gpuArray данными.
