tf.train.experimental.MixedPrecisionLossScaleOptimizer
Оптимизатор, применяющий масштабирование потерь.
Наследуется от: Optimizer
tf.train.experimental.MixedPrecisionLossScaleOptimizer(
opt, loss_scale
)
Масштабирование потерь — это процесс, при котором потери умножаются на множитель, называемый масштабом потерь, а каждый градиент делится на тот же множитель. Псевдокод для этого процесса:
loss = ... loss *= loss_scale grads = gradients(loss, vars) grads /= loss_scale
Математически масштабирование потерь не оказывает влияния, но может помочь избежать числового подпотока в промежуточных градиентах при использовании тензоров float16 для обучения с использованием смешанной точности. Умножая потери, каждый промежуточный градиент будет иметь применённый тот же множитель.
Масштаб потерь может быть либо фиксированной константой, выбранной пользователем, либо определяться динамически. Динамическое определение масштаба потерь удобно, так как не нужно явно выбирать масштаб потерь. Однако это снижает производительность.
Этот оптимизатор оборачивает другой оптимизатор и применяет масштабирование потерь к нему через LossScale. Масштабирование потерь применяется всякий раз, когда вычисляются градиенты, например, через minimize().
| Аргументы | |
|---|---|
use_locking | Булево. Если True, использовать блокировки для предотвращения одновременных обновлений переменных. |
name | Непустая строка. Имя, используемое для аккумуляторов, созданных для оптимизатора. |
| Исключения | |
|---|---|
ValueError | Если имя имеет неправильный формат. |
Методы
apply_gradients
apply_gradients(
grads_and_vars, global_step=None, name=None
)
Применить градиенты к переменным.
Это вторая часть minimize(). Она возвращает Operation, который условно применяет градиенты, если все значения градиента конечны. В противном случае обновление не выполняется (и global_step не увеличивается).
| Аргументы | |
|---|---|
grads_and_vars | Список пар (градиент, переменная), возвращаемых compute_gradients() . |
global_step | Необязательный Variable для увеличения на единицу после обновления переменных. |
name | Необязательное имя для возвращаемой операции. По умолчанию это имя, переданное конструктору Optimizer. |
| Возвращаемое значение | |
|---|---|
Operation, который условно применяет указанные градиенты. Если global_step не равно None, эта операция также увеличивает global_step. |
| Исключения | |
|---|---|
RuntimeError | Если следует использовать _distributed_apply() вместо этого. |
compute_gradients
compute_gradients(
loss, var_list=None, gate_gradients=optimizer.Optimizer.GATE_OP,
aggregation_method=None, colocate_gradients_with_ops=False, grad_loss=None
)
Вычислить градиенты loss для переменных в var_list.
Это изменяет динамический диапазон вычисления градиентов, увеличивая значение loss. Значения градиента затем уменьшаются обратно с помощью обратной величины масштаба потерь. Это полезно при обучении с уменьшенной точностью, где малые значения градиента в противном случае подпотокуют представленный диапазон.
| Аргументы | |
|---|---|
loss | Тензор, содержащий значение для минимизации, или вызываемый объект без аргументов, который возвращает значение для минимизации. При включенном выполнении eager он должен быть вызываемым. |
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 . |
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 объектами. |
Совместимость с Eager
При включенном режиме немедленного выполнения 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/r1.15/api_docs/python/tf/train/experimental/MixedPrecisionLossScaleOptimizer