tf.keras.optimizers.Adagrad
| Просмотреть исходный код на GitHub |
Оптимизатор, реализующий алгоритм Adagrad.
Наследуется от: Optimizer
tf.keras.optimizers.Adagrad(
learning_rate=0.001, initial_accumulator_value=0.1, epsilon=1e-07,
name='Adagrad', **kwargs
)
Adagrad — это оптимизатор с параметрически-специфическими скоростями обучения, которые адаптируются относительно частоты обновления параметров во время обучения. Чем больше обновлений получает параметр, тем меньше обновления.
| Аргументы | |
|---|---|
learning_rate | Значение с плавающей точкой, или расписание, являющееся tf.keras.optimizers.schedules.LearningRateSchedule. Скорость обучения. |
initial_accumulator_value | Значение с плавающей точкой. Начальное значение для аккумуляторов, должно быть неотрицательным. |
epsilon | Небольшое значение с плавающей точкой для избежания нулевого знаменателя. |
name | Необязательный префикс имени для операций, созданных при применении градиентов. По умолчанию "Adagrad". |
**kwargs | Ключевые аргументы. Допускается одно из "clipnorm" или "clipvalue". "clipnorm" (float) обрезает градиенты по норме; "clipvalue" (float) обрезает градиенты по значению. |
Ссылка:
| Аргументы | |
|---|---|
name | Непустая строка. Имя, используемое для аккумуляторов, созданных для оптимизатора. |
**kwargs | ключевые аргументы. Допускается {clipnorm, clipvalue, lr, decay}. clipnorm — обрезка градиентов по норме; clipvalue — обрезка градиентов по значению, decay включено для обратной совместимости, чтобы разрешить обратный экспоненциальный спад скорости обучения. lr включено для обратной совместимости, рекомендуется использовать learning_rate вместо него. |
| Исключения | |
|---|---|
ValueError | Если имя имеет неправильный формат. |
| Атрибуты | |
|---|---|
iterations | Переменная. Количество шагов обучения, пройденных этим оптимизатором. |
weights | Возвращает переменные этого оптимизатора в порядке их создания. |
Методы
add_slot
add_slot(
var, slot_name, initializer='zeros'
)
Добавляет новую переменную хранилища для var.
add_weight
add_weight(
name, shape, dtype=None, initializer='zeros', trainable=None,
synchronization=tf.VariableSynchronization.AUTO,
aggregation=tf.compat.v1.VariableAggregation.NONE
)
apply_gradients
apply_gradients(
grads_and_vars, name=None, experimental_aggregate_gradients=True
)
Применяет градиенты к переменным.
Это вторая часть minimize(). Она возвращает Operation, который применяет градиенты.
Метод суммирует градиенты со всех реплик в случае использования tf.distribute.Strategy по умолчанию. Вы можете самостоятельно агрегировать градиенты, передав experimental_aggregate_gradients=False.
Пример:
grads = tape.gradient(loss, vars)
grads = tf.distribute.get_replica_context().all_reduce('sum', grads)
# Processing aggregated gradients.
optimizer.apply_gradients(zip(grads, vars),
experimental_aggregate_gradients=False)
| Аргументы | |
|---|---|
grads_and_vars | Список пар (градиент, переменная). |
name | Необязательное имя для возвращаемой операции. По умолчанию совпадает с именем, переданным конструктору Optimizer. |
experimental_aggregate_gradients | Нужно ли суммировать градиенты с разных реплик при использовании tf.distribute.Strategy. Если False, то пользователь несет ответственность за агрегирование градиентов. По умолчанию True. |
| Возвращаемое значение | |
|---|---|
Operation для применения указанных градиентов. iterations будет автоматически увеличено на 1. |
| Исключения | |
|---|---|
TypeError | Если grads_and_vars имеет неправильный формат. |
ValueError | Если у ни одной из переменных нет градиентов. |
from_config
@classmethod
from_config(
config, custom_objects=None
)
Создает оптимизатор из его конфигурации.
Этот метод является обратным к get_config, позволяя восстановить тот же оптимизатор из словаря конфигурации.
| Аргументы | |
|---|---|
config | Словарь Python, обычно выходной get_config. |
custom_objects | Словарь Python, сопоставляющий имена с дополнительными объектами Python, используемыми для создания этого оптимизатора, например, функцией, используемой для гиперпараметра. |
| Возвращаемое значение | |
|---|---|
| Экземпляр оптимизатора. |
get_config
get_config()
Возвращает конфигурацию оптимизатора.
Конфигурация оптимизатора — это словарь Python (сериализуемый), содержащий конфигурацию оптимизатора. Тот же оптимизатор можно позже восстановить (без сохраненного состояния) из этой конфигурации.
| Возвращаемое значение | |
|---|---|
| Словарь Python. |
get_gradients
get_gradients(
loss, params
)
Возвращает градиенты loss относительно params.
| Аргументы | |
|---|---|
loss | Тензор потерь. |
params | Список переменных. |
| Возвращаемое значение | |
|---|---|
| Список тензоров градиентов. |
| Исключения | |
|---|---|
ValueError | В случае, если градиент не может быть вычислен (например, если функция градиента не реализована). |
get_slot
get_slot(
var, slot_name
)
get_slot_names
get_slot_names()
Список имён хранилищ этого оптимизатора.
get_updates
get_updates(
loss, params
)
get_weights
get_weights()
Возвращает текущие веса оптимизатора.
Веса оптимизатора — это его состояние (то есть переменные). Эта функция возвращает значения весов, связанные с этим оптимизатором, в виде списка массивов NumPy. Первое значение всегда — счётчик итераций оптимизатора, за которым следуют переменные состояния оптимизатора в порядке их создания. Возвращённый список можно использовать для загрузки состояния в оптимизаторы с аналогичными параметрами.
Например, оптимизатор RMSprop для этой простой модели возвращает список из трёх значений — счётчик итераций, за которым следуют среднеквадратичные значения ядра и смещения единственного слоя Dense:
opt = tf.keras.optimizers.RMSprop()
m = tf.keras.models.Sequential([tf.keras.layers.Dense(10)])
m.compile(opt, loss='mse')
data = np.arange(100).reshape(5, 20)
labels = np.zeros(5)
print('Training'); results = m.fit(data, labels)
Training ...
len(opt.get_weights())
3
| Возвращаемое значение | |
|---|---|
| Значения весов в виде списка массивов NumPy. |
minimize
minimize(
loss, var_list, grad_loss=None, name=None
)
Минимизировать loss путем обновления var_list.
Этот метод просто вычисляет градиент с помощью tf.GradientTape и вызывает apply_gradients(). Если вы хотите обработать градиент перед применением, вызовите tf.GradientTape и apply_gradients() явно вместо использования этой функции.
| Аргументы | |
|---|---|
loss | Функция без аргументов, возвращающая значение для минимизации. |
var_list | Список или кортеж объектов Variable, которые нужно обновить для минимизации loss, или функция, возвращающая список или кортеж объектов Variable. Используйте функцию, когда список переменных в противном случае был бы неполным до minimize, поскольку переменные создаются в первый раз при вызове loss. |
grad_loss | Необязательно. Объект Tensor, содержащий градиент, вычисленный для loss. |
name | Необязательное имя для возвращаемой операции. |
| Возвращаемое значение | |
|---|---|
Объект Operation, который обновляет переменные в var_list. Значение iterations будет автоматически увеличено на 1. |
| Исключения | |
|---|---|
ValueError | Если некоторые переменные не являются объектами Variable. |
set_weights
set_weights(
weights
)
Установить веса оптимизатора.
Веса оптимизатора — это его состояние (т. е. переменные). Эта функция принимает значения весов, связанные с этим оптимизатором, в виде списка массивов Numpy. Первое значение всегда — количество итераций оптимизатора, а затем — переменные состояния оптимизатора в порядке их создания. Переданные значения используются для установки нового состояния оптимизатора.
Например, оптимизатор RMSprop для этой простой модели принимает список из трех значений — количество итераций, а затем среднеквадратическое значение ядра и смещения единственного слоя Dense:
opt = tf.keras.optimizers.RMSprop()
m = tf.keras.models.Sequential([tf.keras.layers.Dense(10)])
m.compile(opt, loss='mse')
data = np.arange(100).reshape(5, 20)
labels = np.zeros(5)
print('Training'); results = m.fit(data, labels)
Training ...
new_weights = [np.array(10), np.ones([20, 10]), np.zeros([10])]
opt.set_weights(new_weights)
opt.iterations
<tf.Variable 'RMSprop/iter:0' shape=() dtype=int64, numpy=10>
| Аргументы | |
|---|---|
weights | Значения весов в виде списка массивов numpy. |
variables
variables()
Возвращает переменные этого оптимизатора в порядке их создания.
© 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/keras/optimizers/Adagrad