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