Spec-Zone.ru › TensorFlow

tf.compat.v1.train.ProximalAdagradOptimizer

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

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

tf.compat.v1.train.ProximalAdagradOptimizer(
    learning_rate,
    initial_accumulator_value=0.1,
    l1_regularization_strength=0.0,
    l2_regularization_strength=0.0,
    use_locking=False,
    name='ProximalAdagrad'
)
Ссылки
Методы адаптивных градиентных спусков для онлайн-обучения и стохастической оптимизации: Duchi et al., 2011 (pdf) Эффективное обучение с помощью разбиения вперёд-назад: Duchi et al., 2009 (pdf)
Аргументы
learning_rate Значение типа `Tensor` или число с плавающей точкой. Скорость обучения.
initial_accumulator_value Число с плавающей точкой. Начальное значение для аккумуляторов, должно быть положительным.
l1_regularization_strength Число с плавающей точкой, должно быть больше или равно нулю.
l2_regularization_strength Число с плавающей точкой, должно быть больше или равно нулю.
use_locking Если True использовать блокировки для операций обновления.
name Необязательный префикс имени для операций, создаваемых при применении градиентов. По умолчанию "Adagrad".
Исключения
ValueError Если значение initial_accumulator_value является недопустимым.

Методы

apply_gradients

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

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

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

Это вторая часть minimize(). Возвращает операцию применения градиентов.

@compatibility(TF2)

Как сопоставить аргументы

Имя аргумента TF1 Имя аргумента TF2 Примечание
grads_and_vars grads_and_vars -
global_step Не поддерживается. Используйте optimizer.iterations
name name. -
Аргументы
grads_and_vars Список пар (градиент, переменная), возвращаемых методом compute_gradients().
global_step Необязательный счетчик, увеличивающийся на единицу после обновления переменных.
name Необязательное имя возвращаемой операции. По умолчанию имя, переданное конструктору Optimizer.
skip_gradients_aggregation Если True, агрегирование градиентов не будет выполняться внутри оптимизатора. Обычно этот аргумент устанавливается в True при написании пользовательского кода для агрегирования градиентов вне оптимизатора.
Возвращаемое значение
Операция применения указанных градиентов. Если 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.

Миграция в TF2

Внимание: Этот API был разработан для TensorFlow v1. Продолжайте чтение, чтобы узнать, как мигрировать с этого API на эквивалент в TensorFlow v2. См. Руководство по миграции с TensorFlow v1 на TensorFlow v2 для инструкций по миграции остальной части вашего кода.

tf.keras.optimizers.Optimizer в TF2 не предоставляет метод compute_gradients, и вы должны использовать tf.GradientTape для получения градиентов:

@tf.function
def train step(inputs):
  batch_data, labels = inputs
  with tf.GradientTape() as tape:
    predictions = model(batch_data, training=True)
    loss = tf.keras.losses.CategoricalCrossentropy(
        reduction=tf.keras.losses.Reduction.NONE)(labels, predictions)
  gradients = tape.gradient(loss, model.trainable_variables)
  optimizer.apply_gradients(zip(gradients, model.trainable_variables))

Аргументы: loss: A Tensor содержащий значение для минимизации или вызываемый метод без аргументов, возвращающий значение для минимизации. Когда включено выполнение с нетерпением, он должен быть вызываемым. 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: Необязательно. A Tensor, содержащий градиент, вычисленный для loss.

Возвращает: Список пар (градиент, переменная). Переменная всегда присутствует, но градиент может быть None.

Исключения: TypeError: Если var_list содержит что-либо, кроме Variable объектов. ValueError: Если некоторые аргументы недопустимы. RuntimeError: Если вызван при включенном нетерпеливом выполнении и loss не является вызываемым.

@compatibility(eager) Когда включено нетерпеливое выполнение, gate_gradients, aggregation_method и colocate_gradients_with_ops игнорируются.

Описание

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

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 Строка.
Возвращаемое значение
Переменная слота, если он был создан, None иначе.

get_slot_names

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

get_slot_names()

Возвращает список имён слотов, созданных Optimizer.

См. get_slot().

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

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 A 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 Необязательно. A 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

© 2022 The TensorFlow Authors. All rights reserved.
Licensed under the Creative Commons Attribution License 4.0.
Code samples licensed under the Apache 2.0 License.
https://www.tensorflow.org/api_docs/python/tf/compat/v1/train/ProximalAdagradOptimizer

Spec-Zone.ru

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