Spec-Zone.ru › TensorFlow 1.15

tf.contrib.opt.AdamWOptimizer

Оптимизатор, реализующий алгоритм Adam с разложением по весу.

Наследуется от: DecoupledWeightDecayExtension, AdamOptimizer

tf.contrib.opt.AdamWOptimizer(
    weight_decay, learning_rate=0.001, beta1=0.9, beta2=0.999, epsilon=1e-08,
    use_locking=False, name='AdamW'
)

Это реализация оптимизатора AdamW, описанного в "Fixing Weight Decay Regularization in Adam" Лощиловым и Хаттером (pdf).

Он вычисляет шаг обновления train.AdamOptimizer и дополнительно уменьшает переменную. Обратите внимание, что это отличается от добавления L2-регуляризации переменных к потере: оно регуляризует переменные с большими градиентами сильнее, чем L2-регуляризация, что, как показано в вышеупомянутой статье, приводит к лучшей потере обучения и ошибке обобщения.

Для получения дополнительной информации см. документацию оптимизатора Adam.

Обратите внимание, что этот оптимизатор также может быть создан как

extend_with_weight_decay(tf.compat.v1.train.AdamOptimizer,
weight_decay=weight_decay)
Аргументы
weight_decay Значение типа Tensor или число с плавающей точкой. Разложение по весу.
learning_rate Тензор или значение с плавающей точкой. Скорость обучения.
beta1 Значение с плавающей точкой или постоянный тензор с плавающей точкой. Экспоненциальная скорость затухания для оценок первого момента.
beta2 Значение с плавающей точкой или постоянный тензор с плавающей точкой. Экспоненциальная скорость затухания для оценок второго момента.
epsilon Маленькая константа для обеспечения числовой устойчивости. Этот epsilon — "epsilon hat" в статье Кингмы и Ба (в формуле перед разделом 2.1), а не epsilon в алгоритме 1 статьи.
use_locking Если True, использовать блокировки для операций обновления.
name Необязательное имя для операций, созданных при применении градиентов. По умолчанию "Adam".

Методы

apply_gradients

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

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

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

Эта функция аналогична Optimizer.apply_gradients, за исключением того, что она позволяет указать переменные, которые необходимо уменьшить, используя decay_var_list. Если decay_var_list равно None, все переменные в var_list уменьшаются.

Для получения дополнительной информации см. документацию Optimizer.apply_gradients.

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

compute_gradients

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

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

Вычисление градиентов 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.
colocate_gradients_with_ops Если True, попытаться разместить градиенты с соответствующей операцией.
grad_loss Необязательно. Объект Tensor, содержащий градиент, вычисленный для loss.
Возвращаемое значение
Список пар (градиент, переменная). Переменная всегда присутствует, но градиент может быть None.
Исключения
TypeError Если var_list содержит что-либо кроме объектов Variable.
ValueError Если некоторые аргументы недействительны.
RuntimeError Если вызывается с включенным режимом немедленного выполнения, а loss не является вызываемым.

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

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

get_name

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

get_name()

get_slot

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

get_slot(
    var, name
)

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

Некоторые подклассы оптимизаторов используют дополнительные переменные. Например, 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=optimizer.Optimizer.GATE_OP, aggregation_method=None,
    colocate_gradients_with_ops=False, name=None, grad_loss=None,
    decay_var_list=None
)

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

Эта функция аналогична Optimizer.minimize, за исключением того, что она позволяет указать переменные, которые необходимо уменьшить, используя decay_var_list. Если decay_var_list равно None, все переменные в var_list уменьшаются.

Для получения дополнительной информации см. документацию Optimizer.minimize.

Аргументы
loss Тензор, содержащий значение для минимизации.
global_step Необязательный Variable для увеличения на единицу после обновления переменных.
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.
decay_var_list Необязательный список переменных для уменьшения.
Возвращаемое значение
Операция, обновляющая переменные в var_list. Если global_step не было None, эта операция также увеличивает global_step.

variables

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

variables()

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

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

class="responsive fixed orange">
Возвращаемое значение
Список переменных.

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

  • 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/AdamWOptimizer

Spec-Zone.ru

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