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

Будущее

Запросите функциональное выполнение на параллельных рабочих пула или клиенте MATLAB

расширьте все на странице

Описание

Объект Future представляет функцию, которая будет выполняться на параллельных рабочих пула или клиенте MATLAB^®.

Создание

Существует несколько способов создать объект Future:

Задайте функцию, которая будет выполняться на рабочем в параллельном пуле с помощью parfeval. Функция parfeval создает объект FevalFuture представлять функциональное выполнение и содержать результаты. Чтобы создать несколько FevalFutures, вызовите parfeval многократно; например, можно создать вектор FevalFutures в for - цикл.
Задайте функцию, которая будет выполняться на каждом рабочем в параллельном пуле с помощью parfevalOnAll. Функция parfevalOnAll создает объект FevalOnAllFuture представлять функциональное выполнение и содержать результаты.
Задайте функцию, которая будет выполняться на клиенте MATLAB после всех объектов Future полное использование afterAll. Функция afterAll создает объект AfterAllFuture представлять функциональное выполнение и содержать результаты.
Задайте функцию, которая будет выполняться на клиенте MATLAB после каждого объекта Future полное использование afterEach. Функция afterEach создает объект AfterEachFuture представлять функциональное выполнение и содержать результаты.

Таким образом, следующая таблица описывает доступные типы будущих объектов:

Будущий объект	Описание
`FevalFuture`	Один экземпляр будущего `parfeval`
`FevalOnAllFuture`	Экземпляр будущего `parfevalOnAll`
`AfterAllFuture`	Экземпляр будущего `afterAll`
`AfterEachFuture`	Экземпляр будущего `afterEach`

Объекты Future являются локальными объектами и могут быть получены доступ только в сеансе работы с MATLAB, который создал его.

Свойства

развернуть все

Общие опции

`CreateDateTime` — Дата и время, когда это будущее было создано
`datetime`

Это свойство доступно только для чтения.

Дата и время, когда это будущее было создано, задала как объект datetime.

Типы данных: datetime

`Ошибка` Информация об ошибке
исключение

Это свойство доступно только для чтения.

Информация ошибки, указанная как исключение. Если Future завершается без ошибки, то это поле пусто.

`FinishDateTime` — Дата и время, когда это будущее закончило запускаться
`datetime`

Это свойство доступно только для чтения.

Дата и время, когда это будущее закончило запускаться, заданный как объект datetime.

Типы данных: datetime

`Функция` Функция, чтобы оценить
`function_handle`

Это свойство доступно только для чтения.

Функция, чтобы оценить, заданный как указатель на функцию.

Пример: @rand

Типы данных: function_handle

`ID` — Числовой идентификатор для будущего
целое число

Это свойство доступно только для чтения.

Числовой идентификатор для будущего, заданного как целое число.

Типы данных: double

`Входные параметры` Входные параметры, чтобы функционировать
cellArray

Это свойство доступно только для чтения.

Входные параметры к функции, чтобы выполниться, заданный как массив ячеек.

Пример 1

Пример: {[1,2], [2,1]}

Типы данных: cell

`NumOutputArguments` — Количество аргументов возвращено функцией
целое число

Это свойство доступно только для чтения.

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

Типы данных: double

`Выходные аргументы` Выходные аргументы от рабочей функции
cellArray

Это свойство доступно только для чтения.

Выходные аргументы, заданные как массив ячеек результатов рабочей функции после того, как это закончило выполнение. Если Future завершается с ошибками, это поле пусто. Чтобы видеть ошибку, проверяйте свойство Error.

Пример: {[3.14]}

Типы данных: cell

`StartDateTime` — Дата и время, когда это будущее начало запускаться
`datetime`

Это свойство доступно только для чтения.

Дата и время, когда это будущее начало запускаться, заданный как объект datetime.

Типы данных: datetime

`State` — Текущее состояние будущего
`'pending'` | `'queued'` | `'running'` | `'finished'` | `'failed'` | `'unavailable'`

Это свойство доступно только для чтения.

Текущее состояние будущего, заданного как одно из этих значений: 'pending', 'queued', 'running', 'finished', 'failed' или 'unavailable'.

Типы данных: char

Опции FevalFuture

`Дневник` Текст производится выполнением функции
массив символов

Это свойство доступно только для чтения.

Текст, произведенный выполнением функции, заданной как массив char.

Типы данных: char

`Parent` — Очередь будущих объектов, которая содержит будущее
`FevalQueue`

Это свойство доступно только для чтения.

Очередь объектов Future, которая содержит этот Future, заданный как FevalQueue. Проверяйте эту очередь, чтобы идентифицировать количество выполнения объектов Future или поставленный в очередь.

Типы данных: FevalQueue

`Чтение` Индикация, если выходные параметры были считаны
`logical`

Это свойство доступно только для чтения.

Индикация, если выходные параметры были считаны fetchNext или fetchOutputs, задала как логическое.

Типы данных: логический

Опции FevalOnAllFuture

`Дневник` Текст производится выполнением функции
массив ячеек символьных массивов

Это свойство доступно только для чтения.

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

Типы данных: cell

`Parent` — Очередь будущих объектов, которая содержит будущее
`FevalQueue`

Это свойство доступно только для чтения.

Очередь объектов Future, которая содержит этот Future, заданный как FevalQueue. Проверяйте эту очередь, чтобы идентифицировать количество выполнения объектов Future или поставленный в очередь.

Типы данных: FevalQueue

Функции объекта

развернуть все

Общие функции

`afterAll`	Задайте функцию, чтобы вызвать после всей параллели. Завершенные фьючерсы
`afterEach`	Задайте функцию, чтобы вызвать после каждой параллели. Будущее завершается
`cancel`	Отмените поставленное в очередь или рабочее будущее
`fetchOutputs`	Получите все выходные аргументы от будущего
`isequal`	Верный, если фьючерсы имеют тот же ID
`wait`	Ожидайте фьючерсов, чтобы завершиться

FevalFuture только

fetchNext Получите затем доступный непрочитанный FevalFuture выходные параметры

Примеры

свернуть все

Объедините `afterEach` и `afterAll`

Скрипт Open Live Script

Можно объединить afterEach и afterAll, чтобы автоматически вызвать больше функций на результаты фьючерсов. И afterEach и afterAll генерируют будущие переменные, которые могут использоваться снова в afterEach и afterAll.

Используйте parfeval, чтобы вычислить случайные векторы в рабочих. С настройками по умолчанию parfeval автоматически создает parpool, если нет того, уже созданного.

for idx= 1:10
    f(idx) = parfeval(@rand, 1, 1000, 1);
end

Starting parallel pool (parpool) using the 'local' profile ...
connected to 8 workers.

Вычислите самый большой элемент в каждом из тех векторов, когда они станут готовыми. afterEach выполняет указатель на функцию на выводе каждого будущего, когда они становятся готовыми, и создает другое будущее, чтобы содержать результаты.

maxFuture = afterEach(f, @(r) max(r), 1);

Чтобы вычислить минимальное значение среди них, вызовите afterAll на этом новом будущем. afterAll выполняет функцию на объединенных выходных аргументах всех фьючерсов после того, как они все завершатся. В этом случае afterAll выполняет функциональный min на выходных параметрах maxFuture после завершения и создает другое будущее, чтобы содержать результат.

minFuture = afterAll(maxFuture, @(r) min(r), 1);

Можно выбрать результат с помощью fetchOutputs. fetchOutput, ожидает, пока будущее не завершается, чтобы собрать результаты.

fetchOutputs(minFuture)

ans = 0.9973

Можно проверять результат afterEach путем вызова fetchOutputs на его будущей переменной.

fetchOutputs(maxFuture)

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

afterAll | afterEach | parallel.Pool | parfeval | parfevalOnAll

Введенный в R2013b

Документация Parallel Computing Toolbox

Поддержка