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