Spec-Zone.ru › TensorFlow 1.15

tf.contrib.opt.ElasticAverageOptimizer

Оборачивающий оптимизатор, реализующий алгоритм Elastic Average SGD.

Наследуется от: Optimizer

tf.contrib.opt.ElasticAverageOptimizer(
    opt, num_worker, ea_custom_getter, communication_period=10, moving_rate=None,
    rho=None, use_locking=True, synchronous=False, name='ElasticAverageOptimizer'
)

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

Аргументы
opt Фактический оптимизатор, который будет использоваться для обновления локальных переменных. Должен быть одним из классов Optimizer.
num_worker Количество рабочих процессов
ea_custom_getter ElasticAverageCustomGetter
communication_period Целое значение, контролирующее частоту связи между каждым рабочим процессом и PS.
moving_rate Вещественное значение для управления эластичным отличием.
rho Степень исследования, которую мы допускаем в модели. Значение по умолчанию — moving_rate/learning_rate. В асинхронном режиме рекомендуется rho=0.0.
use_locking Если True, использовать блокировки для операций обновления.
synchronous Добавлять sync-очереди и барьер или нет. True: все рабочие процессы будут ждать друг друга перед началом обучения. False: рабочий процесс может начать обучение, когда его инициализация завершена, нет необходимости ждать, пока все будут готовы. В случае перезапуска одного рабочего процесса, он может присоединиться и продолжить обучение без блокировки.
name Необязательный префикс имени для операций, созданных при применении градиентов. По умолчанию "ElasticAverageOptimizer".

Методы

apply_gradients

Просмотреть исходный код

apply_gradients(
    grads_and_vars, global_step=None, name=None
)

Применить градиенты к глобальным переменным.

Это вторая часть minimize(). Она возвращает Operation, который применяет градиенты.

Аргументы
grads_and_vars Список пар (градиент, переменная), возвращаемых compute_gradients().
global_step Необязательная переменная, которая увеличивается на единицу после обновления переменных.
name Необязательное имя возвращаемой операции. По умолчанию — имя, переданное конструктору Optimizer.
Возвращаемое значение
Operation для применения указанных градиентов. Если global_step не равно None, эта операция также увеличивает global_step.
Исключения
TypeError Если grads_and_vars имеет неправильный формат.
ValueError Если ни одна из переменных не имеет градиентов.

compute_gradients

Просмотреть исходный код

compute_gradients(
    loss, var_list=None, gate_gradients=optimizer.Optimizer.GATE_OP,
    aggregation_method=None, colocate_gradients_with_ops=False, grad_loss=None
)

Вычислить градиенты loss для переменных в var_list.

Добавить rho*elastic_difference к функции потерь для управления исследованием. Это первая часть minimize(). Она возвращает список пар (градиент, переменная), где «градиент» — градиент для «переменной». Обратите внимание, что «градиент» может быть Tensor, IndexedSlices, или None, если для данной переменной нет градиента.

Аргументы
loss Tensor, содержащий значение, которое нужно минимизировать.
var_list Необязательный список или кортеж tf.Variable для обновления, чтобы минимизировать loss. По умолчанию — список переменных, собранных в графе под ключом GraphKey.TRAINABLE_VARIABLES.
gate_gradients Как управлять вычислением градиентов. Может быть GATE_NONE, GATE_OP, или GATE_GRAPH.
aggregation_method Указывает метод объединения градиентных слагаемых. Допустимые значения определены в классе AggregationMethod.
colocate_gradients_with_ops Если True, попытаться расположить градиенты вместе с соответствующей операцией.
grad_loss Необязательно. Tensor, содержащий градиент, вычисленный для loss.
Возвращаемое значение
Список пар (градиент, переменная). Переменная всегда присутствует, но градиент может быть None.
Исключения
TypeError Если var_list содержит что-либо кроме объектов Variable.
ValueError Если некоторые аргументы некорректны.

get_init_op

Просмотреть исходный код

get_init_op(
    task_index
)

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

переменных равными глобальным переменным центра перед началом обучения

get_name

Просмотреть исходный код

get_name()

get_slot

Просмотреть исходный код

get_slot(
    var, name
)

Возвращает слот с именем name, созданный для var оптимизатором.

Некоторые подклассы Optimizer используют дополнительные переменные. Например, Momentum и Adagrad используют переменные для накопления обновлений. Этот метод предоставляет доступ к этим Variable объектам, если вам это необходимо.

Используйте get_slot_names() для получения списка имен слотов, созданных Optimizer.

Аргументы
var Переменная, переданная в minimize() или apply_gradients().
name Строка.
Возвращаемое значение
Variable для слота, если он был создан, None в противном случае.

get_slot_names

Просмотреть исходный код

get_slot_names()

Возвращает список имён слотов, созданных Optimizer.

См. get_slot().

Возвращаемое значение
Список строк.

make_session_run_hook

Просмотреть исходный код

make_session_run_hook(
    is_chief, task_index
)

Создаёт хук для обработки операций ElasticAverageOptimizerHook, таких как инициализация.

minimize

Просмотреть исходный код

minimize(
    loss, global_step=None, var_list=None, gate_gradients=GATE_OP,
    aggregation_method=None, colocate_gradients_with_ops=False, name=None,
    grad_loss=None
)

Добавляет операции для минимизации loss путём обновления var_list.

Этот метод просто комбинирует вызовы compute_gradients() и apply_gradients(). Если вы хотите обработать градиент перед его применением, вызовите compute_gradients() и apply_gradients() явно вместо использования этой функции.

Аргументы
loss Tensor, содержащий значение, которое нужно минимизировать.
global_step Необязательная переменная, которая увеличивается на единицу после обновления переменных.
var_list Необязательный список или кортеж объектов Variable для обновления, чтобы минимизировать loss. По умолчанию — список переменных, собранных в графе под ключом GraphKeys.TRAINABLE_VARIABLES.
gate_gradients Как управлять вычислением градиентов. Может быть GATE_NONE, GATE_OP, или GATE_GRAPH.
aggregation_method Указывает метод объединения градиентных слагаемых. Допустимые значения определены в классе AggregationMethod.
colocate_gradients_with_ops Если True, попытаться расположить градиенты вместе с соответствующей операцией.
name Необязательное имя возвращаемой операции.
grad_loss Необязательно. Tensor, содержащий градиент, вычисленный для loss.
Возвращаемое значение
Операция, обновляющая переменные в var_list. Если global_step не было None, эта операция также увеличивает global_step.
Исключения
ValueError Если некоторые переменные не являются объектами Variable.

Жадный режим совместимости

При включенном жадном выполнении loss должна быть функция Python, которая не принимает аргументов и вычисляет значение, подлежащее минимизации. Минимизация (и вычисление градиента) выполняется относительно элементов var_list, если оно не равно None, иначе относительно любых обучаемых переменных, созданных во время выполнения функции loss. gate_gradients, aggregation_method, colocate_gradients_with_ops и grad_loss игнорируются при включенном жадном выполнении.

swapping_saver

Просмотреть исходный код

swapping_saver(
    var_list=None, name='swapping_saver', **kwargs
)

Создать копию сохраненной переменной global_center_variable в обучаемые переменные

Пожалуйста, вызовите эту функцию после создания всех ваших переменных с помощью ElasticAverageCustomGetter. Для оценки или вывода используйте этот сохраненный объект во время обучения. Он сохранит global_center_variable обученных параметров под оригинальными именами параметров. Аргументы: var_list: Список переменных для сохранения, в соответствии с Saver(). Если установлено в None, сохраните все обучаемые переменные, которые были созданы до этого вызова. name: Имя сохраненного объекта. **kwargs: Параметры ключевого слова Saver().

Возвращаемое значение
Объект tf.compat.v1.train.Saver.
Исключения
RuntimeError global_center_variable пусто, убедитесь, что этот метод был вызван после создания модели и ElasticAverageCustomGetter был использован при объявлении вашей модели

variables

Просмотреть исходный код

variables()

Список переменных, кодирующих текущее состояние Optimizer.

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

Возвращаемое значение
Список переменных.

Переменные класса

  • BETA = 0.9
  • GATE_GRAPH = 2
  • GATE_NONE = 0
  • GATE_OP = 1

© 2020 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 3.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/contrib/opt/ElasticAverageOptimizer

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API