Spec-Zone.ru › TensorFlow 1.15

tf.contrib.optimizer_v2.MomentumOptimizer

Оптимизатор, реализующий алгоритм Momentum.

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

tf.contrib.optimizer_v2.MomentumOptimizer(
    learning_rate, momentum, use_locking=False, name='Momentum', use_nesterov=False
)

Вычисляет (если use_nesterov = False):

accumulation = momentum * accumulation + gradient
variable -= learning_rate * accumulation

Обратите внимание, что в плотной версии этого алгоритма accumulation обновляется и применяется независимо от значения градиента, в то время как в разреженной версии (когда градиент является IndexedSlices, обычно из-за tf.gather или вложения) обновляются только фрагменты переменных и соответствующие accumulation термины, когда эта часть переменной использовалась в прямом проходе.

Аргументы
learning_rate Вещественный гиперпараметр. Скорость обучения.
momentum Вещественный гиперпараметр. Импульс.
use_locking Если True использовать блокировки для операций обновления.
name Необязательное префиксное имя для операций, созданных при применении градиентов. По умолчанию «Momentum».
use_nesterov Если True использовать Nesterov Momentum. См. Sutskever et al., 2013. Эта реализация всегда вычисляет градиенты в значении переменной(ых), переданных в оптимизатор. Использование Nesterov Momentum заставляет переменную(ые) отслеживать значения, называемые theta_t + mu*v_t в статье.

Методы

apply_gradients

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

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

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

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

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

compute_gradients

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

compute_gradients(
    loss, var_list=None, gate_gradients=GATE_OP, aggregation_method=None,
    grad_loss=None, stop_gradients=None, scale_loss_by_num_replicas=False
)

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

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

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

Совместимость с жадной выполнением

При включенной жадной выполнении gate_gradients, и aggregation_method игнорируются.

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().

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

minimize

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

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

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

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

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

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

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

variables

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

variables()

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

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

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

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

  • 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/optimizer_v2/MomentumOptimizer

Spec-Zone.ru

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