tf.contrib.opt.MovingAverageOptimizer
Оптимизатор, вычисляющий скользящее среднее значение переменных.
Наследуется от: Optimizer
tf.contrib.opt.MovingAverageOptimizer(
opt, average_decay=0.9999, num_updates=None, sequential_update=True
)
Эмпирически было установлено, что использование скользящего среднего значения обученных параметров глубокой сети лучше, чем использование её обученных параметров напрямую. Этот оптимизатор позволяет вычислить это скользящее среднее и поменять переменные во время сохранения, чтобы любой код вне цикла обучения по умолчанию использовал усреднённые значения вместо оригинальных.
Пример использования:
// Encapsulate your favorite optimizer (here the momentum one)
// inside the MovingAverageOptimizer.
opt = tf.compat.v1.train.MomentumOptimizer(learning_rate, FLAGS.momentum)
opt = tf.contrib.opt.MovingAverageOptimizer(opt)
// Then create your model and all its variables.
model = build_model()
// Add the training op that optimizes using opt.
// This needs to be called before swapping_saver().
opt.minimize(cost, var_list)
// Then create your saver like this:
saver = opt.swapping_saver()
// Pass it to your training loop.
slim.learning.train(
model,
...
saver=saver)
Обратите внимание, что для оценки следует использовать обычный механизм сохранения, а не swapping_saver().
| Аргументы | |
|---|---|
opt | tf.Optimizer, который будет использован для вычисления и применения градиентов. |
average_decay | Вещественное число. Коэффициент затухания, используемый для поддержания скользящих средних обученных переменных. Подробности см. в tf.train.ExponentialMovingAverage. |
num_updates | Необязательное количество обновлений, применённых к переменным. Подробности см. в tf.train.ExponentialMovingAverage. |
sequential_update | Булево значение. Если False, вычислит скользящее среднее одновременно с обновлением модели, потенциально вызвав безопасные гонки данных. Если True, обновит скользящее среднее после применения обновлений градиента. |
Методы
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 | Если ни у одной из переменных нет градиентов. |
RuntimeError | Если следует использовать _distributed_apply() вместо этого. |
compute_gradients
compute_gradients(
*args, **kwargs
)
Вычислить градиенты loss для переменных в var_list.
Это первая часть minimize(). Она возвращает список пар (градиент, переменная), где «градиент» — градиент для «переменной». Обратите внимание, что «градиент» может быть Tensor, IndexedSlices, или None, если для данной переменной нет градиента.
| Аргументы | |
|---|---|
loss | Tensor, содержащий значение для минимизации, или вызываемый без аргументов, возвращающий значение для минимизации. При включенном режиме выполнения Eager это должно быть callable. |
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 | Если вызвана с включенным режимом Eager execution, и loss не является вызываемым объектом. |
Совместимость с Eager execution
При включенном режиме Eager execution, 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 для инкремента на 1 после обновления переменных. |
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 . |
Совместимость с Eager execution
При включенном режиме жадного выполнения loss должно быть функцией Python, которая не принимает аргументов и вычисляет значение, которое требуется минимизировать. Минимизация (и вычисление градиента) выполняется относительно элементов var_list если оно не равно None, иначе — относительно всех обучаемых переменных, созданных во время выполнения функции loss. gate_gradients, aggregation_method, colocate_gradients_with_ops и grad_loss игнорируются при включенном режиме жадного выполнения.
swapping_saver
swapping_saver(
var_list=None, name='swapping_saver', **kwargs
)
Создать сохраняющий объект, меняющий местами скользящие средние и переменные.
Этот объект сохранения следует использовать во время обучения. Он сохранит скользящие средние обученных параметров под исходными именами параметров. Для оценки или вывода вы должны использовать стандартный объект сохранения, и он автоматически будет использовать скользящие средние для обученной переменной.
Вы должны вызвать эту функцию после того, как все переменные будут созданы и после вызова Optimizer.minimize().
| Аргументы | |
|---|---|
var_list | Список переменных для сохранения, согласно Saver(). Если установлено в None, сохранятся все переменные, созданные до этого вызова. |
name | Имя объекта сохранения. |
**kwargs | Параметры функции Saver(). |
| Возвращает | |
|---|---|
Объект tf.compat.v1.train.Saver. |
| Возможные исключения | |
|---|---|
RuntimeError | Если apply_gradients или minimize не вызывались ранее. |
ValueError | Если var_list задан и содержит некоторые переменные, но не их аналоги со скользящими средними. |
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/MovingAverageOptimizer