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.
Включает переменные слотов и дополнительные глобальные переменные, созданные оптимизатором в текущей рабочей графике.
| Возвращаемое значение | |
|---|---|
| Список переменных. |
Переменные класса
-
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