Spec-Zone.ru › TensorFlow 2.9

tf.keras.layers.GRUCell

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

Класс ячейки для слоя GRU.

Наследуется от: Layer, Module

tf.keras.layers.GRUCell(
    units,
    activation='tanh',
    recurrent_activation='sigmoid',
    use_bias=True,
    kernel_initializer='glorot_uniform',
    recurrent_initializer='orthogonal',
    bias_initializer='zeros',
    kernel_regularizer=None,
    recurrent_regularizer=None,
    bias_regularizer=None,
    kernel_constraint=None,
    recurrent_constraint=None,
    bias_constraint=None,
    dropout=0.0,
    recurrent_dropout=0.0,
    reset_after=True,
    **kwargs
)

См. руководство по API Keras RNN для получения подробной информации об использовании API RNN.

Этот класс обрабатывает один шаг в рамках всего входного временного ряда, тогда как tf.keras.layer.GRU обрабатывает весь временной ряд.

Например:

inputs = tf.random.normal([32, 10, 8])
rnn = tf.keras.layers.RNN(tf.keras.layers.GRUCell(4))
output = rnn(inputs)
print(output.shape)
(32, 4)
rnn = tf.keras.layers.RNN(
   tf.keras.layers.GRUCell(4),
   return_sequences=True,
   return_state=True)
whole_sequence_output, final_state = rnn(inputs)
print(whole_sequence_output.shape)
(32, 10, 4)
print(final_state.shape)
(32, 4)
Аргументы
units Положительное целое число, размерность выходного пространства.
activation Функция активации для использования. По умолчанию: гиперболический тангенс (tanh). Если передано значение None, то активация не применяется (т. е. активация "линейная": a(x) = x).
recurrent_activation Функция активации для использования на рекуррентном шаге. По умолчанию: сигмоида (sigmoid). Если передано None, то активация не применяется (т. е. активация "линейная": a(x) = x).
use_bias Булево значение, (по умолчанию True), указывает, использует ли слой вектор смещения.
kernel_initializer Инициализатор матрицы весов kernel, используемой для линейного преобразования входных данных. По умолчанию: glorot_uniform.
recurrent_initializer Инициализатор матрицы весов recurrent_kernel, используемой для линейного преобразования рекуррентного состояния. По умолчанию: orthogonal.
bias_initializer Инициализатор вектора смещения. По умолчанию: zeros.
kernel_regularizer Функция регуляризации, применяемая к матрице весов kernel. По умолчанию: None.
recurrent_regularizer Функция регуляризации, применяемая к матрице весов recurrent_kernel. По умолчанию: None.
bias_regularizer Функция регуляризации, применяемая к вектору смещения. По умолчанию: None.
kernel_constraint Функция ограничения, применяемая к матрице весов kernel. По умолчанию: None.
recurrent_constraint Функция ограничения, применяемая к матрице весов recurrent_kernel. По умолчанию: None.
bias_constraint Функция ограничения, применяемая к вектору смещения. По умолчанию: None.
dropout Вещественное число от 0 до 1. Доля единиц, которые необходимо отбросить для линейного преобразования входных данных. По умолчанию: 0.
recurrent_dropout Вещественное число от 0 до 1. Доля единиц, которые необходимо отбросить для линейного преобразования рекуррентного состояния. По умолчанию: 0.
reset_after Конвенция GRU (применять ли ворота сброса после или перед матричным умножением). False = "перед", True = "после" (по умолчанию и совместимо с cuDNN).

Аргументы вызова:

  • inputs: 2-мерный тензор, со формой [batch, feature].
  • states: 2-мерный тензор с формой [batch, units], который представляет собой состояние с предыдущего шага во времени. Для шага 0 будет использовано начальное состояние, предоставленное пользователем.
  • training: Булево значение Python, указывающее, должен ли слой работать в режиме обучения или в режиме вывода. Актуально только в случае использования dropout или recurrent_dropout.

Методы

get_dropout_mask_for_cell

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

get_dropout_mask_for_cell(
    inputs, training, count=1
)

Получить маску дропаут для входных данных ячейки RNN.

Создаст маску на основе контекста, если нет кэшированной маски. Если генерируется новая маска, то она будет обновлять кэш в ячейке.

Аргументы
inputs Входной тензор, форма которого будет использована для генерации маски дропаут.
training Булевый тензор, указывает ли режим работы на обучение. Дропаут будет пропущен в режиме не обучения.
count Целое число, количество генерируемых масок дропаут. Это полезно для ячеек, у которых внутренние веса объединены вместе.
Возвращает
Список тензоров маски, сгенерированная или кэшированная маска на основе контекста.

get_initial_state

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

get_initial_state(
    inputs=None, batch_size=None, dtype=None
)

get_recurrent_dropout_mask_for_cell

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

get_recurrent_dropout_mask_for_cell(
    inputs, training, count=1
)

Получить маску дропаут для рекуррентной части ячейки RNN.

Создаст маску на основе контекста, если нет кэшированной маски. Если генерируется новая маска, то она будет обновлять кэш в ячейке.

Аргументы
inputs Входной тензор, форма которого будет использована для генерации маски дропаут.
training Булевый тензор, указывает ли режим работы на обучение. Дропаут будет пропущен в режиме не обучения.
count Целое число, количество генерируемых масок дропаут. Это полезно для ячеек, у которых внутренние веса объединены вместе.
Возвращает
Список тензоров маски, сгенерированная или кэшированная маска на основе контекста.

reset_dropout_mask

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

reset_dropout_mask()

Сбросить кэшированные маски дропаут, если они есть.

Это важно для слоя RNN, чтобы вызвать этот метод в методе call(), чтобы кэшированная маска была очищена перед вызовом cell.call(). Маска должна кэшироваться на временном шаге в пределах одной партии, но не должна кэшироваться между партиями. В противном случае это приведет к необоснованному смещению относительно определенного индекса данных в пределах партии.

reset_recurrent_dropout_mask

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

reset_recurrent_dropout_mask()

Сбросить кэшированные маски дропаут для рекуррентной части, если они есть.

Это важно для слоя RNN, чтобы вызвать этот метод в методе call(), чтобы кэшированная маска была очищена перед вызовом cell.call(). Маска должна кэшироваться на временном шаге в пределах одной партии, но не должна кэшироваться между партиями. В противном случае это приведет к необоснованному смещению относительно определенного индекса данных в пределах партии.

© 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/versions/r2.9/api_docs/python/tf/keras/layers/GRUCell

Spec-Zone.ru

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