tf.compat.v1.train.AdagradDAOptimizer
Алгоритм Adagrad Dual Averaging для разреженных линейных моделей.
Наследуется от: Optimizer
tf.compat.v1.train.AdagradDAOptimizer(
learning_rate, global_step, initial_gradient_squared_accumulator_value=0.1,
l1_regularization_strength=0.0, l2_regularization_strength=0.0,
use_locking=False, name='AdagradDA'
)
Этот оптимизатор заботится о регуляризации незамеченных признаков в мини-пачке, обновляя их, когда они встречаются, с помощью замкнутой формулы обновления, что эквивалентно их обновлению на каждой мини-пачке.
AdagradDA обычно используется, когда требуется большая разреженность в обученной модели. Этот оптимизатор гарантирует разреженность только для линейных моделей. Будьте осторожны при использовании AdagradDA для глубоких нейронных сетей, так как это потребует тщательной инициализации накопителей градиента для его обучения.
Ссылки:
Adaptive Subgradient Methods for Online Learning and Stochastic Optimization :Duchi et al., 2011 (pdf)
| Аргументы | |
|---|---|
learning_rate | Значение типа `Tensor` или число с плавающей точкой. Скорость обучения. |
global_step | `Tensor` содержащий текущий номер шага обучения. |
initial_gradient_squared_accumulator_value | Число с плавающей точкой. Начальное значение для накопителей, должно быть положительным. |
l1_regularization_strength | Число с плавающей точкой, должно быть больше или равно нулю. |
l2_regularization_strength | Число с плавающей точкой, должно быть больше или равно нулю. |
use_locking | Если True, использовать блокировки для операций обновления. |
name | Необязательный префикс имени для операций, созданных при применении градиентов. По умолчанию "AdagradDA". |
| Исключения | |
|---|---|
ValueError | Если значение initial_gradient_squared_accumulator_value некорректно. |
Методы
apply_gradients
apply_gradients(
grads_and_vars, global_step=None, name=None
)
Применить градиенты к переменным.
Это вторая часть minimize(). Возвращает операцию, которая применяет градиенты.
| Аргументы | |
|---|---|
grads_and_vars | Список пар (градиент, переменная), возвращаемых методом compute_gradients(). |
global_step | Необязательный `Tensor`, который увеличивается на единицу после обновления переменных. |
name | Необязательное имя возвращаемой операции. По умолчанию имя, переданное конструктору Optimizer. |
| Возвращаемое значение | |
|---|---|
Операция, которая применяет заданные градиенты. Если global_step не равно None, эта операция также увеличивает global_step. |
| Исключения | |
|---|---|
TypeError | Если grads_and_vars имеет неправильный формат. |
ValueError | Если ни у одной из переменных нет градиента. |
RuntimeError | Если следует использовать _distributed_apply() вместо этого. |
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 | `Tensor`, содержащий значение, которое нужно минимизировать, или вызываемая функция без аргументов, возвращающая значение для минимизации. При включенной немедленной обработке это должна быть функция. |
var_list | Необязательный список или кортеж tf.Variable для обновления, чтобы минимизировать loss. По умолчанию — список переменных, собранных в графе под ключом GraphKeys.TRAINABLE_VARIABLES. |
gate_gradients | Как управлять вычислением градиентов. Может быть `None`, `gradients_impl.GATE_OP`, `gradients_impl.GATE_GRAPH` или `gradients_impl.GATE_NONE`. |
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 оптимизатором.
Некоторые подклассы 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, 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 | Необязательный 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 . |
| Возвращаемое значение | |
|---|---|
Операция, обновляющая переменные в 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 игнорируются при включенном ленивом выполнении.
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/r2.3/api_docs/python/tf/compat/v1/train/AdagradDAOptimizer