tf.keras.layers.SimpleRNNCell
| Просмотреть исходный код на GitHub |
Класс ячейки для SimpleRNN.
tf.keras.layers.SimpleRNNCell(
units,
activation='tanh',
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,
**kwargs
)
См. Руководство по API RNN Keras для получения подробной информации об использовании API RNN.
Этот класс обрабатывает один шаг в рамках всего входного временного ряда, в то время как tf.keras.layer.SimpleRNN обрабатывает весь ряд.
| Аргументы | |
|---|---|
units | Положительное целое число, размерность выходного пространства. |
activation | Функция активации для использования. По умолчанию: гиперболический тангенс (tanh). Если вы передаете 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. |
Аргументы вызова:
-
inputs: 2D тензор со следующей формой:[batch, feature]. -
states: 2D тензор со следующей формой:[batch, units], который является состоянием из предыдущего временного шага. Для нулевого временного шага будет использован начальное состояние, заданное пользователем. -
training: Булевое значение Python, указывающее, должен ли слой работать в режиме обучения или в режиме вывода. Актуально только при использованииdropoutилиrecurrent_dropout.
Примеры:
inputs = np.random.random([32, 10, 8]).astype(np.float32)
rnn = tf.keras.layers.RNN(tf.keras.layers.SimpleRNNCell(4))
output = rnn(inputs) # The output has shape `[32, 4]`.
rnn = tf.keras.layers.RNN(
tf.keras.layers.SimpleRNNCell(4),
return_sequences=True,
return_state=True)
# whole_sequence_output has shape `[32, 10, 4]`.
# final_state has shape `[32, 4]`.
whole_sequence_output, final_state = rnn(inputs)
Методы
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, чтобы вызвать этот метод в методе вызова (), чтобы кэшированная маска очистилась перед вызовом метода 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/SimpleRNNCell